JSol’Ex

img demande une image à un décalage de pixels donné. Par exemple, img(0) est l’image centrée sur la raie, img(-10) est celle décalée de 10 pixels vers le haut.

list crée une liste à partir des arguments. Par exemple list(img(-3), img(3))

avg permet de calculer la valeur moyenne d’images, par exemple: avg(img(-1), img(0), img(1)) calcule la moyenne des images aux décalages -1, 0 et 1. Il est aussi possible d’écrire: avg(range(-1,1))

max permet de calculer la valeur maximale d’images, par exemple max(img(-3), img(3)). Le maximum est calculé pixel par pixel.

min permet de calculer la valeur minimale d’images, par exemple min(img(-3), img(3)). Le minimum est calculé pixel par pixel.

range permet de générer une suite d’images à des pixels décalés. Cette fonction prend au minimum 2 arguments, la valeur basse (inclue) et la valeur haute (inclue). Par exemple, range(-5,5) produira 11 images. Il est possible de générer une image tous les X pixels, en ajoutant un 3ème argument, le pas. Par exemple, range(-5,5,5) ne générera plus que 3 images, à -5, 0 et 5 pixels.

pow permet de calculer une puissance d’une image. Par exemple, pow(img(0), 2) calcule le carré de l’image.

log permet de calculer le logarithme d’une image. Par exemple, log(img(0), 2) calcule le logarithme en base 2.

exp permet de calculer l’exponentielle d’une image. Par exemple, exp(img(0)).

adjust_gamma permet d’appliquer une correction gamma à une image. Cette fonction accepte 2 paramètres : l’image et le facteur de correction gamma. Par exemple, adjust_gamma(img(0), 2.2). Un gamma < 1 éclaircit l’image, un gamma > 1 la fonce.

auto_constrast est une fonction d’amélioration du contraste crée spécifiquement pour les images Sol’Ex. Elle combine plusieurs techniques pour améliorer l’image. Cette fonction prend 2 arguments : l’image et un facteur de correction. Le facteur doit être supérieur à 1 et plus il est élevé, plus la correction sera forte. Par exemple : auto_contrast(img(0), 1.5).

invert, qui permet d’obtenir le négatif d’une image

invert, generates a color inverted image

clahe applique une transformation d’histogramme adaptative (CLAHE) sur votre image. Cette fonctiona accepte soit 2, soit 4 arguments. Dans la version courte, elle prend l’image et un facteur de clipping. Par exemple: clahe(img(0); 1.5). Dans sa version longue, elle accepte 2 paramètres supplémentaires: la taille des tuiles utilisées pour calculer les histogrammes et la résolution de l’histogramme. Plus la résolution est élevée, plus la dynamique est élevée, mais plus vous devrez utiliser des tuiles petites. Par exemple: clahe(img(0); 128; 256; 1.2).

adjust_contrast permet d’appliquer un ajustement très simple du contraste, en coupant les pixels sous une limite minimale ou au-dessus de la limite maximale. Par exemple: adjust_contrast(img(0), 10, 210). L’intervalle doit être entre 0 et 255.

asinh_stretch permet d’appliquer la fonction d’étirement par arcsinus hyperbolique. Elle prend 3 paramètres: l’image, le point noir et le coefficient de stretch. Par exemple, asinh_stretch(img(0), 200, 100).

linear_stretch augmente la plage dynamique d’une image. Elle prend soit 1, soit 3 paramètres : l’image, puis optionellement les valeurs min et max des pixels (valeur comprise entre 0 et 65535). Par exemple: linear_stretch(img(0))

fix_banding permet d’appliquer l’algorithme de corrections de bandes (ou transversallium). Il prend 3 arguments: l’image, la largeur de bande et le nombre d’itérations. Par exemple, fix_banding(img(0), 10, 5).

remove_bg permet de supprimer l’arrière plan d’une image. Ceci peut être utile lorsque le constraste est très faible (par exemple en raie hélium). Le processus calcule la valeur moyenne des pixels en dehors du disque, puis applique une suppression de l’arrière plan en fonction de la distance au limbe. Par exemple: remove_bg(stretched). Une variante est disponible avec une tolerance: remove_bg(stretched, 0.2). Plus la tolérance est proche de 0, moins la suppression est forte.

