Date de mise à jour : 02 avril 2011

AudeLA : Petites fonctions d'usage universel

Fonctions basiques :

charge fichier ?options?

Chargement d'un fichier.

Options :

sauve fichier ?options?

Sauvegarde d'un fichier.

Options :

sauve_jpeg fichier ?options?

Sauvegarde au format jpeg de l'image Aud'ACE ; les réglages d'affichage (palette, fonction de transfert, seuils) sont pris en compte.

Options :

soustrait fichier ?options?

Soustraction d'une image sauvegardée sur disque à une image en mémoire tampon (buffer).

Options :

normalise fichier ?options?

Normalisation d'une image en mémoire tampon (buffer) par une image sauvegardée sur disque.

Options :

Fonctions de séries:

suppr_serie nom_generique ?options?

Suppression des fichiers de type "nom_generique1", "nom_generique2", etc.
Par défaut la fonction cherche à supprimer les fichiers FITS d'extension par défaut placés dans le répertoire images Aud'ACE.

Options :

suppr_fin_serie nom_generique index_fin ?options?

Suppression de la fin d'une série (fichiers dont l'index est strictement supérieur à "index_fin").

Options :

suppr_debut_serie nom_generique index_debut ?options?

Suppression du début d'une série (fichiers dont l'index est strictement inférieur à "index_debut").

Options :

renumerote nom_generique ?options?

Renumérote la série "nom_generiquenombre" en "nom_generique1", "nom_generique_2", etc.

Options :

renomme ancien_nom_generique nouveau_nom_generique ?options?

Renomme la série "ancien_nom_generiquenombre" en "nouveau_nom_generiquenombre".

Options :

copie ancien_nom_generique nouveau_nom_generique ?options?

Copie la série "ancien_nom_generiquenombre" en "nouveau_nom_generiquenombre".

Options :

copie_partielle ancien_nom_generique nouveau_nom_generique debut fin ?options?

Copie du "debut"ième fichier au "fin"ième fichier de la série "ancien_nom_generiquenombre", en "nouveau_nom_generiquenombre".

Options :

serie_charge nom_generique ?options?

Chargement d'une série d'images. La fonction renvoie la liste des tampons images créés, qui contiennent les images chargées.

Options :

serie_fenetre in ex coord ?options?

Fenêtrage d'une série de fichiers. La série résultante est "ex". "coord" est une liste des coordonnées de 2 coins extrêmes de la zone de fenêtrage.

Options :

souris_fenetre in ex ?options?

Idem serie_fenetre sauf que les coordonnées de la fenêtre sont à faire préalablement à la souris sur l'image Aud'ACE.

Options :

serie_rot in ex x0 y0 angle ?options?

Transformation d'une série d'images par rotation d'angle "angle" et de centre ("x0", "y0").

Options :

serie_trans in ex dx dy ?options?

Transformation d'une série d'images par translation.

Options :

series_traligne liste_des_series_initiales serie_finale ?options?

Registration manuelle entre plusieurs séries d'images par translation et rotation.

Options :

serie_sauvejpeg in ?options?

Conversion d'une série d'images au format jpeg.

Options :

mediane nom_generique ?options?

Renvoie l'image médiane de la série d'images d'entrée.

Options :

serie_soustrait in ex ?options?

Soustraction de l'image contenue dans le tampon mémoire spécifié (par défaut, l'image affichée dans Aud'ACE) à une série d'images.

Options :

serie_normalise in ex ?options?

Normalisation par l'image contenue dans le tampon mémoire spécifié (par défaut, l'image affichée dans Aud'ACE) d'une série d'images.

Options :

normalise_gain in ex ?options?

Normalisation du gain d'une série d'images.

Options :

aligne in ex ?options?

Alignement (registration) par translation d'une série d'images.

Options :

Fonctions avancées:

TestEntier nombre

La procédure retourne "1" si le nombre est entier, "0" sinon.

TestReel nombre

La procédure retourne "1" si le nombre est réel, "0" sinon.

dernier_est_chiffre mot

La procédure retourne "1" si le dernier caractère du mot est un chiffre, "0" sinon.

nom_valide nom_complet_fichier

La procédure retourne "1" si le nom de fichier ou le chemin ne comportent pas de caractères accentués, "0" sinon. Dans ce dernier cas, il sera impossible de charger le fichier FITS...

suppr_accents mot

