Fonctions ImageMath

Cette page décrit les fonctions disponibles dans les scripts ImageMath.

Reconstruction d’images solaires

IMG

Renvoie l’image reconstruite au décalage de pixel spécifié.

Argument

Requis ?

Description

Valeur par défaut

ps

Décalage de pixel

Exemples

img(0)

img(ps: 1)

img(ps: a2px(1)) // 1 Å pixel shift

RANGE

Renvoie des images reconstruites aux décalages de pixel spécifiés par l’intervalle.

Argument

Requis ?

Description

Valeur par défaut

from

to

Fin de l’intervalle (inclusif)

step

Pas de l’intervalle

Exemples

range(-1;1)

range(-1;1;0.5))

range(from: -10; to: 10; step: 2)

Fonctions mathématiques

AVG

Calcule la moyenne de ses arguments. Si les arguments sont des images, la moyenne est calculée pixel par pixel.

Argument

Requis ?

Description

Valeur par défaut

list

Arguments

Exemples

avg(range(-1;1))

avg(img(0); img(1))

CONCAT

Concatène des listes d’arguments.

Argument

Requis ?

Description

Valeur par défaut

list

Arguments

Exemples

concat(list(img(0));range(-1;1))

EXP

Calcule une exponentielle

Argument

Requis ?

Description

Valeur par défaut

v

Valeur

exp

Exposant

Exemples

exp(img(0); 1.5)

exp(v:img(0), exp: 2)

exp(2, 3)

exp(v:2, exp: 3)

LOG

Calcule un logarithme

Argument

Requis ?

Description

Valeur par défaut

v

Valeur

exp

Exposant

Exemples

log(img(0); 1.5)

log(v:img(0), exp: 2)

log(2, 3)

log(v:2, exp: 3)

MAX

Calcule le maximum de ses arguments. Si les arguments sont des images, le maximum est calculée pixel par pixel.

Argument

Requis ?

Description

Valeur par défaut

list

Arguments

Exemples

max(range(-1;1))

max(img(0); img(1))

MEDIAN

Calcule la médiane de ses arguments. Si les arguments sont des images, la médiane est calculée pixel par pixel.

Argument

Requis ?

Description

Valeur par défaut

list

Arguments

Exemples

median(range(-1;1))

median(img(0); img(1))

MIN

Calcule le minimum de ses arguments. Si les arguments sont des images, le minimum est calculée pixel par pixel.

Argument

Requis ?

Description

Valeur par défaut

list

Arguments

Exemples

min(range(-1;1))

min(img(0); img(1))

POW

Calcule une puissance

Argument

Requis ?

Description

Valeur par défaut

v

Valeur

exp

Exposant

Exemples

pow(img(0); 1.5)

pow(v:img(0), exp: 2)

pow(2, 3)

pow(v:2, exp: 3)

WEIGHTED_AVG

Calcule une moyenne pondérée d’images

Argument

Requis ?

Description

Valeur par défaut

images

Images

weights

Poids

Exemples

weighted_avg(range(-1;1);list(.5;1;.5))

weighted_avg(images: range(-1;1); weights: list(.5;1;.5)))

Utilitaires

AR_OVERLAY

Génère une image avec les taches solaires détectées. Cette fonction ne fonctionnera que si la génération d’images de taches solaires a été sélectionnée.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

labels

0 : ne pas afficher 1 : afficher les zones et les labels 2 : affichier uniquement les labels

Exemples

ar_overlay(continuum())

ar_overlay(img: img(0); labels: 2)

CHOOSE_FILE

Ouvre une boîte de dialogue pour choisir un fichier image.

Argument

Requis ?

Description

Valeur par défaut

id

An ID for the file chooser. The next time the function is called with the same ID, the directory where the file chooser was opened will be used as the starting point.

message

Titre de la boîte de dialogue

Exemples

choose_file("my_id", "Choose a file")

choose_file(id: "my_id", title: "Choose a file")

CHOOSE_FILES

Ouvre une boîte de dialogue pour choisir des fichiers image.

Argument

Requis ?

Description

Valeur par défaut

id

An ID for the file chooser. The next time the function is called with the same ID, the directory where the file chooser was opened will be used as the starting point.