neutralize_bg est une fonction similaire à remove_bg qui utilise une modélisation polynomiale du fond pour supprimer les gradients. Elle prend en paramètre l’image à traiter, et optionellement un nombre d’itérations en 2ème paramètre. Par exemple : neutralize_bg(img(0), 2).

crop permet de réduire l’image aux dimensions souhaitées. Cette fonction prend 5 paramètres: l’image à réduire, les coordonnées du point en haut à gauche, puis la largeur et la hauteur de l’image souhaitée. Par exemple: crop(img(0), 100, 100, 300, 300).

crop_rect permet de réduire l’image aux dimensions indiquées, en garantissant que le centre du disque solaire sera au centre de l’image. Par exemple: crop-rect(img(0), 1024, 1024). Il n’y a pas de changement d’échelle : si le disque solaire n’entre pas dans les dimensions cibles, il sera tronqué.

autocrop2 effectue un rognage carré de l’image, centré sur le disque solaire, de manière similaire à autocrop, mais les dimensions de l’image rognée sont calculées avec un facteur du diamètre du disque. Par défaut, les dimensions de l’image rognée sont un multiple de 16. Par exemple, autocrop2(img(0);1.1) rognera autour de 1,1 fois le diamètre. autocrop2(img(0);1.1;32) fera la même chose, mais l’image résultante aura une largeur et une hauteur comme multiples de 32.

colorize permet de coloriser une image. Elle prend au choix 2 ou 7 paramètres. Dans sa version la plus simple à 2 paramètres, le premier est l’image à coloriser, et le second est le nom du profil de colorisation, tel que trouvé dans la fenêtre de paramétrage, par exemple: colorize(img(0), "h-alpha"). Dans sa version longue, les paramètres de colorisation sont les points "entrée" et "sortie" pour chacun des canaux rouge, bleu et vert, entre 0 et 255. Par exemple: colorize(img(0), 84, 139, 95, 20, 218, 65) est équivalent à l’entrée précédente. Notez que la colorisation varie fortement en fonction des images en entrée et qu’il peut être nécessaire d’avoir appliqué la fonction asinh_stretch avant pour obtenir les couleurs souhaitées.

rgb permet de créer une image RGB à partir de 3 images mono. Elle prend donc 3 paramètres, par exemple: rgb(img(3), avg(img(3), img(-3)), img(-3)).

get_r, get_g et get_b permettent d’extraire respectivement le canal rouge, vert ou bleu d’une image couleur. Au cas où une image mono est passée en paramètre, elle est renvoyée telle quelle.

mono convertit une image couleur en mono en utilisant la formule gris=0.299 * Rouge + 0.587 * Vert + 0.114 * Bleu

saturate permet de (dé)saturer une image RGB. Elle accepte 2 paramètres : une image couleur et un facteur de saturation (relatif à la saturation courante de l’image). Par exemple: saturate(doppler, 2).

anim permet de créer une animation vidéo à partir de vos images individuelles. Elle accepte une list d’images en premier argument, et en 2ème optionnel le délai entre chaque image (par défaut 250ms). Par exemple anim(range(-5;5)). Attention: la création d’animations demande beaucoup de ressources système.

load charge une image depuis le système de fichiers. Elle prend le chemin vers le fichier en paramètre. Par exemple: load("/chemin/vers/une/image.png"). Au lieu d’utiliser un chemin complet, il est possible de combiner avec la fonction workdir.

load_many permet de charger plusieurs images d’un coup, à partir d’un dossier. Par exemple: load_many("/chemin/vers/dossier"). Un paramètre optionnel accepte une expression régulière pour filtrer les images: load_many("/chemin/vers/dossier", ".*cropped.*").

workdir définit le dossier de travail par défaut. Il est notamment utilisé pour charger les images avec load. Par exemple: workdir("/chemin/vers/dossier/images").

choose_file permet à l’utilisateur de choisir une image depuis le système de fichiers. Elle prend 2 paramètres : un identifiant et un message d’aide. L’identifiant est utilisé pour se souvenir du dernier dossier utilisé. Par exemple : choose_file("myImage", "Choisissez une image"). Le message ne peut pas être vide.

