Name
hierarch28 - header conversion from ESO to standard FITS
Synopsis
hierarch28 [options] <FITS> [table]
Description
hierarch28 will convert keyword names in a FITS header to
new names, using a user-provided ASCII conversion table.
It is especially aimed at removing no-standard FITS fea-
tures, such as the HIERARCH ESO keyword names.
hierarch28 can also perform a translation to the IRAF con-
vention on the following four keywords: 'RA', 'DEC', 'UT'
and 'LST'. IRAF requires these keywords to contain the
string representation of their values, e.g.
RA = ' 09:45:14.594'
DEC = '-33:47:09.420'
UT = ' 01:17:21.950'
LST = ' 08:19:59.688'
The ESO standard (see http://archive.eso.org/dicb) defines
these keywords as floating point values with the units
degrees for RA/DEC and elapsed seconds since midnight for
UT/LST.
In order to have this tranlation performed, add
RA = RA
DEC = DEC
UTC = UT
LST = LST
to the conversion table.
Options
-g [instrument]
This option is used to generate default translation
tables. Provide the name of the instrument, or
nothing to generate a generic table. Supported
instruments for the moment are: WFI.
Example
Generate a generic translation table:
> hierarch28 -g
Generate a translation table for WFI:
> hierarch28 -g wfi
Files
hierarch28 expects a conversion table in input. Default
name for this table is table.conv in the current working
directory. Indicate another name for this file as last
argument on the command-line. This ASCII file contains a
list of keywords to replace, in the following format:
#
# Comment lines start with a hash '#'
# Blank lines would be ignored
#
OLDKEYWORD1 = NEWKEYWORD1
OLDKEYWORD2 = NEWKEYWORD2
etc.
Input keywords are character strings, they may contain
blanks. Example:
HIERARCH ESO DET DIT = DETDIT
One important restriction is that the new keyword name may
not be longer than the initial one. The program will com-
plain that it cannot achieve search and replace if this is
the case.
Important
This programs achieves maximal speed to operate because it
modifies the input file directly. Be aware that using
hierarch28 on a file will modify its contents in an irre-
versible way!