message

Titre de la boîte de dialogue

Exemples

choose_files("my_id", "Choose a file")

choose_files(id: "my_id", title: "Choose a file")

ELLIPSE_FIT

Force une nouvelle détection de la forme du disque solaire.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

Exemples

ellipse_fit(img(0))

ellipse_fit(img:range(0;1))

FILTER

La fonction filter permet de filtrer une liste d’images pour ne conserver que celles qui correspondent à un critère particulier. Ceci peut être particulièrement utile en mode batch. Par exemple, vous pouvez vouloir effectuer un retournement vertical et horizontal des images après un certain temps, en raison du retournement méridien.

Argument

Requis ?

Description

Valeur par défaut

img

Liste d’images à filtrer.

subject

Sujet du filtre (file-name, dir-name, pixel-shift, time ou datetime).

function

Opérateur à appliquer pour filtrer les images.

value

Valeur de comparaison

Sujet

Description

Opérateurs disponibles

Exemple

file-name

Le nom du fichier SER

=, `

=, `contains, starts_with, ends_with

filter(images, "file-name", "contains", "2021-06-01")

dir-name

Le nom du dossier qui contient le fichier SER

=, `

=, `contains, starts_with, ends_with

filter(images, "dir-name", "contains", "2021-06-01")

pixel-shift

Le décalage de pixels de l’image

=, `

=, `>, <, >=, ⇐

filter(images, "pixel-shift", ">", 0)

time

L’heure d’acquisition (comparé en UTC)

=, `

=, `>, <, >=, ⇐

filter(images, "time", ">", "12:00:00")

datetime

La date et l’heure de l’acquisition (comparée en UTC)

=, `

=, `>, <, >=, ⇐

Exemples

filter(images, "file-name", "contains", "2021-06-01")

filter(img: images, subject:"file-name", function:"contains", value:"2021-06-01")

filter(images, "dir-name", "contains", "2021-06-01")

filter(imgimages, subject:"dir-name", function:"contains", value:"2021-06-01")

filter(images, "pixel-shift", ">", 0)

filter(images, "time", ">", "12:00:00")

filter(images, "datetime", ">", "2021-06-01 12:00:00")

GET_AT

Renvoie la valeur d’un élément d’une liste à la position spécifiée.

Argument

Requis ?

Description

Valeur par défaut

list

Liste

index

Index

Exemples

get_at(list; 0)

get_at(list: some_list; index: 1)

GET_B

Extraie le canal bleu d’une image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

Exemples

get_b(some_image)

get_b(img: some_image)

GET_G

Extraie le canal vert d’une image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

Exemples

get_g(some_image)

get_g(img: some_image)

GET_R

Extraie le canal rouge d’une image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

Exemples

get_r(some_image)

get_r(img: some_image)

LIST

Crée une liste à partir des paramètres.

Argument

Requis ?

Description

Valeur par défaut

list

Liste

Exemples

list(img(-3), img(3))

list(list: img(-3), img(3))

LOAD

Charge une image depuis un fichier.

Argument

Requis ?

Description

Valeur par défaut

file

Chemin du fichier

Exemples

load('image.fits')

load(file: '/path/to/image.fits')

LOAD_MANY

Charge des images depuis un dossier.

Argument

Requis ?

Description

Valeur par défaut

dir

Chemin du dossier

pattern

Expression régulière pour filtrer les fichiers

Exemples

load_many("/chemin/vers/dossier")

load_many(dir: "/chemin/vers/dossier", pattern:".*cropped.*")

MONO

Convertit une image couleur en niveaux de gris.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

Exemples

mono(some_image)

mono(img: some_image)

REMOTE_SCRIPTGEN

Fonction expérimentale et avancée qui est décrite spécifiquement dans cette section.

Argument

Requis ?

Description

Valeur par défaut

url

URL du service à invoquer

Exemples

remote_scriptgen("http://localhost:8080/jsolex/remote")

remote_scriptgen(url: "http://localhost:8080/jsolex/remote")

RGB

Crée une image RGB à partir de trois images mono.

Argument

Requis ?

Description

Valeur par défaut

r

Image rouge

g

Image verte

b

Image bleue

Exemples

