mCatMap

Description:
mCatMap is a point-source imaging program. The user defines a general output FITS image, and its pixels are populated from a table of point sources. The source fluxes (or just source counts) from the table are added into the appropriate pixel to create an output image.
Syntax:
mCatMap [-c column] [-m refmag] [-d level] [-w size] in.tbl out.fits hdr.template

Switches:

-c column
Name of the table column that contains flux levels. If not specified, pixels will be populated with source counts rather than summed flux values.
-m refmag
Set a reference magnitude to use when calculating fluxes.
-d level
Turn on debugging to the specified level (1-3)
-w size
Set a spread size for point sources (default is to use no spread). Allowed values are 3 or 5.

Arguments:

in.tbl
Input table of source metadata.
out.fits
Path of output FITS file.
hdr.template
ASCII header template defining output FITS file.
Results:
[struct stat="OK", time=seconds]

Examples:

To create an image showing the 2MASS point source fluxes (2mass_pt.tbl) in a 2 square degree area defined by 2mass_pt.hdr:

mCatMap -c flux 2mass_pt.tbl 2mass_pt.fits 2mass_pt.hdr
[struct stat="OK", time=4]

Output image:

Return Codes:

  • [struct stat="OK", time=seconds]
  • [struct stat="ERROR", msg="Usage: mCatMap [-c column] [-m refmag] [-d level] [-w size] in.tbl out.fits hdr.template"]
  • [struct stat="ERROR", msg="Can't open input table in.tbl"]
  • [struct stat="ERROR", msg="Can't find column 'ra'"]
  • [struct stat="ERROR", msg="Can't find column 'dec'"]
  • [struct stat="ERROR", msg="Can't find column 'column'"]
  • [struct stat="ERROR", msg="Output wcsinit() failed"]
  • [struct stat="ERROR", msg="Template file not found"]