mImgtbl - Online in de cloud

PROGRAMMA:

NAAM

mImgtbl - Genereer metadata van een set FITS-afbeeldingen

KORTE INHOUD

mImgtbl [-rcadb] [-s statusbestand] [-F veldlijstbestand] [-T imglijst] map images.tbl

PRODUCTBESCHRIJVING

mImgtbl extraheert de geometrie-informatie van de FITS-header uit een set bestanden en maakt een
ASCII-beeldmetadatatabel die door verschillende andere programma's wordt gebruikt. Het alleen
verzamelt gegevens van headers die voldoen aan de FITS-standaard, maar rapporteert een telling van
afbeeldingen die niet door die controle komen.

OPTIES

-r mImgtbl kan ook worden gebruikt als een op zichzelf staand programma om metadata van afbeeldingen te verzamelen voor andere
doeleinden (om een ​​database te vullen, als basis voor zoekopdrachten naar ruimtelijke dekking, enz.)
In dit geval is het vaak wenselijk om informatie te verzamelen over alle bestanden in een
mappenboom recursief. De "-r" (recursieve) vlag instrueert mImgtbl te kunnen zoeken
de gegeven map en al zijn submappen recursief.

-c De optie "-c" (hoeken) in mImgtbl zorgt ervoor dat er acht extra kolommen worden toegevoegd
de output-metadatatabel met de RA, Dec-coördinaten (ra1, dec1, ... ra4,
dec4) van de afbeeldingshoeken. De uitvoer is altijd Equatoriaal J2000, zelfs als de
invoer is een ander systeem. Hoewel dit niet vereist is voor de kernverwerkingsmodules, hebben we
raden aan om deze optie te gebruiken, aangezien sommige nutsvoorzieningen mogelijk hoeklocaties vereisen
om goed te functioneren.

-C De originele versie van mImgtbl negeerde de kubusstructuur in de bestanden; het zag er alleen maar uit
bij de eerste twee dimensies en bijbehorende WCS-parameters. Bij kubusverwerking
werd toegevoegd aan Montage, was het nodig om de derde en vierde dimensie te onderzoeken
(als ze bestaan) en dus zijn er enkele extra kolommen toegevoegd aan de mImgtbl-uitvoer
(bv NAXIS4, CRVAL3). Het is nog vaak zo dat het allemaal nieuwe kolommen zijn
zou leeg zijn, dus om ruimte te besparen kan de uitvoer in de oude modus worden aangeroepen met behulp van de "-C"
(geen kubus) optie. Dit is grotendeels cosmetisch, aangezien de "vierdimensionale"
uitvoer is perfect geschikt voor verdere verwerking van 2D-gegevens.

-a Standaard negeert mImgtbl FITS-bestanden met namen die eindigen op _Oppervlakte (d.w.z
naam_gebied.fits), ervan uitgaande dat het door Montage gemaakte gebiedsafbeeldingen zijn. Als je wilt
genereer informatie over deze afbeeldingen, of als u afbeeldingen hebt met _Oppervlakte in de titel
anders neem contact die zijn gegenereerd door Montage, moet u deze vlag inschakelen om te forceren
mImgtbl om alle afbeeldingen in de map te bekijken.

-d Foutopsporing inschakelen

-b Wanneer deze schakelaar is ingesteld, mImgtbl zal elk gevonden FITS-bestand expliciet uitvoeren
die niet geldig lijkt te zijn, samen met informatie over de fout.

-s statusbestand
Uitvoer en fouten worden geschreven naar statusbestand in plaats van naar stdout te worden geschreven.

-f veldlijstbestand
Wordt gebruikt om een ​​op te geven veldlijst, die extra trefwoorden zal vermelden waaruit kan worden gelezen
de FITS-headers en opgenomen in de uitvoertabel. Veldlijsten moeten de
trefwoordnaam, type (int,char,double) en grootte. Voorbeeld: voorbeeld.veldlijst.

-t imglijst
mImgtbl zal alleen bestanden verwerken met namen gespecificeerd in tabel imglijst, het negeren van eventuele
andere bestanden in de map. Voorbeeld: voorbeeld.imglist.

