This is the command mHdrtbl that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator
mHdrtbl - Generate metadata from a set of header files
mHdrtbl [-rcdb] [-s statusfile] [-t imglist] directory images.tbl
mHdrtbl operates in a fashion similar to mImgtbl, but is used on a set of header template
files instead of FITS images.
-r mHdrtbl can also be used as a standalone program to gather image metadata for other
purposes (to populate a database, as a basis for spatial coverage searches, etc.)
In this case it is often desirable to collect information on all the files in a
directory tree recursively. The "-r" (recursive) flag instructs mHdrtbl to search
the given directory and all its subdirectories recursively.
-c The "-c" (corners) option in mHdrtbl will cause eight extra columns to be added to
the output metadata table containing the RA, Dec coordinates (ra1, dec1, ... ra4,
dec4) of the image corners. The output is always Equatorial J2000, even if the
input is some other system. This has been done to make the metadata uniform so
that it can easily be used for coverage searches, etc. The "-c" option is not
needed for normal Montage processing.
-d Turn on debugging
-b When this switch is set, mHdrtbl will explicitly output each header file it finds
that does not appear to be valid, along with information on the error.
Output and errors are written to statusfile instead of being written to stdout.
mHdrtbl will only process files with names specified in table imglist, ignoring any
other files in the directory. Example: example.imglist.
Path to directory containing set of input header templates.
Path of output metadata table.
Output table contains metadata information from all readable header templates in the
directory specified by directory. count is the number of records in the table, and
badhdrs is the number of files for which FITS/WCS metadata could not be extracted.
cntr A unique counter (row number)
ra,dec Image position in decimal degree format
Right ascension in HHMMSS.SS format. Declination in DDMMSS.S format
The size of the image in pixels for dimensions 1 and 2
The coordinate system (the first four characters) and WCS map projection (last
three characters) for dimensions 1 and 2
The pixel coordinates of the reference location (can be fractional and can be off
the image) for dimensions 1 and 2
The coordinates of a reference location on the sky (often at the center of the
image) for dimensions 1 and 2
The pixel scale (in degrees on the sky per pixel) at the reference location for
dimensions 1 and 2
crota2 The rotation angle from the "up" direction to the celestial pole
Precessional year associated with the coordinate system
hdu Numerical identifier for the FITS extension that the image info is extracted from,
for FITS files with multiple HDUs.
size Filesize (in bytes) of the input FITS file
fname The path to the input FITS file
OK [struct stat="OK", count=count, badfits=badfits]
ERROR Illegal argument: -arg
ERROR Cannot open status file: statusfile
ERROR Cannot open field list file: fieldlistfile
ERROR Cannot open image list file: imgfile
ERROR Image table needs column fname/file
ERROR Illegal field name: string]
ERROR Illegal field type: string]
ERROR Cannot access directory
ERROR directory is not a directory
ERROR Can't open output table.
ERROR Can't open copy table.
ERROR Can't open tmp (in) table.
ERROR Can't open tmp (out) table.
ERROR Can't open final table.
ERROR FITS library error
The following example runs mHdrtbl on a directory containing header templates stripped
from 14 2MASS images:
$ mHdrtbl input/2mass headers.tbl
[struct stat="OK", count=14, badfits=0]
Use mHdrtbl online using onworks.net services