rgb(img(-1);img(0);img(1))

rgb(r: redWing; g: avg(redWing;blueWing); b: blueWing)

SORT

Trie une liste d’images

Argument

Requis ?

Description

Valeur par défaut

images

Images

order

Ordre de tri. Peut-être date, shift ou file_name, modulé par asc ou desc.

shift

Exemples

sort(images, 'date')

sort(images, 'date asc')

sort(images: images, order: 'date desc')

VIDEO_DATETIME

Renvoie la date/heure à laquelle une vidéo a été enregistrée.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

format

Format de la date.

Exemples

video_datetime(img(0))

video_datetime(img: img(0), format:"yyyy-MM-dd HH:mm:ss")

WAVELEN

Renvoie la longueur d’onde d’une image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

Exemples

wavelen(img(0))

wavelen(img: img(0))

WORKDIR

Change le dossier de travail dans lequel les images sont chargées par les fonctions LOAD et LOAD_MANY.

Argument

Requis ?

Description

Valeur par défaut

dir

Dossier de travail

Exemples

workdir('/path/to/dir')

workdir(dir: '/path/to/dir')

Amélioration d’image

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.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

min

Valeur minimum

max

Valeur maximum

Exemples

adjust_contrast(img: img(0), min: 10, max: 200)

adjust_contrast(img(0), 10, 200)

ADJUST_GAMMA

Applique une modification gamma à une image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

gamma

Gamma

Exemples

adjust_gamma(img: img(0), gamma: 2.2)

adjust_gamma(img(0), 1.5)

ASINH_STRETCH

Permet d’appliquer la fonction d’étirement par arcsinus hyperbolique.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

bp

Point noir

stretch

Facteur d’étirement

Exemples

asinh_stretch(img: img(0), bp: 500, stretch: 2.5)

asinh_stretch(img(0), 0, 10)

AUTO_CONTRAST

C’est une fonction d’amélioration du contraste crée spécifiquement pour les images de spectrohéliographes. Elle combine plusieurs techniques pour améliorer l’image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

gamma

Gamma

bg

Aggressivité de la correction du fond entre 0 et 1. 1 = pas de correction, 0 = correction maximale.

0.25

protusStretch

Amplification des protubérances. 0 = pas d’amplification

Exemples

auto_contrast(img: img(0), gamma: 1.5)

auto_contrast(img(0), 1.5)

BLUR

Applique un flou gaussien à une image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

kernel

Taille du noyau

Exemples

blur(img(0))

blur(img(0), 7)

blur(img: img(0), kernel:7)

CLAHE

Applique une transformation CLAHE (Contrast Limited Adaptive Histogram Equalization) à une image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

ts

Taille de la tuile

bins

Nombre de paniers

clip

Valeur de coupure

Exemples

clahe(img: img(0), ts: 16, bins: 128, clip: 1.1)

clahe(img(0), 16, 128, 1.1)

COLORIZE

Colorise une image en utilisant un profil de couleur lié à la longueur d’onde.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

profile

Nom du profil (voir éditeur de raies spectrales)

Exemples

colorize(img: img(0), profile: "H-alpha")

colorize(range(-1, 1), "Calcium (K)")

COLORIZE2

Colorise une image en utilisant une modélisation des courbes de couleur. Les courbes sont définies par 2 points de contrôle: la valeur d’entrée et la valeur de sortie.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

rIn

Valeur d’entrée pour le rouge (0-255)

rOut

Valeur de sortie pour le rouge (0-255)

gIn

Valeur d’entrée pour le vert (0-255)

gOut

Valeur de sortie pour le vert (0-255)

bIn

Valeur d’entrée pour le bleu (0-255)

bOut

Valeur de sortie pour le bleu (0-255)

Exemples

colorize2(img: img(0), rIn: 50, rOut: 200, gIn: 50, gOut: 200, bIn: 50, bOut: 200)

colorize2(img(0), 50, 200, 50, 200, 50, 200)

CURVE_TRANSFORM

Applique une transformation de courbe à une image. La transformation interpole un polynôme de degré 2 passant par trois points: le point d’origine (0,0), le point de la courbe (in, out) et le point extrême (255,255).

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

in

