mMakeHdr

Description:

From a list of images to be mosaicked together, mMakeHdr generates the FITS header that best describes the output image.

Syntax:

MakeHdr [-d level] [-s statusfile] [-p(ixel-scale) cdelt] [-n] images.tbl template.hdr [system [equinox]]

Switches:

-d level

Turns on debugging to the specified level (1-3).

-s statusfile

Output and errors are written to statusfile instead of to stdout.

-p cdelt

Specify a pixel scale for the header, if different from the input images

-n

"North-aligned" flag. By default, the FITS header generated represents the best fit to the images, often resulting in a slight rotation. If you want north to be straight up in your final mosaic, you should use this flag.

Arguments:

images.tbl

Metadata table (generated by mImgtbl) describing the images to be mosaicked.

template.hdr

Path to header template to be generated.

system (optional)

Specifies the system for the header (default is Equatorial). Possible values are:

• EQUJ
• EQUB
• ECLJ
• ECLB
• GAL
• SGAL

equinox (optional)

If a coordinate system is specified, the equinox can also be given in the form YYYY. Default is J2000.

Results:

Creation of output file template.hdr.

Examples:

$ mMakeHdr 2mass-images.tbl orig.hdr

[struct stat="OK", count=30]

Return Codes:

• [struct stat = "OK", count=nimages, clon=ra, clat=dec, lonsize=crpix1, latsize=crpix2, posang=ang, lon1=ra1, lat1=dec1, lon2=ra2, lat2=dec2, lon3=ra3, lat3=dec3, lon4=ra4, lat4=dec4]
• [struct stat="ERROR", msg="Usage: mMakeHdr [-d level] [-s statusfile] [-p(ixel-scale) cdelt] [-n] images.tbl template.hdr [system [equinox]] (where system = EQUJ|EQUB|ECLJ|ECLB|GAL|SGAL)"]
• [struct stat="ERROR", msg="Memory allocation failure."]
• [struct stat="ERROR", msg="Invalid pixel scale string: cdelt"]
• [struct stat="ERROR", msg="Cannot open status file: statusfile"]
• [struct stat="ERROR", msg="Invalid system string. Must be EQUJ|EQUB|ECLJ|ECLB|GAL|SGAL"]
• [struct stat="ERROR", msg="Equinox string is not a number"]
• [struct stat="ERROR", msg="Can't open output header file."]
• [struct stat="ERROR", msg="Invalid image metadata file: filename"]
• [struct stat="ERROR", msg="Need columns: ctype1 ctype2 nl ns crval1 crval2 crpix1 crpix2 cdelt1 cdelt2 crota2 (equinox optional). Four corners (equatorial) will be used if they exist or even just a single set of coordinates"] (columns missing from image metadata table)
• [struct stat="ERROR", msg="Bad WCS for image n"]
• [struct stat="ERROR", msg="Error computing boundaries."]
• [struct stat="ERROR", msg="Output wcsinit() failed."]