mImgtbl - En ligne dans le Cloud

PROGRAMME:

Nom

mImgtbl - Générer des métadonnées à partir d'un ensemble d'images FITS

SYNOPSIS

mImgtbl [-rcadb] [-s fichier d'état] [-F fichierlistechamps] [-t liste imglist] répertoire images.tbl

DESCRIPTION

mImmgtbl extrait les informations de géométrie d'en-tête FITS à partir d'un ensemble de fichiers et crée un
Table de métadonnées d'image ASCII utilisée par plusieurs autres programmes. C'est seulement
collecte des données à partir d'en-têtes conformes à la norme FITS, mais rapporte un nombre de
images qui échouent à cette vérification.

OPTIONS

-r mImmgtbl peut également être utilisé comme programme autonome pour collecter des métadonnées d'image pour d'autres
fins (pour alimenter une base de données, comme base pour des recherches de couverture spatiale, etc.)
Dans ce cas, il est souvent souhaitable de collecter des informations sur tous les fichiers d'un
arborescence de répertoires récursivement. Le drapeau "-r" (récursif) indique mImmgtbl à la recherche
le répertoire donné et tous ses sous-répertoires de manière récursive.

-c L'option "-c" (coins) dans mImgtbl entraînera l'ajout de huit colonnes supplémentaires à
la table de métadonnées de sortie contenant les coordonnées RA, Dec (ra1, dec1, ... ra4,
dec4) des coins de l'image. La sortie est toujours Equatorial J2000, même si le
l'entrée est un autre système. Bien que cela ne soit pas requis pour les modules de traitement de base, nous
recommandons d'utiliser cette option, car certains des utilitaires peuvent nécessiter des emplacements de coin
pour fonctionner correctement.

-C La version originale de mImgtbl ignorait la structure du cube dans les fichiers ; il a seulement regardé
aux deux premières dimensions et aux paramètres WCS associés. Lors du traitement des cubes
a été ajouté à Montage, il a fallu examiner les troisième et quatrième dimensions
(si elles existent) et donc des colonnes supplémentaires ont été ajoutées à la sortie mImgtbl
(par exemple : NAXIS4, CRVAL3). C'est encore souvent le cas où toutes les nouvelles colonnes
serait vide, donc pour économiser de l'espace, la sortie de l'ancien mode peut être invoquée à l'aide du "-C"
option (sans cube). C'est cosmétique pour la plupart, puisque le "quatre dimensions"
la sortie est parfaitement valable pour un traitement ultérieur des données 2D.

-a Par défaut, mImgtbl ignore les fichiers FITS dont les noms se terminent par _Région (c'est à dire
nom_zone.fits), en supposant qu'il s'agit d'images de zone créées par le Montage. Si tu veux
générer des informations sur ces images, ou si vous avez des images avec _Région dans le titre
autre que ceux générés par Montage, vous devez activer ce drapeau pour forcer
mImmgtbl pour regarder toutes les images du répertoire.

-d Activer le débogage

-b Lorsque ce commutateur est activé, mImmgtbl affichera explicitement chaque fichier FITS qu'il trouve
qui ne semble pas valide, ainsi que des informations sur l'erreur.

-s fichier d'état
La sortie et les erreurs sont écrites dans fichier d'état au lieu d'être écrit sur stdout.

-f fichierlistechamps
Utilisé pour spécifier un liste de champ, qui répertoriera les mots-clés supplémentaires à lire
les en-têtes FITS et inclus dans le tableau de sortie. Les listes de champs doivent spécifier le
nom du mot-clé, type (int, char, double) et taille. Exemple : example.fieldlist.

-t liste imglist
mImmgtbl ne traitera que les fichiers dont les noms sont spécifiés dans le tableau liste imglist, en ignorant tout
autres fichiers du répertoire. Exemple : exemple.imglist.

ARGUMENTS

annuaire
Chemin d'accès au répertoire contenant l'ensemble des fichiers FITS d'entrée.

images.tbl
Chemin de la table de métadonnées de sortie.

ENTRAÎNER

La table de sortie contient des informations sur les métadonnées de tous les fichiers FITS lisibles dans le répertoire
spécifié par annuaire. compter est le nombre d'enregistrements dans la table, et mauvais ajustement est
nombre de fichiers pour lesquels les métadonnées FITS n'ont pas pu être extraites.

SORTIE COLONNES

cntr Un compteur unique (numéro de ligne)

ra,dec Position de l'image au format degré décimal

cra,cdec
Ascension droite au format HHMMSS.SS. Déclinaison au format DDMMSS.S

naxis1, naxis2
La taille de l'image en pixels pour les dimensions 1 et 2

ctype1, ctype2
Le système de coordonnées (les quatre premiers caractères) et la projection cartographique WCS (le dernier
trois caractères) pour les dimensions 1 et 2

crpix1, crpix2
Les coordonnées en pixels de l'emplacement de référence (peuvent être fractionnaires et peuvent être désactivées
l'image) pour les dimensions 1 et 2

crval1, crval2
Les coordonnées d'un emplacement de référence dans le ciel (souvent au centre du
image) pour les dimensions 1 et 2

