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"]