Valeur d’entrée de la courbe (0-255)

out

Valeur de sortie de la courbe (0-255)

Exemples

curve_transform(img(0), 100, 120)

curve_transform(img: img(0), in:50, out: 200)

DISK_FILL

Remplit le disque solaire détecté avec une valeur donnée (par défault, celle du point noir détecté).

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

fill

Valeur de remplissage

detected black point value

Exemples

disk_fill(img(0))

disk_fill(img: img(0), fill: 200)

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.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

invert

Inversion du masque (1 signifie valeur 0 à l’intérieur, 1 à l’extérieur)

Exemples

disk_mask(img(0))

disk_mask(img: img(0), invert: 1)

EQUALIZE

Egalise l’histogramme des images en paramètre pour qu’elles aient toutes à peu près la même luminosité.

Argument

Requis ?

Description

Valeur par défaut

list

Liste d’images à égaliser.

Exemples

equalize(range(-1;1))

equalize(list: some_images)

FIX_BANDING

Applique une correction de bandes sur l’image

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

bs

Largeur de la bande

passes

Nombre de passes

Exemples

fix_banding(img(0), 64, 3)

fix_banding(img: img(0), bs: 48, passes: 10)

FIX_GEOMETRY

Corrige la géométrie de l’image en fonction de l’ellipse calculée

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

Exemples

fix_geometry(img(0))

fix_geometry(img: img(0))

FLAT_CORRECTION

Calcule une image de flat artificielle pour corriger l’image puis applique la correction.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

lo

Valeur du percentile bas

0.1

hi

Valeur du percentile haut

0.95

order

Ordre du polynome

[NOTE] .Expérimental ==== La correction par flat artificiel permet de corriger un éventuel vignettage. Elle calcule un modèle à partir des pixels du disque. Les pixels considérés sont ceux dont la valeur est comprise entre un percentile bas et un percentile haut. Par exemple, si vous entrez 0.1 et 0.9, les pixels dont la valeur est comprise entre le 10ème et le 90ème percentile seront utilisés pour calculer le modèle. Enfin, un polynome d’ordre spécifié est ajusté sur les valeurs du modèle pour corriger l’image. ====

Exemples

flat_correction(img(0))

flat_correction(img: img(0), order: 3)

INVERT

Inverse les couleurs d’une image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

Exemples

invert(img(0))

invert(img: img(0))

LINEAR_STRETCH

Etire l’histogramme d’une image pour qu’il occupe toute la plage de valeurs possibles. Cette fonction peut aussi être utilisée pour compresser les valeurs d’une image dans la plage de valeurs possibles (par exemple après un calcul exponentiel).

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

lo

Valeur minimale de l’histogramme à étirer.

hi

Valeur maximale de l’histogramme à étirer.

65535

Exemples

linear_stretch(img(0))

linear_stretch(img(0), 10000, 48000)

linear_stretch(img: img(0), hi: 48000)

RL_DECON

Applique l’algorithme de déconvolution de Richardson-Lucy à l’image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

radius

Rayon de la gaussienne

2.5

sigma

Sigma

2.5

iterations

Nombre d’itérations

Exemples

rl_decon(img(0))

SATURATE

Sature les couleurs d’une image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

factor

Saturation

Exemples

saturate(img(0);1.5)

saturate(img: img(0); factor: 1.5)

SHARPEN

Applique un filtre de netteté à une image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

kernel

Taille du noyau

Exemples

sharpen(img(0))

sharpen(img(0), 7)

sharpen(img: img(0), kernel:7)

Recadrage

AUTOCROP

Rogne automatiquement une image autour du disque solaire. Les dimensions de la zone de rognage sont déterminées par l’ellipse mais aussi les dimensions de l’image. Il est préférable d’utiliser la fonction autocrop2 qui garantit un rognage centré et carré.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

Exemples

autocrop(img: img(0))

autocrop(img(0))

AUTOCROP2

Crée une image centrée et carrée autour du disque solaire.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

factor

La largeur de l’image sera le diamètre du disque solaire multiplié par ce facteur.

1.1

rounding

La largeur de l’image sera arrondie à ce multiple. Doit être un multiple de 2.

Exemples

autocrop2(img: img(0))

