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!