sethead
Examples

1. Print Usage Instructions

Print basic instructions for use of this program by typing only the program name. 
$ sethead
SETHEAD 2.5, 1 September 1998, Doug Mink, SAO
Set FITS or IRAF header keyword values
Usage: [-nhkv] file1.fits [... filen.fits] kw1=val1 [ ... kwn=valuen]
Usage: [-nhkv] @listfile kw1=val1 [ ... kwn=valuen]
  -h: Write HISTORY line
  -k: Write SETHEAD keyword
  -n: Write a new file (add e before the extension)
  -r: Rename reset keywords with prefix following
  -v: Verbose
$

2. Single File, Verbose Mode

Change the right ascension and declination of a FITS image to a different epoch.
Before: 
...
RA      = '9:51:19.45'         /MEAN RA
DEC     = '69:15:26.42'        /MEAN DEC
EPOCH   = 1950                 /MEAN EPOCH
...

$ sethead -nvkr X ra='09:55:25.177' dec='+69:01:13.72' epoch=J2000 test.fts
SETHEAD 2.5, 1 September 1998, Doug Mink, SAO
Set Header Parameter Values in FITS image file test.fts
ra = 09:55:25.177
DEC = +69:01:13.72
EPOCH = 2000
teste.fts: rewritten successfully.
After: 
...
XRA     = '9:51:19.45'         /MEAN RA
XDEC    = '69:15:26.42'        /MEAN DEC
XEPOCH  = 1950                 /MEAN EPOCH
...
RA      = '09:55:25.177'
DEC     = '+69:01:13.72'
EPOCH   =                 2000
GETHEAD = 'SETHEAD 2.5 1998-09-01 13:31 RA, DEC, EPOCH updated'
END

3. Update date value to post-Y2K FITS standard

Change the old FITS format observation date in a FITS image to Y2K FITS ISO 8601.
Before: 
...
DATE-OBS= '21/10/95'           /UT DD/MM/YY AT END OF EXPOSURE
...

$ sethead -ndvh test.fts date-obs
SETHEAD 2.6.11, 20 December 1999, Doug Mink, SAO
Set Header Parameter Values in FITS image file test.fts
teste.fts: rewritten successfully.
After: 
...
DATE-OBS= '1995-10-21'          /UT DD/MM/YY AT END OF EXPOSURE
...
HISTORY  SETHEAD 2.6.11 1999-12-21 13:38 DATE-OBS updated
END

Last updated 1999-12-21 by Doug Mink

Telescope Data Center [WCSTools] [WCSTools programs] [sethead]