autocrop2(img(0))

CROP

Rogne une image aux coordonnées et dimensions spécifiées.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

left

Coordonnée X du coin supérieur gauche de la zone de rognage.

top

Coordonnée Y du coin supérieur gauche de la zone de rognage.

width

Largeur de la zone de rognage.

height

Hauteur de la zone de rognage.

Exemples

crop(img(0), 10, 20, 100, 200)

crop(img: img(0), left: 10, top: 20, width: 100, height: 200)

CROP_AR

Génère une liste d’images correspondant aux taches solaires détectées.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

ms

Taille minimale de la tache.

margin

Marge autour de la tache (en %).

Exemples

crop_ar(continuum))

crop_ar(img:img(0), margin: 15)

CROP_RECT

Réduit l’image aux dimensions indiquées, en garantissant que le centre du disque solaire sera au centre de l’image. Il n’y a pas de changement d’échelle : si le disque solaire n’entre pas dans les dimensions cibles, il sera tronqué.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

width

Largeur de la zone de rognage.

height

Hauteur de la zone de rognage.

Exemples

crop_rect(img(0), 1024, 1024)

crop_rect(img: img(0), width: 200, height: 200)

Extraction de fond

BG_MODEL

Crée un modèle de fond de ciel à partir d’une image, qui peut par exemple être soustraite de l’image d’origine.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

order

Ordre du polynôme. Une valeur supérieure à 3 n’est pas recommandée.

sigma

Nombre de sigmas pour la sélection des échantillons.

2.5

Exemples

bg_model(img(0); 2.5; 3)

bg_model(img: img(0); sigma: 3)

NEUTRALIZE_BG

C’est une fonction similaire à remove_bg qui utilise une modélisation polynomiale du fond pour supprimer les gradients. Cette fonction est utilisable sur des images sans information d’ellipse (disque solaire)

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

iterations

Nombre d’itérations de l’algorithme.

Exemples

neutralize_bg(some_image)

neutralize_bg(img: img(0), iterations: 5)

REMOVE_BG

Supprime le fond d’une image. Cela peut être utilisé lorsque le contraste est très faible (par exemple dans le traitement de l’hélium) et que l’étirement de l’image étire également l’arrière-plan. Ce processus calcule la valeur moyenne des pixels en dehors du disque, puis utilise cela pour effectuer une suppression adaptative en fonction de la distance par rapport au limbe, afin de préserver les structures lumineuses autour du limbe.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

tolerance

Tolerance

0.9

Exemples

remove_bg(some_image)

remove_bg(img: img(0), tolerance: .5)

Rotations et redimensionnement

HFLIP

Inverse horizontalement une image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

Exemples

hflip(some_image)

hflip(img: img(0))

RADIUS_RESCALE

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.

Argument

Requis ?

Description

Valeur par défaut

images

Image(s)

Exemples

radius_rescale(some_image)

radius_rescale(images: my_list)

RESCALE_ABS

Redimensionne une image aux dimensions absolues spécifiées.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

width

Largeur de l’image

height

Hauteur de l’image

Exemples

rescale_abs(img(0), 100, 100)

rescale_abs(img: img(0), width: 100, height: 100)

RESCALE_REL

Redimensionne une image en appliquant un facteur de redimensionnement.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

sx

Facteur de redimensionnement horizontal

sy

Facteur de redimensionnement vertical

Exemples

rescale_rel(img(0), .5, .5)

rescale_rel(img: img(0), sx: 0.5, sy: 0.5)

ROTATE_DEG

Applique une rotation à une image, en degrés.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

angle

Angle

bp

Valeur de remplissage pour les pixels en dehors de l’image.

resize

Redimensionner l’image pour s’adapter à la rotation.

Exemples

rotate_deg(img(0); 30)

rotate_deg(img: img(0); angle: 30)

ROTATE_LEFT

Applique une rotation à gauche.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

Exemples

rotate_left(img(0))

rotate_left(img: img(0))

ROTATE_RAD

Applique une rotation à une image, en radians.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

angle

Angle

bp

Valeur de remplissage pour les pixels en dehors de l’image.

resize

Redimensionner l’image pour s’adapter à la rotation.

Exemples

