Man Linux: Main Page and Category List

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  features, such as the HIERARCH ESO keyword
       names.

       hierarch28 can also perform a translation to the IRAF convention 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 translation performed, add
       RA = RA
       DEC = DEC
       UT = UT
       LST = LST
       to the conversion table.

OPTIONS

       -g     This option is used to generate default translation tables.

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 complain 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 irreversible way!

                                  29 May 2000                    hierarch28(1)