carta
mGetHdr(1)

mGetHdr1

Retrieve the header from a fits image

Usage

mGetHdr [-d] [-h hdu] [-s statusfile] img.fits img.hdr

Overview

Reads in the header from a FITS image and prints it out to a text file.

Options

-d

Turns on debugging.

-h hdu

Retrieve the header from the Fits extension 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.

Result

Creates output file img.hdr which is a text copy of the FITS header from the input image.

Messages

OK

[struct stat="OK", ncard=nrows]

ERROR

Cannot open status file: statusfile

ERROR

HDU value (hdu) must be a non-negative integer

ERROR

Can't open output header file.

ERROR

FITS library error

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.

History

  • Debian 13 (Trixie) to Debian 10 (Buster): the text shown here
  • Debian 9 (Stretch)

Bugs

The drizzle algorithm has been implemented but has not been tested in this release.

If a header template contains carriage returns (i.e., created/modified on a Windows machine), the cfitsio library will be unable to read it properly, resulting in the error: [struct stat="ERROR", status=207, msg="illegal character in keyword"]

It is best for the background correction algorithms if the area described in the header template completely encloses all of the input images in their entirety. If parts of input images are "chopped off" by the header template, the background correction will be affected. We recommend you use an expanded header for the reprojection and background modeling steps, returning to the originally desired header size for the final coaddition. The default background matching assumes that there are no non-linear background variations in the individual images (and therefore in the overlap differences). If there is any uncertainty in this regard, it is safer to turn on the "level only" background matching (the "-l" flag in mBgModel.

From montage 6.1+dfsg-1+b1 in Debian 13 (Trixie). Parsed by carta from the page's man source.