rotate_rad(img(0); 2.1)

rotate_rad(img: img(0); angle: 2.1)

ROTATE_RIGHT

Applique une rotation à droite.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

Exemples

rotate_right(img(0))

rotate_right(img: img(0))

VFLIP

Inverse verticalement une image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

Exemples

vflip(some_image)

vflip(img: img(0))

Analyse

A2PX

Calcule le nombre de pixels correspondant à une distance en Angstroms. La distance est déterminée en calculant la dispersion, qui ne sera correcte que si vous avez bien renseigné la taille des pixels de la caméra, ainsi que votre spectrohéliographe.

Argument

Requis ?

Description

Valeur par défaut

a

Angstroms

ref

Longueur d’onde de référence en Angstroms

Exemples

a2px(1.2)

a2px(a: 1.2, ref: 6328)

CONTINUUM

Génère une image du continuum autour de la raie étudiée. 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.

Argument

Requis ?

Description

Valeur par défaut

Exemples

continuum()

FIND_SHIFT

Calculee un décalage en pixels par rapport à la raie détectée. La distance est déterminée en calculant la dispersion, qui ne sera correcte que si vous avez bien renseigné la taille des pixels de la caméra, ainsi que votre spectrohéliographe.

Argument

Requis ?

Description

Valeur par défaut

wl

Longueur d’onde recherchée en Angstroms ou nom de la raie

ref

Longueur d’onde de référence en Angstroms

Exemples

find_shift(5875.62)

find_shift(wl: 5875.62, ref: 5895.92)

PX2A

Calcule le nombre d’angstroms correspondant à une distance en pixels. La distance est déterminée en calculant la dispersion, qui ne sera correcte que si vous avez bien renseigné la taille des pixels de la caméra, ainsi que votre spectrohéliographe.

Argument

Requis ?

Description

Valeur par défaut

px

pixels

ref

Longueur d’onde de référence en Angstroms

Exemples

px2a(24)

px2a(px: 24, ref: 6328)

Dessin

DRAW_ARROW

Dessine une flèche sur l’image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

x1

Début de la flèche (coordonnée X)

y1

Début de la flèche (coordonnée Y)

x2

Fin de la flèche (coordonnée X)

y2

Fin de la flèche (coordonnée Y)

thickness

Épaisseur de la flèche

color

Couleur de la flèche

Exemples

draw_arrow(img(0), 100, 100, 200, 200, 2, "ff0000")

draw_arrow(img:img(0), x1:100, y1:100, x2:200, y2:200, color: "ff0000")

DRAW_CIRCLE

Dessine un cercle sur l’image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

cx

Coordonnéee X du centre du cercle

cy

Coordonnée Y du centre du cercle

thickness

Épaisseur de la flèche

color

Couleur de la flèche

Exemples

draw_circle(img(0), 100, 100, 2)

draw_circle(img:img(0), cx:100, cy:100, color: "ff0000")

DRAW_EARTH

Dessine la Terre sur l’image, à l’échelle du disque solaire

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

x

Coordonnée X du centre de la Terre

y

Coordonnée Y du centre de la Terre

Exemples

draw_earth(img(0), 100, 100)

draw_earth(img:img(0), x:100, y:100)

DRAW_GLOBE

Dessine un globe dont l’orientation et le diamètre correspond aux paramètres solaires détectés.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

angleP

angle P

b0

Angle b0

style

Style du globe. Valeurs possibles : equatorial_coords (N/S E/W correspondant au N/S céleste), solar_coords (N/S E/W correspondant aux axes solaires)

equatorial_coords

correctAngleP

1 pour corriger l’angle P (l’axe passant par le point P vertical), 0 sinon

Exemples

draw_globe(img(0))

draw_globe(img:img(0), angleP: 0)

DRAW_OBS_DETAILS

Affiche sur l’image les données d’observation

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

x

Coordonnée X

y

Coordonnée Y

Exemples

draw_obs_details(img(0), 100, 100)

draw_obs_details(img:img(0), x:100, y:100)

DRAW_RECT

Dessine un rectangle sur l’image.

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

left

Coordonnéee X du coin supérieur gauche du rectangle

top

Coordonnée Y du coin supérieur gauche du rectangle

