1hierarch28(1)               General Commands Manual              hierarch28(1)
2
3
4

NAME

6       hierarch28 - header conversion from ESO to standard FITS
7

SYNOPSIS

9       hierarch28 [options] <FITS> [table]
10

DESCRIPTION

12       hierarch28  will  convert  keyword names in a FITS header to new names,
13       using a user-provided ASCII conversion table. It is especially aimed at
14       removing  no-standard  FITS  features, such as the HIERARCH ESO keyword
15       names.
16
17       hierarch28 can also perform a translation to the IRAF convention on the
18       following  four  keywords:  'RA',  'DEC', 'UT' and 'LST'. IRAF requires
19       these keywords to contain the string representation  of  their  values,
20       e.g.
21       RA      = ' 09:45:14.594'
22       DEC     = '-33:47:09.420'
23       UT      = ' 01:17:21.950'
24       LST     = ' 08:19:59.688'
25
26       The  ESO  standard (see http://archive.eso.org/dicb) defines these key‐
27       words as floating point values with the units degrees  for  RA/DEC  and
28       elapsed seconds since midnight for UT/LST.
29
30       In order to have this translation performed, add
31       RA = RA
32       DEC = DEC
33       UT = UT
34       LST = LST
35       to the conversion table.
36

OPTIONS

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

FILES

41       hierarch28  expects  a conversion table in input. Default name for this
42       table is table.conv in the current working directory. Indicate  another
43       name  for  this  file  as last argument on the command-line. This ASCII
44       file contains a list of keywords to replace, in the following format:
45
46       #
47       # Comment lines start with a hash '#'
48       # Blank lines would be ignored
49       #
50       OLDKEYWORD1 = NEWKEYWORD1
51       OLDKEYWORD2 = NEWKEYWORD2
52       etc.
53
54       Input keywords are character strings, they may contain blanks. Example:
55
56       HIERARCH ESO DET DIT = DETDIT
57
58       One important restriction is that the  new  keyword  name  may  not  be
59       longer  than  the initial one. The program will complain that it cannot
60       achieve search and replace if this is the case.
61

IMPORTANT

63       This programs achieves maximal speed to operate because it modifies the
64       input file directly. Be aware that using hierarch28 on a file will mod‐
65       ify its contents in an irreversible way!
66
67
68
69                                  29 May 2000                    hierarch28(1)