mHdr

Description:
Connects to the IRSA service HdrTemplate to create a header template based on a location, size, resolution and rotation.
Syntax:
mHdr [-s system] [-e equinox] [-h height] [-p pixsize] [-r rotation] [-t 2mass-band] object|location width outfile

Switches:

-s system
Specify a coordinate system. Can be one of:
  • "equatorial" or "eq" (default)
  • "ecliptic" or "ec"
  • "galactic" or "ga"
  • "supergalactic" or "sgal"
-e equinox
Specify an equinox. Default is 2000.0
-h height
Height (y-axis) of area in degrees. Default is equal to width
-p pixsize
Size of a pixel (in arcsec); default is 1
-r rotation
Rotation of image; default is 0
-t 2mass-band
If the data is 2MASS, the correct MAGZP will be added to the header.

Arguments:

object|location
Object string or coordinate location; should be in quotes if there are any spaces or special characters.
width
Width (x-axis) of area
outfile
Path to output header template
Results:
[struct stat="OK", count=header-lines]

Examples:

If a user wants to create a mosaic centered on m31, 1 degree on each side, the first step is to create a header template that describes the desired mosaic:

mHdr "10.68469 +41.26904" 1 m31.hdr
[struct stat="OK", count=16]

Now m31.hdr can be used by other Montage modules to generate a mosaic.

Return Codes:

  • [struct stat="OK", count=header-lines]
  • [struct stat="ERROR", msg="Usage: mHdr [-s system] [-e equinox] [-h height(deg)] [-p pixsize(arcsec)] [-r rotation] object|location width(deg) outfile (objsect/location must be a single argument string)"]
  • [struct stat="ERROR", msg="Can't open output file outfile"]
  • [struct stat="ERROR", msg="location parameter required"]
  • [struct stat="ERROR", msg="width parameter required"]
  • [struct stat="ERROR", msg="Invalid object/coordinates"]
  • [struct stat="ERROR", msg="Couldn't find host irsa.ipac.caltech.edu"]
  • [struct stat="ERROR", msg="Couldn't create socket"]
  • [struct stat="ERROR", msg="irsa.ipac.caltech.edu: connect failed"]