sethead
Examples

1. Print Usage Instructions

Print basic instructions for use of this program by typing only the program name. 
$ sethead
SETHEAD WCSTools 3.9.0, 06 May 2014, Jessica Mink (jmink@cfa.harvard.edu)
Set FITS or IRAF header keyword values
Usage: [-hknv][-r [char]][-s char] file1.fits [... filen.fits] kw1=val1
[ / comment] [ ... kwn=valuen]
  or : [-eghjknv][-r [char]][-s char] file1.fits [... filen.fits]
  @keywordfile]
  or : [-eghjknv][-r [char]][-s char] @listfile kw1=val1 [ ...
  kwn=valuen]
  or : [-eghjknv][-r [char]][-s char] @listfile @keywordfile
  -e: Add ecliptic WCS
  -g: Add galactic WCS
  -j: Add J2000 WCS
  -h: Write HISTORY line
  -k: Write SETHEAD keyword
  -l: Log files as processed (on one line)
  -m num: Change max number of keywords changed to num
  -n: Write a new file (add e before the extension)
  -r [char]: Rename reset keywords with char or X prefixed
  -s [char]: Replace this character with space in string values
  -v: Verbose
  -x [range]: Read header for these extensions (no arg=all)
  / comment: Add this comment to previous keyword
$

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 WCSTools 3.9.0, 06 May 2014, Jessica Mink (jmink@cfa.harvard.edu)
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 WCSTools 3.9.0, 06 May 2014, Jessica Mink (jmink@cfa.harvard.edu)
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 19 May 2014 by Jessica Mink

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