La procédure retourne le mot dépouillé de tous ses accents. Par exemple, "àlârvôàyêre" est transformé en "alarvoayere".

decomp fichier

A tout nom de fichier (avec ou sans le chemin) cette procédure renvoie une liste à 5 éléments : [dossier nom_generique index extension compression].

NB : "compression" peut valoir "", ".gz" ou ".bz2".

liste_index nom_generique ?options?

Renvoie une liste constituée des index de la série "nom_generiquenombre"

Options :

liste_series ?options?

Renvoie une liste constituée des noms de séries du répertoire courant.

Options :

liste_sousreps ?options?

Renvoie une liste constituée des noms des sous-répertoires du répertoire courant.

Options :

serie_existe nom_generique ?options?

Renvoie "1" si la série existe, sinon "0" en affichant un message décrivant l'erreur dans la console.

Options :

numerotation_usuelle nom_generique ?options?

Renvoie "1" si la série est correctement numérotée ("nom_generique1", "nom_generique2", etc.), et "0" sinon. Ce dernier cas peut se produire si la série est incomplète, ou bien si elle est numérotée avec intercalement de zéros (par exemple en 0001, 0002, ...).

Options :

compare_index_series liste_noms_generiques ?options?

Renvoie "1" si toutes les séries ont les mêmes index, et "0" sinon.

Cette fonction est par exemple utilisée pour s'assurer que plusieurs séries monochromes peuvent être combinées en une série polychrome.

Options :

cree_sousrep ?options?

Création d'un sous-dossier temporaire dans le répertoire images (ou autre répertoire en utilisant l'option -rep). Le script cherche un nom de dossier qui ne soit pas existant et renvoie le chemin complet du dossier créé.
Par défaut, le nom du sous-dossier créé sera de la forme "tmp_1", ou "tmp_2", etc. Ceci est paramétrable par l'option -nom_base.

Cette fonction est particulièrement utile pour stocker des fichiers temporaires dans un répertoire initialement vierge, ce qui évite tout écrasement accidentel de fichiers.

Options :

cree_fichier ?options?

Création d'un fichier vide dans le répertoire images (ou autre répertoire en utilisant l'option -rep). Le script cherche un nom de fichier qui ne soit pas existant et renvoie le chemin complet du fichier vide créé.

Par défaut, le nom du fichier créé sera de la forme "tmp_1", ou "tmp_2", etc. Ceci est paramétrable par l'option -nom_base.

Options :

syntaxe_args liste_opts_averifier nb_args_obligatoires nb_args_optionnels liste_options_valides

Cette fonction est destinée à tester la validité d'une liste d'arguments. "liste_options_valides" est la liste des options valides (mettre en 1er élément la liste des options ne requérant pas de paramètre, en second celle des options requérant un paramètre, etc). Les options sont supposées commencer par un tiret.

La fonction retourne la valeur 1 si la liste d'arguments est valide, 0 sinon. Dans le cas où ce sont les options qui posent problème, on affiche dans la console des détails sur l'option invalide.

range_options liste_options

Cette fonction permet de trier une liste d'options : elle renvoie une liste composée de plusieurs sous-listes : la première comprend les arguments optionnels, la seconde les options sans paramètre, la troisième les options avec un paramètre (les éléments sont des sous-listes de longueur 2 (option et paramètre associé)), etc.

calcul_trzaligne liste1 liste2

"liste1" et "liste2" sont deux listes à 4 éléments comportant chacune les coordonnées de 2 points, sous la forme { x1 y1 x2 y2 }. Par exemple les coordonnées d'une boîte faite à la souris sur une image sont renvoyées par la fonction [ ::confVisu::getBox $visu ] sous cette forme.

La fonction calcul_trzaligne permet le calcul des paramètres permettant par translation, rotation et zoom de ramener les points de "liste2" au plus près des points de "liste1". La fonction renvoie une liste à 6 éléments qui sont dans l'ordre : la translation à effectuer en x, la translation à effectuer en y, l'abscisse et l'ordonnée du centre pour la rotation, l'angle de la rotation en degrés, le facteur de zoom.

date_chiffresAlettres date_chiffres

L'argument est une liste de 3 éléments sous la forme {année mois jour}. La fonction renvoie une chaîne de caractères correspondant à la date en français, par exemple 11 août 1999.

lmin liste

Renvoie le minimum d'une liste de nombre.

lmax liste

Renvoie le maximum d'une liste de nombre.