mHdrCheck

Description:
mHdrCheck reads in the header from a FITS image (or an ASCII header template file) and checks to see if any header lines are invalid. If it finds one, it will print out a message stating which keyword is invalid and exit before checking the rest of the header. It will not report on multiple invalid values. If all value are correct, mHdrCheck will print out a "Valid FITS/WCS" message.
Syntax:
mHdrCheck [-s statusfile] img.fits

Switches:

-s statusfile
Output and errors are sent to statusfile instead of to stdout

Arguments:

img.fits
Path of FITS file to be validated.

Examples:

$ mHdrCheck input/badfits/bad-crota2.fits
[struct stat="ERROR", msg="CROTA2 keyword in FITS header not a real number"]
$ mHdrCheck input/2mass.fits
[struct stat="OK", msg="Valid FITS/WCS."]
$ mHdrCheck input/badfits/bad-ctype.fits
[struct stat="ERROR", msg="Invalid projection"]

Return Codes:

  • [struct stat="OK", msg="Valid WCS in FITS file."]
  • [struct stat="OK", msg="Valid FITS/WCS in header file."]
  • [struct stat="ERROR", msg="Usage: mHdrCheck [-s statusfile] img.fits"]
  • [struct stat="ERROR", msg="Cannot open status file statusfile"]
  • [struct stat="ERROR", msg="File filename not found."]
  • [struct stat="ERROR", msg="File (filename) is not a FITS image"]
  • [struct stat="ERROR", msg="FITS header lines cannot be greater than 80 characters"]
  • [struct stat="ERROR", msg="No BITPIX keyword in FITS header"]
  • [struct stat="ERROR", msg="No NAXIS keyword in FITS header"]
  • [struct stat="ERROR", msg="No NAXIS1 keyword in FITS header"]
  • [struct stat="ERROR", msg="No NAXIS2 keyword in FITS header"]
  • [struct stat="ERROR", msg="No CTYPE1 keyword in FITS header"]
  • [struct stat="ERROR", msg="No CTYPE2 keyword in FITS header"]
  • [struct stat="ERROR", msg="No CRPIX1 keyword in FITS header"]
  • [struct stat="ERROR", msg="No CRPIX2 keyword in FITS header"]
  • [struct stat="ERROR", msg="No CRVAL1 keyword in FITS header"]
  • [struct stat="ERROR", msg="No CRVAL2 keyword in FITS header"]
  • [struct stat="ERROR", msg="No CDELT1 keyword (or incomplete CD matrix) in FITS header"]
  • [struct stat="ERROR", msg="No CDELT2 keyword (or incomplete CD matrix) in FITS header"]
  • [struct stat="ERROR", msg="BITPIX keyword in FITS header not an integer"]
  • [struct stat="ERROR", msg="Invalid BITPIX in FITS header (must be 8,16,32,64,-32 or -64)"]
  • [struct stat="ERROR", msg="NAXIS keyword in FITS header not an integer"]
  • [struct stat="ERROR", msg="NAXIS keyword in FITS header must be >= 2"]
  • [struct stat="ERROR", msg="NAXIS1 keyword in FITS header not an integer"]
  • [struct stat="ERROR", msg="NAXIS1 keyword in FITS header must be > 0"]
  • [struct stat="ERROR", msg="NAXIS2 keyword in FITS header not an integer"]
  • [struct stat="ERROR", msg="NAXIS2 keyword in FITS header must be > 0"]
  • [struct stat="ERROR", msg="CRPIX1 keyword in FITS header not a real number"]
  • [struct stat="ERROR", msg="CRPIX2 keyword in FITS header not a real number"]
  • [struct stat="ERROR", msg="CRVAL1 keyword in FITS header not a real number"]
  • [struct stat="ERROR", msg="CRVAL2 keyword in FITS header not a real number"]
  • [struct stat="ERROR", msg="CDELT1 keyword in FITS header not a real number"]
  • [struct stat="ERROR", msg="CDELT2 keyword in FITS header not a real number"]
  • [struct stat="ERROR", msg="CROTA2 keyword in FITS header not a real number"]
  • [struct stat="ERROR", msg="CD1_1 keyword in FITS header not a real number"]
  • [struct stat="ERROR", msg="CD1_2 keyword in FITS header not a real number"]
  • [struct stat="ERROR", msg="CD2_1 keyword in FITS header not a real number"]
  • [struct stat="ERROR", msg="CD2_2 keyword in FITS header not a real number"]
  • [struct stat="ERROR", msg="EQUINOX keyword in FITS header not a real number"]
  • [struct stat="ERROR", msg="No WCS information (or not FITS header)"]
  • [struct stat="ERROR", msg="Must have at least two dimensions"]
  • [struct stat="ERROR", msg="Invalid projection"]
  • [struct stat="ERROR", msg="Invalid NAXIS1"]
  • [struct stat="ERROR", msg="Invalid NAXIS2"]
  • [struct stat="ERROR", msg="CTYPE1 and CTYPE2 don't match"]
  • [struct stat="ERROR", msg="Invalid CTYPE1"]
  • [struct stat="ERROR", msg="Invalid CD matrix"]
  • [struct stat="ERROR", msg="Invalid CDELT1"]
  • [struct stat="ERROR", msg="Invalid CDELT2"]
  • [struct stat="ERROR", flag=n, msg="FITS library error"]