cdelt1, cdelt2
L'échelle de pixels (en degrés sur le ciel par pixel) à l'emplacement de référence pour
cotes 1 et 2

crota2 L'angle de rotation de la direction "haut" vers le pôle céleste

équinoxe
Année de précession associée au système de coordonnées

hdu Identifiant numérique de l'extension FITS dont les informations sur l'image sont extraites,
pour les fichiers FITS avec plusieurs HDU.

size Taille du fichier (en octets) du fichier FITS d'entrée

fname Le chemin d'accès au fichier FITS d'entrée

MESSAGES

OK [struct stat="OK", count=compter, mauvais ajustement=mauvais ajustement]

ERREUR Argument illégal : -arg

ERREUR Impossible d'ouvrir le fichier d'état : fichier d'état

ERREUR Impossible d'ouvrir le fichier de liste de champs : fichierlistechamps

ERREUR Impossible d'ouvrir le fichier de liste d'images : fichier img

ERREUR La table d'images a besoin de la colonne fname/file

ERREUR Nom de champ illégal : un magnifique]

ERREUR Type de champ illégal : un magnifique]

ERREUR Impossible d'accéder annuaire

ERREUR annuaire n'est pas un répertoire

ERREUR Impossible d'ouvrir la table de sortie.

ERREUR Impossible d'ouvrir la table de copie.

ERREUR Impossible d'ouvrir la table tmp (in).

ERREUR Impossible d'ouvrir la table tmp (out).

ERREUR Impossible d'ouvrir la table finale.

ERREUR FITS bibliothèque erreur

EXEMPLES

L'exemple suivant s'exécute mImmgtbl sur un répertoire contenant 14 images 2MASS :

$ mImgtbl entrée/2mass images.tbl
[struct stat="OK", count=14, badfits=0]

Sortie : images.tbl.

Fonctionnement mImmgtbl sur un répertoire qui contient 3 mauvaises images FITS, avec le commutateur -c activé :

$ mImgtbl -c input/2mass-bad images-corners.tbl
[struct stat="OK", count=14, badfits=3]

Le fichier de sortie est identique au premier exemple, mais avec l'ajout de 8 "coins"
colonnes: images-corners.tblL’ mauvais ajustement compteur dans le message de sortie indique comment
de nombreuses images ont été trouvées contenant des informations d'en-tête invalides.

Lorsqu'un fichier de liste de champs comme cet exemple est transmis, des colonnes supplémentaires sont extraites du FITS
en-têtes et insérés dans le tableau :

$ mImgtbl -f exemple.fieldlist input/2mass images-expanded.tbl
[struct stat="OK", count=14, badfits=0]

Le fichier de sortie a des colonnes supplémentaires comme spécifié : images-expanded.tbl.

Utilisez mImgtbl en ligne en utilisant les services onworks.net