choose_files permet à l’utilisateur de choisir plusieurs images depuis le système de fichiers. Elle prend 2 paramètres : un identifiant et un message d’aide. L’identifiant est utilisé pour se souvenir du dernier dossier utilisé. Par exemple : choose_files("myImage", "Choisissez plusieurs images"). Le message ne peut pas être vide.

rl_decon applique l’algorithme de déconvolution de Richardson-Lucy à l’image. Cette fonction utilise un PSF synthétique. Au minimum, cette fonction accepte un paramètre : l’image. Par exemple : rl_decon(img(0)). 3 autres paramètres optionnels sont disponibles : le rayon du PSF en pixels, le facteur sigma et le nombre d’itérations. Par exemple: rl_decon(img(0), 2.5, 2.5, 10).

sharpen applique un filtre d’augmentation des détails à votre image. Exemple: sharpen(img(0)).

blur applique un flou gaussien à votre image. Par exemple : blur(img(0)).

disk_fill remplit le disque solaire détecté avec une valeur donnée (par défault, celle du point noir détecté). Par exemple disk_fill(img(0)) ou disk_fill(img(0), 0).

disk_mask crée un masque du disque solaire, où les pixels à l’intérieur du disque auront la valeur 1, contre 0 pour ceux à l’extérieur du disque. Il est possible d’inverser (0 à l’intérieur, 1 à l’extérieur) en passant 1 comme 2d paramètre de la fonction. Par exemple : disk_mask(img(0);1).

rescale_rel permet d’agrandir ou réduire la taille d’une image. Elle prend 3 paramètres: l’image, puis les facteurs d’agrandissement en X et Y. Par exemple, rescale_rel(img(0);2;2) pour doubler la taille d’une image.

rescale_abs permet d’agrandir ou réduire la taille d’une image. Elle prend 3 paramètres: l’image, puis les dimensions finales souhaitées. Par exemple, rescale_abs(img(0);2048;2048).

radius_rescale est une méthode de redimensionnement relative qui peut être utile pour faciliter les mosaïques d’images. Elle sera donc typiquement utilisée en traitement par lots. Elle permet de redimensionner un ensemble d’images pour que toutes aient le même rayon solaire. Elle procède à une recherche du disque pour chaque image, trouve celle qui a le disque le plus grand, et redimensionne toutes les autres images pour qu’elles aient le même rayon solaire. Par exemple: radius_rescale(cropped).

rotate_left effectue une rotation vers la gauche de l’image. Par exemple, rotate_left(img(0)).

rotate_right effectue une rotation vers la droite de l’image. Par exemple, rotate_right(img(0)).

rotate_deg effectue une rotation d’un angle arbitraire en degrés. Elle accepte entre 2 et 4 paramètres: l’image, l’angle de rotation sont obligatoires. Par exemple rotate_deg(img(0), 45). Vous pouvez ensuite spécifier la valeur du fond à utiliser pour remplir les portions manquantes: rotate_deg(img(0), 45, 800) et enfin si vous ajoutez 1 en dernier paramètre l’image sera redimensionnée au maximum pour que tous les pixels de l’image d’origine apparaissent dans l’image tournée.

rotate_rad effectue une rotation d’un angle arbitraire en radians. Elle accepte entre 2 et 4 paramètres: l’image, l’angle de rotation sont obligatoires. Par exemple rotate_rad(img(0), .2). Vous pouvez ensuite spécifier la valeur du fond à utiliser pour remplir les portions manquantes: rotate_rad(img(0), .2, 800) et enfin si vous ajoutez 1 en dernier paramètre l’image sera redimensionnée au maximum pour que tous les pixels de l’image d’origine apparaissent dans l’image tournée.

vflip permet de retourner l’image verticalement. Par exemple, vflip(img(0)).

hflip permet de retourner l’image horizontalement. Par exemple, hflip(img(0)).

draw_globe dessine un globe dont l’orientation et le diamètre correspond aux paramètres solaires détectés. Elle prend entre 1 et 4 paramètres. Le premier est l’image sur laquelle dessiner le globe. Par exemple: draw_globe(img(0)). Les paramètres optionnels suivants sont l’angle P (en radians), l’angle B0 (en radians) et l’ellipse du disque solaire. Par exemple: draw_globe(img(0), p, b0, ellipse).

