mGetHdr

Description:
Reads in the header from a FITS image and prints it out to a text file.
Syntax:
mGetHdr [-d] [-h hdu] [-s statusfile] img.fits img.hdr

Switches:

-d
Turns on debugging.
-h hdu
Retrieve the header from the Fits extention given by hdu. "0" indicates the primary FITS extension, and is the default used by mGetHdr.
-s statusfile
Output and errors are sent to statusfile instead of to stdout

Arguments:

img.fits
Path to FITS image from which to retrieve the header.
img.hdr
Path to text file where FITS header should be written.
Results:
Creates output file img.hdr which is a text copy of the FITS header from the input image.

Examples:

Running mGetHdr on a 2MASS Atlas image:

$ mGetHdr 2mass.fits test.hdr
[struct stat="OK", ncard=112]

This creates the text file test.hdr.

Return Codes:

  • [struct stat="OK", ncard=nrows]
  • [struct stat="ERROR", msg="Usage: mGetHdr [-d] [-h hdu] [-s statusfile] img.fits img.hdr"]
  • [struct stat="ERROR", msg="Cannot open status file: statusfile"]
  • [struct stat="ERROR", msg="HDU value (hdu) must be a non-negative integer"]
  • [struct stat="ERROR", msg="Usage: Image file (filename) does not exist"]
  • [struct stat="ERROR", msg="Can't open output header file."]
  • [struct stat="ERROR", flag=n, msg="FITS library error"]