ARGUMENTEN

directory
Pad naar de map die een set FITS-invoerbestanden bevat.

afbeeldingen.tbl
Pad van tabel met uitvoermetagegevens.

RESULTAAT

Uitvoertabel bevat metadata-informatie van alle leesbare FITS-bestanden in de map
gespecificeerd door directory. tellen is het aantal records in de tabel, en slecht passen is de
aantal bestanden waarvoor FITS-metagegevens niet konden worden geëxtraheerd.

OUTPUT COLUMNS

cntr Een unieke teller (rijnummer)

ra,dec Afbeeldingspositie in decimale graden-indeling

cra,cdec
Rechte klimming in HMMMSS.SS-formaat. Declinatie in DDMMSS.S-formaat

naxis1, naxis2
De grootte van de afbeelding in pixels voor de afmetingen 1 en 2

ctype1, ctype2
Het coördinatensysteem (de eerste vier tekens) en WCS-kaartprojectie (laatste
drie tekens) voor dimensies 1 en 2

crpix1, crpix2
De pixelcoördinaten van de referentielocatie (kan fractioneel zijn en kan uit zijn)
de afbeelding) voor afmetingen 1 en 2

crval1, crval2
De coördinaten van een referentielocatie aan de hemel (vaak in het midden van de
afbeelding) voor afmetingen 1 en 2

cdelt1, cdelt2
De pixelschaal (in graden aan de hemel per pixel) op de referentielocatie voor
afmetingen 1 en 2

crota2 De rotatiehoek van de "omhoog" richting naar de hemelpool

nachtevening
Precessiejaar geassocieerd met het coördinatensysteem

hdu Numerieke identifier voor de FITS-extensie waaruit de afbeeldingsinformatie is geëxtraheerd,
voor FITS-bestanden met meerdere HDU's.

grootte Bestandsgrootte (in bytes) van het FITS-invoerbestand

fname Het pad naar het FITS-invoerbestand

BERICHTEN

OK [struct stat="OK", count=tellen, slechte pasvormen=slecht passen]

FOUT Illegaal argument: -arg

ERROR Kan statusbestand niet openen: statusbestand

ERROR Kan veldlijstbestand niet openen: veldlijstbestand

ERROR Kan bestand met afbeeldingslijst niet openen: imgbestand

ERROR Afbeeldingstabel heeft kolom fnaam/bestand nodig

ERROR Ongeldige veldnaam: snaar]

ERROR Ongeldig veldtype: snaar]

FOUT Geen toegang directory

FOUT directory is geen map

ERROR Kan uitvoertabel niet openen.

FOUT Kan kopieertabel niet openen.

FOUT Kan tmp (in) tabel niet openen.

FOUT Kan tmp (out) table niet openen.

FOUT Kan de finaletafel niet openen.

FOUT PAST BIJ bibliotheek fout

Voorbeelden

Het volgende voorbeeld wordt uitgevoerd mImgtbl op een map met 14 2MASS-afbeeldingen:

$ mImgtbl-invoer/2massa-afbeeldingen.tbl
[struct stat="OK", count=14, badfits=0]

Output: afbeeldingen.tbl.

Hardlopen mImgtbl op een map die 3 slechte FITS-afbeeldingen bevat, met de schakelaar -c aan:

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

Het uitvoerbestand is identiek aan het eerste voorbeeld, maar met de toevoeging van 8 "hoeken"
kolommen: afbeeldingen-hoeken.tbl. De slecht passen teller in het uitvoerbericht rapporteert over hoe
er zijn veel afbeeldingen gevonden met ongeldige koptekstinformatie.

Wanneer een veldlijstbestand zoals dit voorbeeld wordt doorgegeven, worden extra kolommen uit het FITS gehaald
headers en ingevoegd in de tabel:

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

Het uitvoerbestand heeft extra kolommen zoals gespecificeerd: afbeeldingen-uitgevouwen.tbl.

Gebruik mImgtbl online met behulp van onworks.net-services