draw_obs_details affiche sur l’image les données d’observation. Par exemple: draw_obs_details(img(0)). Par défaut, positionné en haut à gauche. Il est possible de spéficier les coordonnées (x,y) où écrire : draw_obs_details(img(0), 100, 100).

draw_solar_params affiche sur l’image les paramètres solaires. Par exemple: draw_solar_params(img(0)). Par défaut, positionné en haut à droite. Il est possible de spéficier les coordonnées (x,y) où écrire : draw_solar_params(img(0), 500, 100).

draw_text imprime du texte sur l’image. Cette fonction prend 3 arguments obligatoires : l’image, la position où imprimer le texte, le texte à écrire. Par exemple : draw_text(img(0), 100, 100, "Hello World"). Elle accepte également 2 paramètres optionnels : la taille de la police et la couleur. Par exemple : draw_text(img(0), 100, 100, "Hello World", 24, "ff0000"). La couleur est une valeur hexadécimale RGB. NOTE : si vous spécifiez une couleur, alors l’image sera automatiquement convertie en RGB. Si le texte est entouré de * alors il sera imprimé en gras. Par exemple, draw_text(img(0), 100, 100, "\*Hello World\*"). Si le texte est entouré de _ alors il sera imprimé en italique. Par exemple, draw_text(img(0), 100, 100, "\_Hello World\_").

draw_arrow dessine une flèche sur l’image. Cette fonction prend 5 arguments obligatoires : l’image, les points de départ et d’arrivée de la flèche. Par exemple : draw_arrow(img(0), 100, 100, 200, 200). Elle accepte également 2 paramètres optionnels : l’épaisseur de la flèche et la couleur. Par exemple : draw_arrow(img(0), 100, 100, 200, 200, 2, "ff0000"). La couleur est une valeur hexadécimale RGB. NOTE : si vous spécifiez une couleur, alors l’image sera automatiquement convertie en RGB.

draw_circle dessine un cercle sur l’image. Cette fonction prend 4 arguments obligatoires : l’image, le centre du cercle et le rayon. Par exemple : draw_circle(img(0), 100, 100, 50). Elle accepte également 2 paramètres optionnels : l’épaisseur du cercle et la couleur. Par exemple : draw_circle(img(0), 100, 100, 50, 2, "ff0000"). La couleur est une valeur hexadécimale RGB. NOTE : si vous spécifiez une couleur, alors l’image sera automatiquement convertie en RGB.

draw_rect dessine un rectangle sur l’image. Cette fonction prend 5 arguments obligatoires : l’image, les coordonnées du coin supérieur gauche, la largeur et la hauteur. Par exemple : draw_rect(img(0), 100, 100, 200, 200). Elle accepte également 2 paramètres optionnels : l’épaisseur du rectangle et la couleur. Par exemple : draw_rect(img(0), 100, 100, 200, 200, 2, "ff0000"). La couleur est une valeur hexadécimale RGB. NOTE : si vous spécifiez une couleur, alors l’image sera automatiquement convertie en RGB.

draw_earth dessine la Terre sur l’image, à l’échelle du disque solaire. Cette fonction prend 3 paramètres : l’image et les coordonnées (x,y) où dessigner la Terre. Par exemple: draw_earth(img(0), 100, 100).

stack permet d’empiler des images. Elle aligne les images et calcule la valeur médiane de chaque pixel. Elle accepte entre 1 et 4 paramètres. Le premier est la liste des images à empiler, par exemple: stack(load_many("*.fits")). Le 2ème paramètre est la taille des tuiles et le 3ème est le facteur d’échantillonnage (>0). Par exemple, si le facteur d’échantillonnage est de 0,5 et la taille de la tuile de 32 pixels, alors un échantillon sera pris tous les 16 pixels. Le 4ème paramètre est la méthode de sélection de la référence, qui est l’une des suivantes : first (première image de la liste), sharpness (l’image la plus nette), average (calcule la moyenne de toutes les images), median (calcule la médiane de toutes les images) ou eccentricity (choisit l’image la plus proche d’un cercle). Par exemple : stack(load_many("\*.fits"), 32, 0.5, "sharpness"). Par défaut, la méthode de sélection de la référence est sharpness.

