Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sethead(1) [debian man page]

sethead(1)						      General Commands Manual							sethead(1)

Name
       sethead - Set FITS or IRAF header keyword values

Synopsis
       sethead [-dknv][r letter] <FITS or IRAF file> kw1=val1 kw2=val2 ... kwn=valuen

Description
       Set parameters in the header of a FITS or IRAF image.  If the keywords do not already exist, they are added at the end of the header.  Val-
       ues are assumed to be numeric if they contain no alphabetic characters and right-aligned.  Otherwise they are left-aligned after the equals
       sign,  and padded by spaces to a minimum of 8 characters.  To set keywords in a list of files, substitute @<listfile> for the file names on
       the command line.  To set a lot of keywords, put them, one per line, in a file and substitute @<keylistfile> on the command line.  If two @
       commands  are  present,	the  program  will figure out which contains file names and which contains keywords.  Lines in a keyword list file
       which do not contain an = are ignored.

Options
       -h     Write HISTORY line into output header with sethead version, current date and time, and names of keywords set.

       -k     Write SETHEAD keyword into output header with sethead version, current date and time, and names of keywords set.	If a SETHEAD  key-
	      word already exists, move the old value to a HISTORY line before writing the new value

       -n     Write a new file with an added "e" before the extension.

       -r letter
	      Rename  existing keywords whose values are being reset by prepending the character "letter".  Drop the last character if the changed
	      keyword is already 8 characters long.

       -v     Print confirmations of each parameter setting

Web Page
       http://tdc-www.harvard.edu/software/wcstools/sethead.html

Author
       Doug Mink, SAO (dmink@cfa.harvard.edu)

6 July 2001							     WCSTools								sethead(1)

Check Out this Related Man Page

hierarch28(1)						      General Commands Manual						     hierarch28(1)

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)
Man Page