Date de mise à jour : 02 avril 2011

Fonctions utilitaires

Les fonctions qui suivent sont dans le namespace ::

Elles peuvent être exécutées directement dans la Console d'Aud'ACE.

loadima ?nom? ?visuNo? ?affichage?

Charge une image en mémoire. Les trois arguments sont optionnels : Le premier est le nom du fichier à charger. S'il n'est pas précisé alors il prend la valeur "?" par défaut, ce qui a pour effet d'ouvrir un explorateur pour aller chercher l'image à la main. Le second argument est le numéro de visu (visuNo). S'il n'est pas précisé alors il prend la valeur "1" par défaut, c'est le numéro de visu de la fenêtre principale. Le troisième argument doit prendre la valeur "-novisu" pour ne pas afficher l'image, ce qui peut être pratique pour aller plus vite lors de traitements.

Remarque : Faire attention aux caractères \ sous Windows car ce sont des caractères de substitution pour le TCL. Il faut en mettre deux au lieu d'un, ou alors il vaut mieux les remplacer par le caractère /, qui lui est compatible. Par exemple, les deux expressions suivantes sont équivalentes :

Il faut également faire attention aux espaces dans les noms de répertoires, car les espaces servent à délimiter les arguments d'une commande en TCL. Il faut soit mettre des guillemets, soit des accolades :

saveima ?nom?

Enregistre l'image actuellement en mémoire. L'argument optionnel est le nom de l'image, s'il n'est pas précisé alors un explorateur permet de naviguer sur le disque pour indiquer le nom du fichier. Sinon, l'image est enregistrée avec le nom donné, dans le répertoire images d'Aud'ACE.

Les règles liées aux \ et aux espaces sont identiques à loadima.

visu ?seuils?

Cette fonction permet d'afficher l'image actuellement en mémoire dans Aud'ACE. Le paramètre qui suit éventuellement correspond à la liste des seuils de visualisation souhaités. S'ils ne sont pas précisés alors l'affichage est simplement rafraîchi. Les seuils doivent être donnés dans l'ordre 'seuil haut' 'seuil bas'. Deux possibilités existent pour faire une telle liste (nécessaire à cette fonction) :

visu {1897 345}

visu [list 1897 345]

Si le seuil haut est plus faible que le seuil bas alors l'image est vue en négatif.

stat

Cette fonction renvoie une liste composée de 9 valeurs caractérisant l'image. Ces valeurs sont décrites dans le tableau suivant, dans l'ordre où elles apparaissent dans la liste.

acq duree binning

Cette fonction effectue une acquisition avec la caméra sélectionnée dans les réglages d'Aud'ACE. Les deux paramètres de la ligne de commande correspondent respectivement à la durée d'exposition de l'image et au binning (nécessairement identique dans les deux directions).

Exemple d'acquisition d'une image de 60s en binning 2x2 : acq 60 2

fwhm visuNo

Pour une visu donnée (visuNo), cette commande calcule la fwhm suivant l'axe horizontal et l'axe vertical d'une ou des étoiles qui est ou sont dans une boîte préalablement dessinée sur l'image.

Le résultat de cette commande est l'ouverture de le fenêtre accessible par le menu Analyse --> Fwhm avec les 2 valeurs fwhmx et fwhmy.

offset val

Fonction de traitement d'images. Elle réalise un offset sur l'image actuellement en mémoire, c'est à dire un ajout ou un retrait d'une constante à tous les pixels de l'image. La valeur fournie en argument correspond à la valeur dont on veut décaler l'image.

noffset val

Fonction de traitement d'images. Réalise une normalisation par offset, la moyenne du fond de ciel de l'image est ajustée à la valeur passée en argument en réalisant un offset de l'image.

ngain val

Fonction de traitement d'images. Réalise une normalisation par gain, la moyenne du fond de ciel de l'image est ajustée à la valeur passée en argument par une multiplication de l'image par une constante déterminée à l'occasion.

add nom val

Fonction de traitement d'images. Ajoute l'image contenue dans le fichier nom à l'image courante, en ajoutant la constante val. L'extension du nom de fichier doit être présente.

