Date de mise à jour : 02 avril 2011
AudeLA : Petites fonctions d'usage universel
Fonctions basiques :
charge fichier ?options?
Chargement d'un fichier.
Options :
- -buf : spécifie le buffer monochrome dans lequel on charge l'image (par défaut, c'est le buffer Aud'ACE).
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension de l'image.
- -polyNo : spécifie le plan couleurs à charger (par défaut le 1er, qui est le seul disponible pour des images monochromes).
- -novisu : pas de rafraîchissement d'affichage pour le buffer Aud'ACE.
sauve fichier ?options?
Sauvegarde d'un fichier.
Options :
- -buf : spécifie le buffer monochrome à partir duquel on enregistre (par défaut, c'est le buffer Aud'ACE).
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension de l'image.
- -polyNo : spécifie le plan couleurs de sauvegarde (par défaut le 1er, qui est le seul utilisé pour des images monochromes).
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 :
- -rep : spécifie le répertoire de destination.
- -ext : extension de l'image (.jpg par défaut).
soustrait fichier ?options?
Soustraction d'une image sauvegardée sur disque à une image en mémoire tampon (buffer).
Options :
- -buf : spécifie le buffer monochrome de travail (par défaut, c'est le buffer Aud'ACE).
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension du fichier image auxiliaire.
- -polyNo
: spécifie le plan couleurs du fichier image auxiliaire à utiliser (par
défaut le 1er, qui est le seul utilisé pour des images monochromes).
normalise fichier ?options?
Normalisation d'une image en mémoire tampon (buffer) par une image sauvegardée sur disque.
Options :
- -buf : spécifie le buffer monochrome de travail (par défaut, c'est le buffer Aud'ACE).
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension du fichier image auxiliaire.
- -polyNo
: spécifie le plan couleurs du fichier image auxiliaire à utiliser (par
défaut le 1er, qui est le seul utilisé pour des images monochromes).
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 :
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension de la série d'images à effacer.
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 :
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension de la série.
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 :
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension de la série.
renumerote nom_generique ?options?
Renumérote la série "nom_generiquenombre" en "nom_generique1", "nom_generique_2", etc.
Options :
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension de la série d'images.
renomme ancien_nom_generique nouveau_nom_generique ?options?
Renomme la série "ancien_nom_generiquenombre" en "nouveau_nom_generiquenombre".
Options :
- -rep : spécifie le répertoire dans lequel travailler.
- -in_rep : spécifie le répertoire de la série initiale.
- -ex_rep : spécifie le répertoire de la série finale.
- -ext : extension de la série d'images.
- -in_ext : extension de la série d'images initiale.
- -ex_ext : extension de la série d'images finale.
copie ancien_nom_generique nouveau_nom_generique ?options?
Copie la série "ancien_nom_generiquenombre" en "nouveau_nom_generiquenombre".
Options :
- -rep : spécifie le répertoire dans lequel travailler.
- -in_rep : spécifie le répertoire de la série initiale.
- -ex_rep : spécifie le répertoire de la série finale.
- -ext : extension de la série d'images.
- -in_ext : extension de la série d'images initiale.
- -ex_ext : extension de la série d'images finale.
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 :
- -rep : spécifie le répertoire dans lequel travailler.
- -in_rep : spécifie le répertoire de la série initiale.
- -ex_rep : spécifie le répertoire de la série finale.
- -ext : extension de la série d'images.
- -in_ext : extension de la série d'images initiale.
- -ex_ext : extension de la série d'images finale.
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 :
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension de la série d'images à effacer.
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 :
- -rep : spécifie le répertoire dans lequel travailler.
- -in_rep : spécifie le répertoire de la série initiale.
- -ex_rep : spécifie le répertoire de la série finale.
- -ext : extension de la série d'images.
- -in_ext : extension de la série d'images initiale.
- -ex_ext : extension de la série d'images finale.
- -polyNo
: spécifie le plan couleurs sur lequel travailler (par défaut le 1er,
qui est le seul disponible pour des images monochromes).
- -in_polyNo : spécifie le plan couleurs de travail pour la série initiale.
- -ex_polyNo : spécifie le plan couleurs de travail pour la série finale.
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 :
- -rep : spécifie le répertoire dans lequel travailler.
- -in_rep : spécifie le répertoire de la série initiale.
- -ex_rep : spécifie le répertoire de la série finale.
- -ext : extension de la série d'images.
- -in_ext : extension de la série d'images initiale.
- -ex_ext : extension de la série d'images finale.
- -polyNo
: spécifie le plan couleurs sur lequel travailler (par défaut le 1er,
qui est le seul disponible pour des images monochromes).
- -in_polyNo : spécifie le plan couleurs de travail pour la série initiale.
- -ex_polyNo : spécifie le plan couleurs de travail pour la série finale.
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 :
- -rep : spécifie le répertoire dans lequel travailler.
- -in_rep : spécifie le répertoire de la série initiale.
- -ex_rep : spécifie le répertoire de la série finale.
- -ext : extension des fichiers..
- -in_ext : extension de la série d'images initiale.
- -ex_ext : extension de la série d'images finale.
- -polyNo
: spécifie le plan couleurs sur lequel travailler (par défaut le 1er,
qui est le seul disponible pour des images monochromes).
- -in_polyNo : spécifie le plan couleurs de travail pour la série initiale.
- -ex_polyNo : spécifie le plan couleurs de travail pour la série finale.
serie_trans in ex dx dy ?options?
Transformation d'une série d'images par translation.
Options :
- -rep : spécifie le répertoire dans lequel travailler.
- -in_rep : spécifie le répertoire de la série initiale.
- -ex_rep : spécifie le répertoire de la série finale.
- -ext : extension des fichiers..
- -in_ext : extension de la série d'images initiale.
- -ex_ext : extension de la série d'images finale.
- -polyNo
: spécifie le plan couleurs sur lequel travailler (par défaut le 1er,
qui est le seul disponible pour des images monochromes).
- -in_polyNo : spécifie le plan couleurs de travail pour la série initiale.
- -ex_polyNo : spécifie le plan couleurs de travail pour la série finale.
series_traligne liste_des_series_initiales serie_finale ?options?
Registration manuelle entre plusieurs séries d'images par translation et rotation.
Options :
- -rep : spécifie le répertoire dans lequel travailler.
- -in_rep : spécifie le répertoire de la série initiale.
- -ex_rep : spécifie le répertoire de la série finale.
- -ext : extension des fichiers.
- -in_polyNo : spécifie le plan couleurs de travail pour les séries initiales.
serie_sauvejpeg in ?options?
Conversion d'une série d'images au format jpeg.
Options :
- -ex_name : spécifie le nom de la série jpeg résultante (par défaut, on prend le nom de la série FITS initiale).
- -qualitejpeg : spécifie le niveau de qualité jpeg.
- -seuils_type : spécifie la manière de seuiller les images, au choix "loadima", "stat" ou "iris".
- -seuils_haut_bas : seuillage fixe (cette option prend donc 2 paramètres).
- -histo_haut_bas : seuillage en pourcentages de l'histogramme (cette option prend donc 2 paramètres).
- -rep : spécifie le répertoire dans lequel travailler.
- -in_rep : spécifie le répertoire de la série initiale.
- -ex_rep : spécifie le répertoire de la série finale.
- -in_ext : extension des fichiers FITS initiaux.
- -ex_ext : extension des fichiers jpeg finaux (par défaut, ".jpg").
- -in_polyNo : spécifie le plan couleurs de travail pour la série initiale.
mediane nom_generique ?options?
Renvoie l'image médiane de la série d'images d'entrée.
Options :
- -buf : spécifie le tampon image de sortie.
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension de la série d'images.
- -polyNo : spécifie le plan couleurs de travail pour la série initiale.
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 :
- -rep : spécifie le répertoire dans lequel travailler.
- -in_rep : spécifie le répertoire de la série initiale.
- -ex_rep : spécifie le répertoire de la série finale.
- -ext : extension des fichiers..
- -polyNo
: spécifie le plan couleurs sur lequel travailler (par défaut le 1er,
qui est le seul disponible pour des images monochromes).
- -in_polyNo : spécifie le plan couleurs de travail pour la série initiale.
- -ex_polyNo : spécifie le plan couleurs de travail pour la série finale.
- -buf : spécifie le tampon image qui contient l'image à soustraire.
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 :
- -rep : spécifie le répertoire dans lequel travailler.
- -in_rep : spécifie le répertoire de la série initiale.
- -ex_rep : spécifie le répertoire de la série finale.
- -ext : extension des fichiers..
- -polyNo
: spécifie le plan couleurs sur lequel travailler (par défaut le 1er,
qui est le seul disponible pour des images monochromes).
- -in_polyNo : spécifie le plan couleurs de travail pour la série initiale.
- -ex_polyNo : spécifie le plan couleurs de travail pour la série finale.
- -buf : spécifie le tampon image qui contient l'image à soustraire.
normalise_gain in ex ?options?
Normalisation du gain d'une série d'images.
Options :
- -rep : spécifie le répertoire dans lequel travailler.
- -in_rep : spécifie le répertoire de la série initiale.
- -ex_rep : spécifie le répertoire de la série finale.
- -ext : extension des fichiers..
- -polyNo
: spécifie le plan couleurs sur lequel travailler (par défaut le 1er,
qui est le seul disponible pour des images monochromes).
- -in_polyNo : spécifie le plan couleurs de travail pour la série initiale.
- -ex_polyNo : spécifie le plan couleurs de travail pour la série finale.
aligne in ex ?options?
Alignement (registration) par translation d'une série d'images.
Options :
- -rep : spécifie le répertoire dans lequel travailler.
- -in_rep : spécifie le répertoire de la série initiale.
- -ex_rep : spécifie le répertoire de la série finale.
- -ext : extension des fichiers..
- -polyNo
: spécifie le plan couleurs sur lequel travailler (par défaut le 1er,
qui est le seul disponible pour des images monochromes).
- -in_polyNo : spécifie le plan couleurs de travail pour la série initiale.
- -ex_polyNo : spécifie le plan couleurs de travail pour la série finale.
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".
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 :
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension de la série d'images.
liste_series ?options?
Renvoie une liste constituée des noms de séries du répertoire courant.
Options :
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension de la série d'images.
liste_sousreps ?options?
Renvoie une liste constituée des noms des sous-répertoires du répertoire courant.
Options :
- -rep : spécifie le répertoire dans lequel travailler.
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 :
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension de la série d'images.
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 :
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension de la série d'images.
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 :
- -rep : spécifie le répertoire dans lequel travailler.
- -ext : extension des séries d'images.
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 :
- -nom_base : spécifie la forme du nom du sous-répertoire.
- -rep : permet de spécifier un autre répertoire que le répertoire image pour créer le sous-dossier temporaire.
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 :
- -nom_base : spécifie la forme du nom du sous-répertoire.
- -rep : permet de spécifier un autre répertoire que le répertoire image pour créer le sous-dossier temporaire.
- -ext : extension du fichier. Par défaut le fichier est créé sans extension.
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.