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.

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.

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é.

autocrop permet de réduire l’image à un carré autour du disque solaire. Cette fonction fonctionne grâce à l’ellipse corrigée et utilise le centre du disque pour centrer l’image. Par exemple: autocrop(img(0)).

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)).

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).

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.

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).

stack permet d’empiler des images. Elle prend entre 1 et 3 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 de recouvrement (entre 0 et 1).

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).

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

sélectionner le mode "Images"

Augmenter le contraste

Choisir une image au bord du limbe