add aster1.fit 0

sub nom val

Fonction de traitement d'images. Réalise la soustraction entre l'image courante et l'image nom, en ajoutant la constante val. Cette fonction peut servir en première approche à soustraire une image thermique ou une image d'offset. L'extension du nom de fichier doit être présente.

sub noir/noir30.fit 0

div nom val

Fonction de traitement d'images. Divise l'image courante par l'image contenue dans le fichier nom et multiplie par la constante numérique val.

div flat/flat.fit 1

opt noir offset

Fonction de traitement d'images. Soustrait la contribution thermique d'une image brute. Les deux paramètres à passer sont les noms des images de noir et d'offset. L'image de noir doit contenir l'offset, il s'agit par exemple d'une image acquise avec la caméra obturée (un noir), ou aussi d'une image médiane d'une série de noirs.

opt dark.fit bias.fit

deconvflat coef

Fonction de traitement d'images. Retire l'effet de smearing d'un image. Le coefficient coef correspond au rapport du temps de lecture d'une ligne par rapport a l'image entière.

deconvflat 0.0005

rot x0 y0 angle

Fonction de traitement d'images. Tourne l'image autour du point de coordonnées (x0,y0), d'un angle donné en degrés dans la commande. L'exemple suivant tourne une image autour du premier pixel dans le coin inférieur gauche de l'image, d'un angle de 10 degrés.

rot 1 1 10

log coef ?offset?

Fonction de traitement d'images. Applique une transformation logarithmique à l'image, c'est à dire que chaque pixel (intensité p) prend la valeur coef*log10(p-offset).

binx x1 y1 ?w?

Fonction de traitement d'images. Créé une nouvelle image dont la hauteur est celle de l'image originale et la largeur w (valeur par défaut = 20), et dont les pixels sont définis de la manière suivante : Les pixels de chaque ligne de l'image de départ, compris entre x1 et x2 sont sommés, et stockés dans la même ligne de l'image reconstituée. Ainsi tous les pixels d'une ligne de l'image reconstituée sont égaux. C'est une fonction d'analyse des images d'occultation par astéroïde, par la méthode de drift-scan.

biny y1 y2 ?h?

Fonction de traitement d'images. Créé une nouvelle image dont la largeur est celle de l'image originale et la hauteur h (valeur par défaut = 20), et dont les pixels sont définis de la manière suivante : Les pixels de chaque colonne de l'image de départ, compris entre y1 et y2 sont sommés, et stockés dans la même colonne de l'image reconstituée. Ainsi tous les pixels d'une colonne de l'image reconstituée sont égaux.

window ?coord?

Fonction de traitement d'images. Extrait une sous-fenêtre de l'image affichée, dont les coordonnées sont renvoyées par la fonction [ ::confVisu::getBox $visu ]. Par exemple pour extraire un objet entouré par la boîte de sélection dans la visu 1 : window [ ::confVisu::getBox 1 ].

mirrorx

Fonction de traitement d'images. Retourne l'image par un effet de miroir horizontal : Les pixels se situent sur une même ligne avant et après le traitement.

mirrorx

mirrory

Fonction de traitement d'images. Retourne l'image par un effet de miroir vertical : Les pixels se situent sur une même colonne avant et après le traitement.

mirrory

delete2 generic nb

Efface les nb fichiers dont le nom est generic suivi d'un nombre compris entre 1 et nb. Par exemple, "delete2 i 5" efface les images i1.fit à i5.fit

extract_flat in dark offset out nb

Fonction de traitement d'images. Extrait le flat directement des images. "extract_flat m57- noir offs flat 5" extrait le fichier flat des images m57-1.fit à m57-5.fit.

fitsdate

Renvoie la date courante sous le format normalisé utilisé par les fichiers FITS :

2000-10-05T00:11:44.00

YYYY-MM-DDThh:mm:ss.cs

dir ?regexp?

Liste le contenu d'un répertoire, telle la commande DOS. Par exemple pour lister les images du sous-répertoire nuit, il faut utiliser la commande "dir nuit/*.fit".