width

Largeur du rectangle

height

Hauteur du rectangle

thickness

Épaisseur du trait

color

Couleur de la ligne

Exemples

draw_rect(img(0), 100, 100, 300, 200)

draw_rect(img:img(0), left:100, top:100, color: "ff0000")

DRAW_SOLAR_PARAMS

Affiche sur l’image les paramètres solaires

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

x

Coordonnée X

top right

y

Coordonnée Y

top right

Exemples

draw_solar_params(img(0), 100, 100)

draw_solar_params(img:img(0), x:100, y:100)

DRAW_TEXT

Ecrit du texte sur l’image

Argument

Requis ?

Description

Valeur par défaut

img

Image(s)

x

Coordonnéee X

y

Coordonnée Y

text

Texte à écrire

fs

Taille de la police

auto

color

Couleur de la flèche

Exemples

draw_circle(img(0), 100, 100, 2)

draw_circle(img:img(0), cx:100, cy:100, color: "ff0000")

Animations

ANIM

Crée une animation à partir d’une série d’images.

Argument

Requis ?

Description

Valeur par défaut

images

The list of images

delay

Délai entre chaque trame (en ms)

250

Exemples

anim(range(0,10))

anim(images: range(0,10), delay: 100)

TRANSITION

Interpole des images entre elles. Par défaut, l’interpolation est linéaire et elle créera exactement le nombre d’images spécifié. Cependant, si une unité est spécifiée, alors le comportement sera différent: le nombre d’étapes correspond au nombre d’images à créer, pour une unité de temps donnée, pour le temps écoulé entre les deux images. Par exemple, si une image a été prise à 10:00 et l’autre à 10:02, et que l’unité est ipm, que le nombre d’étapes est 10, alors 20 images seront créées. Cela permet de créer des transitions plus douces lorsque les fichiers SER n’ont pas été enregistrés à intervalles réguliers.

Argument

Requis ?

Description

Valeur par défaut

images

Image(s)

steps

Nombre d’images intermédiaires à générer.

type

Type d’interpolation: linear, ease_in, ease_out ou ease_in_out.

linear

unit

Unité de l’interpolation: ips (images par seconde), ipm (images par minute) ou iph (images par heure).

Exemples

transition(list(img(0), img(1)), 10)

transition(images: my_imges, steps: 10, type: ease_in, unit: 'ipm')

Empilement et composition de mosaïque

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’échantillonnage et la valeur du fond de ciel. 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, 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.

Argument

Requis ?

Description

Valeur par défaut

ref

Image(s) de référence

img

Images à corriger.

ts

Taille des tuiles.

sampling

Echantillonnage. Une valeur de 0.5 pour une taille de tuile de 32 pixels signifie qu’il y aura un échantillon tous les 16 pixels.

0.5

threshold

Valeur du fond de ciel.

Exemples

crop_rect(img(0), 1024, 1024)

crop_rect(img: img(0), width: 200, height: 200)

MOSAIC

Permet de créer une mosaïque d’images.

Argument

Requis ?

Description

Valeur par défaut

images

Images à assembler.

ts

Taille des tuiles

sampling

Facteur d’échantillonnage

0.25

Exemples

mosaic(some_images)

mosaic(images: some_images, ts: 128)

STACK

Empile plusieurs images.

Argument

Requis ?

Description

Valeur par défaut

images

Images à empiler.

ts

Taille des tuiles

sampling

Facteur d’échantillonnage

0.5

select

Méthode de sélection de la meilleure image. Peut-être sharpness (image la plus nette), average (moyenne de toutes les images), median (médiane de toutes les images) ou eccentricity (image du soleil le plus rond). En mode batch, un mode manual est aussi disponible.

sharpness

Exemples

stack(some_images)

stack(some_images, 64; .5; "eccentricity")

stack(images: some_images, ts: 128, sampling: 0.5, select: "sharpness")

STACK_REF

Sélectionne une image de référence pour le stacking.

Argument

Requis ?

Description

Valeur par défaut

images

Images à empiler.

select

sharpness

Exemples

stack_ref(some_images)

stack_ref(some_images, "eccentricity")

stack_Ref(images: some_images, select: "sharpness")