Date de mise à jour : 24 mai 2010

Fonctions de la librairie libjm

Liste des fonctions utilisables :

jm_versionlib

Retourne le numéro de version de la librairie au format major.minor

jm_heurepc [{année mois quantième heure minute seconde milliseconde}]

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.

jm_reglageheurepc decalage en ms

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.

calaphot_fluxellipse b x0 y0 r1x r1y ro r2 r3 [n]

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

calaphot_fitgauss2d b {x1 y1 x2 y2} [-sub]

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}

Les valeurs suivantes sont des valeurs déduites des précédentes :

dft2d image_source image_dest_1 image_dest_2 [ type [ centrage ] ]

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 :

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 :

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.

idft2d image_source_1 image_source_2 image_destination

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.

acorr2d image_source image_destination [ centrage [ normalisation ] ]

Effectue l'auto-correlation de l'image contenue dans 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 :

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 :

NB : S'il n'est pas spécifié, normalisation vaut norm (valeur par défaut).

Le fichier image_destination est codé en virgule flottante.

icorr2d image_source_1 image_source_2 image_destination [ normalisation ]

Effectue l'inter-correlation des images contenues dans 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 :

NB : S'il n'est pas spécifié, normalisation vaut norm (valeur par défaut).

Le fichier image_destination est codé en virgule flottante.

conv2d image_source_1 image_source_2 image_destination [ normalisation ]

Effectue le produit de convolution des images contenues dans 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 :

NB : S'il n'est pas spécifié, normalisation vaut norm (valeur par défaut).

Le fichier image_destination est codé en virgule flottante.