Date de mise à jour : 24 mai 2010
Liste des fonctions utilisables :
Retourne le numéro de version de la librairie au format major.minor
En l'absence de paramètres, lit l'heure système d'un PC. Retourne la liste {année mois quantième heure minute seconde milliseconde
}. Si la liste {année mois quantième heure minute seconde milliseconde
} est donnée en argument, fixe l'heure système d'un PC avec les valeurs de la liste. Retourne la liste {année mois quantième heure minute seconde milliseconde
} après la mise à l'heure. ATTENTION
: Dans ce cas, l'utilisation de cette commande requiert que le
processus qui la lance ait les droits d'administrateur sur la machine.
Décale l'heure système d'un PC de la valeur numérique du paramètre decalage_en_ms
. Ce paramètre peut être positif (avance dans le temps) ou négatif (retard). ATTENTION : L'utilisation de cette commande requiert que le processus qui la lance ait les droits d'administrateur sur la machine.
Dans l'image contenue dans le buffer b
, calcule le flux d'une étoile contenue dans une ellipse de centre (x0, y0) d'axes principaux r1x
et r1y
et de facteur d'allongement ro
. Les paramètres r2
et r3
définissent les rayons des cercles (couronne) autour de cette ellipse
dans lesquels sera calculé le flux du fond de ciel. Le paramètre n
définit des sous-pixels artificiels, afin d'augmenter la précision des calculs. Les pixels sont découpés en n² sous-pixels, mais le temps de calcul sera multiplié par la même valeur...
L'ellipse a pour équation centrée : (x-x0)²/r1x² + (y-y0)²/r1y² - 2.0*ro*(x-x0)*(y-y0)/(r1x*r1y) = 1
, avec |ro| < 1
.
Cette fonction retourne la liste {flux_etoile nb_pixels_etoile flux_fond nb_pixels_fond sigma_fond}
.
flux_etoile
est le flux apporté par l'étoile, c'est à dire le flux contenu dans l'ellipse de taille nb_pixels
, flux auquel on a soustrait la quantité flux_fond*nb_pixels
.
flux_fond
est le flux moyen par pixel du fond de ciel calculé sur les nb_pixels_fond
de la couronne délimitée par r2
et r3
. sigma_fond
est l'écart-type du flux de fond de ciel.
Dans un carré définit par la liste {x1 y1 x2 y2}
dans l'image contenue dans le buffer b
,
modélise une nappe gaussienne représentant les valeurs de niveaux de
gris d'une étoile. Cette nappe est optimale au sens des moindres
carrés. La modélisation cherche à déterminer les paramètres x0, y0, r1x, r1y et ro
d'une nappe donnée par z=A*[(x-x0)²/r1x² + (y-y0)²/r1y² - 2.0*ro*(x-x0)*(y-y0)/(r1x*r1y)] + B
, où (x0, y0) sont les coordonnées du centroïde de l'étoile, r1x et r2x
les grands axes de l'ellipse, ro
son facteur d'allongement, A
le niveau de gris maximum de l'étoile et B
le niveau de gris du fond de ciel. Le mot-clé -sub
va soustraire l'étoile modélisée à celle encadrée dans le rectangle {x1 y1 x2 y2}
. Cette fonction retourne une liste de 24 paramètres {p0 p1 p2 ... p23}
x0
et y0
), (p13, p14) sont les incertitudes sur ces 2 coordonnées.Les valeurs suivantes sont des valeurs déduites des précédentes :
Effectue une Transformée de Fourier Discrète (TFD) sur le fichier image_source
et stocke le résultat dans les fichiers image_dest_1
et image_dest_2
.
Le paramètre optionnel type
définit le contenu des fichiers image_dest_1
et image_dest_2
. Si type
vaut :
image_dest_1
contiendra la partie réelle de la TFD, et image_dest_2
sa partie imaginaire. L'en-tête FITS de image_dest_1
va contenir le mot-clé DFT_TYPE avec pour valeur la chaine de caractère (string) REAL, celle de image_dest_2
le même mot-clé DFT_TYPE avec la valeur IMAG.image_dest_1
contiendra le module de la TFD, et image_dest_2
son argument. L'en-tête FITS de image_dest_1
va contenir le mot-clé DFT_TYPE avec pour valeur la chaine de caractère (string) SPECTRUM, celle de image_dest_2
le même mot-clé DFT_TYPE avec la valeur PHASE.NB : S'il n'est pas spécifié, type
vaut polar (valeur par défaut).
Le paramètre optionnel centrage
indique la façon dont seront rangées les informations dans les fichiers image_dest_1
et image_dest_2
. Si centrage
vaut :
image_dest_1
et image_dest_2
. L'en-tête FITS des deux images va contenir le mot-clé DFT_ORD avec pour valeur la chaine de caractère (string) CENTERED.image_dest_1
et image_dest_2
. L'en-tête FITS des deux images va contenir le mot-clé DFT_ORD avec pour valeur la chaine de caractère (string) REGULAR.NB : S'il n'est pas spécifié, centrage
vaut centered (valeur par défaut).
Les fichiers image_dest_1
et image_dest_2
sont codés sur 16 bits non signés. Le résultat d'une TFD étant signé, les valeurs des pixels sont décalées et normalisées dans l'intervalle [0-32767]. Les mots-clés DFT_OFFS et DFT_NORM définissent les valeurs du décalage et du facteur de normalisation.
Effectue la Transformée de Fourier Discrète Inverse des fichiers image_source_1
et image_source_2
pour générer l'image réelle image_destination
. Il s'agit de la fonction inverse de celle décrite par la commande dftd2.
Les fichiers image_source_1
et image_source_2
doivent :
Le fichier image_destination
est codé sur 16 bits non signés.
image_source
et stocke le résultat dans image_destination.
Le paramètre optionnel centrage
indique la façon dont seront rangées les informations dans le fichier image_destination
. Si centrage
vaut :
image_destination
. L'en-tête FITS de cette image va contenir le mot-clé DFT_ORD avec pour valeur la chaine de caractère (string) CENTERED.image_destination
. L'en-tête FITS de cette image va contenir le mot-clé DFT_ORD avec pour valeur la chaine de caractère (string) REGULAR.NB : S'il n'est pas spécifié, centrage
vaut centered (valeur par défaut).
Le paramètre optionnel normalisation
précise la dynamique de l'image image_destination
. Il peut prendre les valeurs :
image_destination
aura la même dynamique que celle de l'image image_source
, c'est à dire que les valeurs extrêmales des pixels seront identiques.image_destination
aura la dynamique fournie par le calcul classique d'une fonction d'auto-correlation.NB : S'il n'est pas spécifié, normalisation
vaut norm (valeur par défaut).
Le fichier image_destination
est codé en virgule flottante.
image_source_1
et image_source_2
et stocke le résultat dans image_destination.
Si les images image_source_1
et image_source_2
n'ont pas la même taille, la plus petite doit pouvoir être complètement contenue dans la plus grande, c'est à dire que les deux dimensions de la petite doivent être inférieures à celles de la plus grande.
Le paramètre optionnel normalisation
précise la dynamique de l'image image_destination
. Il peut prendre les valeurs :
image_destination
aura la même dynamique que celle de l'image image_source_1
, c'est à dire que les valeurs extrêmales des pixels seront identiques.image_destination
aura la dynamique fournie par le calcul classique d'une fonction d'auto-correlation.NB : S'il n'est pas spécifié, normalisation
vaut norm (valeur par défaut).
Le fichier image_destination
est codé en virgule flottante.
image_source_1
et image_source_2
et stocke le résultat dans image_destination.
L'image image_source_2
joue le rôle de noyau de convolution, c'est à dire que le produit de convolution est décalé d'un nombre de pixels égal à la moitié de la largeur et de la hauteur de l'image image_source_2
.
Si les images image_source_1
et image_source_2
n'ont pas la même taille, la plus petite doit pouvoir être complètement contenue dans la plus grande, c'est à dire que les deux dimensions de la petite doivent être inférieures à celles de la plus grande.
Le paramètre optionnel normalisation
précise la dynamique de l'image image_destination
. Il peut prendre les valeurs :
image_destination
aura la même dynamique que celle de l'image image_source_1
, c'est à dire que les valeurs extrêmales des pixels seront identiques.image_destination
aura la dynamique fournie par le calcul classique d'une fonction de convolution.NB : S'il n'est pas spécifié, normalisation
vaut norm (valeur par défaut).
Le fichier image_destination
est codé en virgule flottante.