README.md

Solex Ser Recon - Core Module - FR

(English version below)

Ce dépôt contient le core du processus de recontruction du disque solaire à partir des fichiers d'acquisitions .SER dans le cadre d'utilisation du Sol'Ex.

Plus d'informations sur le projet Sol'Ex ici : http://www.astrosurf.com/solex/

L'objectif est de maintenir le core en tant que module sans interface utilisateur. Le fichier Inti_ser_recon.py contient une GUI pour les tests durant les développement, attention ce n'est pas la version utilisateur finale. Les développements du module Core, inti_recon.py doivent être indépendants de la GUI.

Récupérer le code pour execution

Vous pouvez utiliser le code de ce dépôt sur votre machine personnelle :

• En récupérant le code en téléchargeant le package entier via le bouton Code

• En utilisant git via HTTPS ou en SSH. Cliquez sur "Clone with HTTPS/SSH" puis dans votre CMD Window ou terminal linux/macos

git clone https://github.com/Vdesnoux/Solex_ser_recon.git

Contribuer au dépôt

Si vous souhaitez contribuer au dépôt, consulter le document CONTRIBUTING.md présent sur le dépôt.

Installation (développeurs)

Python

Version recommandée : Python 3.8

Environnement virtuel (optionnel)

Installation pip install virtualenv

Creation de l'environnement virtualenv venv

Activation de l'environnement source venv/bin/activate

Requirements

La liste des dépendances se trouve dans le fichier requirements.txt

• opencv_python==4.4.0.46
• numpy==1.19.2
• astropy==4.2
• PySimpleGUI==4.38.0
• lsq-ellipse==2.0.1
• PyYAML==5.4.1
• serfilesreader==0.0.6

Pour une installation automatique taper :

pip install -r requirements.txt

Lancement & Operation

Pour plus de details sur les fonctions avancées se référer au site: http://valerie.desnoux.free.fr/inti/

• Dans la fenetre de pysimpleGUI selectionner le ou les fichiers ser à traiter
• Clicker sur Ok et c'est tout

INTI va automatiquement generer l'image monochromatique du disque solaire à partir des scans

• Lors de l'affichae final des 4 images - appuyer sur "enter" pour sortir ou laisser faire la temporisation d'une minute

• Si plusieurs fichiers ser sont selectionnés, la temporisation est reduite a 10 ms :

  Les fichiers suivants sont stockés dans le repertoire du fichier ser

  • xx_mean.fits: image moyenne de toutes les trames de la video ser du spectre
  • xx_raw.fits: image brute monochromatique
  • xx_recon.fits: image finale, corrigée du slant
  • xx_clahe.fits: image finale, traitement par Contrast Local Adapative Histogram Enhancement (CLAHE)

---

Solex Ser Recon - Core Module - EN

This repository contains the core of the solar disk reconstruction process from the .SER acquisition files in the framework of the Sol'Ex use.

More information on the Sol'Ex project here : http://www.astrosurf.com/solex/

The goal is to maintain the core as a module without user interface. The file Inti_ser_recon.py contains a GUI for testing during development, beware this is not the final user version. The development of the core module, inti_recon.py must be independent of the GUI.

Get the code for execution

You can use the code of this repository on your personal machine:

• By retrieving the code by downloading the entire package via the Code button

• By using git via HTTPS or SSH. Click on "Clone with HTTPS/SSH" then in your CMD Window or linux/macos terminal

git clone https://github.com/Vdesnoux/Solex_ser_recon.git`

Contribute to the repository

If you wish to contribute to the repository, please consult the document CONTRIBUTING.md present on this repository.

Installation (developers)

Python

Recommended version: Python 3.8

Virtual environment (optional)

Installation pip install virtualenv

Creation of the environment virtualenv venv

Activating the environment source venv/bin/activate

Requirements

The list of dependencies can be found in the file requirements.txt

• opencv_python==4.4.0.46
• numpy==1.19.2
• astropy==4.2
• PySimpleGUI==4.38.0
• lsq-ellipse==2.0.1

For an automatic installation type :

pip install -r requirements.txt

Launching & Operating

Refer to the website for details on advanced features : http://valerie.desnoux.free.fr/inti/

• In the pySimpleGUI window enter the name of the ser file to process
• Click on Ok and that's it

INTI will automatically process your scan and generate the monochromatic sun disk.

• When the final 4 images are displayed - press "enter" to exit or let the one minute delay run

• If more than one ser file is selected, the time delay is reduced to 10 ms:

  The following files are stored in the ser file directory

  • xx_mean.fits: average image of all ser video frames in the spectrum
  • xx_raw.fits: raw monochromatic image
  • xx_recon.fits: final image, corrected for slant
  • xx_clahe.fits: final image, processed by Contrast Local Adapative Histogram Enhancement (CLAHE)