stack_ref prend 2 paramètres : une liste d’images et une méthode de sélection de référence. Elle renvoie alors une image pouvant servir de référence pour le stacking. Les méthodes de sélection sont les mêmes que pour stack. Par exemple : stack_ref(load_many("\*.fits"), "sharpness").

dedistort permet de corriger la distorsion d’une image. Elle dispose de 2 modes d’utilisation distincts. Dans le premier mode, on lui fournit une image de référence et une image à corriger, ainsi que 3 paramètres optionnels : la taille des tuiles, l’échantillonage et la valeur du fond de ciel. Par exemple : dedistort(ref, img(0), 32, 0.5, 0). L’image renvoyée sera corrigée en s’approchant au possible de l’image de référence, la rendant par exemple utilisable pour du stacking. Dans le second mode, on lui fournit une liste d’images à corriger (1er paramètre) et une liste d’images déja corrigées (2d paramètre), auquel cas les paramètres de correction de chaque image est pris en utilisant l’image de même index dans la liste des images déja corrigées. Ceci peut-être utile par exemple lorsqu’on calcule la distorsion sur le centre de la raie (décalage 0) et qu’on souhaite appliquer les mêmes corrections à des images de décalage différent. Par exemple : dedistort(images, corrected).

mosaic permet de créer une mosaïque d’images. Elle prend entre 1 et 3 paramètres. Le premier est la liste des images à empiler, par exemple: mosaic(load_many("*.fits")). Le 2ème paramètre est la taille des tuiles et le 3ème est le facteur de recouvrement (entre 0 et 1).

find_shift permet de calculer un décalage en pixels par rapport à la raie détectée. Elle accepte un seul paramètre, le nom de la raie recherchée, par exemple, find_shift("Helium (D3)"), ou bien la longueur d’onde en Angström, par exemple `find_shift(5875.62). Cette fonction retourne un nombre, le décalage en pixels.

continuum est une fonction sans paramètre qui détermine automatiquement une image de type "continuum" qui peut par exemple être soustraite d’une autre image. Cette fonction diffère de l’image continuum classique au sens où il ne s’agit pas d’une image unique calculée à la différence de pixels fixe de 15 pixels, mais d’une image calculée à partir de la médiane d’un ensemble d’images. Utilisation : continuum().

sort permet de trier une liste d’images. Elle accepte une liste d’images en premier argument et un critère de tri en second argument. Par exemple : sort(images, "date"). Le critère par défaut est shift pour le décalage en pixels.

video_datetime retourne la date et l’heure formatée d’une image. Elle accepte un ou deux paramètres : l’image et un format optionnel. Par exemple : video_datetime(img(0)) ou video_datetime(img(0), "yyyy-MM-dd HH:mm:ss")

helium_raw est l’image de la raie Hélium, décalée par rapport à la raie détectée et à laquelle on a soustrait l’image continuum.

helium_fixed est l’image helium_raw à laquelle on a appliqué l’algorithme de correction de transversalliums.

cropped est l’image helium_fixed à laquelle on a appliqué un rognage automatique et un ajustement de contraste.

helium_mono est l’image cropped telle quelle, en noir et blanc.

helium_color = colorize(fix_banding(helium_raw;BandWidth;BandIterations), "Helium (D3)") permet d’obtenir une version colorisée.

Animation : génère une vidéo dont chaque image est décalée de 0.25 pixels

Panneau : génère une seule image, un panneau où chaque case correspond à un décalage de pixels différent

le bouton radio "Moyenne / Images" qui permet de basculer entre l’image moyenne et les images individuelles du film SER

lorsque "Images" est sélectionné, le slider à droite permet de naviguer dans la vidéo

le seuil de détection du soleil peut être changé (non recommandé, le logiciel ne permet pas de modifier cette valeur, c’est un mode expert)

la case "vérouiller le polynôme" permet de figer la détection de ligne spectrale sur l’image actuelle : elle nous sera utile pour les mesures de distances

le slider "contraste" permet d’augmenter le contraste et la luminosité de l’image (transformation arcsin hyperbolique)

vérouiller le polynôme sur l’image moyenne

sélectionner le mode "Images"

Augmenter le contraste

Choisir une image au bord du limbe