mAdd
- Description:
- Coadd the reprojected images in an input list to form an output mosaic with FITS header keywords specified in a header file. Creates two output files, one containing the coadded pixel values, and the other containing coadded pixel area values. The pixel area values can be used as a weighting function if the output pixel values are themselves to be coadded with other projected images, and may also be used in validating the fidelity of the output pixel values.
- Syntax:
- mAdd [-p imgdir] [-n(o-areas)] [-a mean|median|count] [-e(xact-size)] [-d level] [-s statusfile] images.tbl template.hdr out.fits
Switches:
- -p imgdir
- Specifies path to directory containing reprojected images. If the -p switch is not included, mAdd will look for the input images in the current working directory.
- -n
- Co-addition ignores weighting by pixel areas and performs coaddition based only on pixel postions. This flag refers to input images; the area file for the output image will still be created.
- -a type
- Select type of averaging to be done on accumulated pixel values (either mean or median). To generate a map showing counts of how many times each pixel was overlapped by the input images, use count.
- -e
- Enables exact size mode. The output image will match the header template exactly, instead of shrinking the output to fit the data.
- -d level
- Turns on debugging to the specified level (1-3).
- -s statusfile
- mAdd output and errors will be written to statusfile instead of stdout.
Arguments:
- images.tbl
- ASCII table (generated by mImgtbl) containing metadata for all images to be coadded.
- template.hdr
- FITS header template to be used in generation of output FITS
- out.fits
- Name of output FITS image.
- Results:
- If successful, mAdd creates a FITS file out.fits that is a coadd of all the FITS files in the table images.tbl, according to the header template given. A corresponding out_area.fits is also created.
Examples:
The following example runs mAdd on 4 FITS images, generating the output file mosaic.fits. Related files are images.tbl and template.hdr.
- $ mAdd -p proj images.tbl template.hdr output/mosaic.fits
- [struct stat="OK", time=1]
Return Codes:
- [struct stat = "OK", time=time]
- [struct stat="ERROR", msg="Usage: mAdd [-p imgdir] [-n(o-areas)] [-a mean|median|count] [-e(xact-size)] [-d level] [-s statusfile] images.tbl template.hdr out.fits"]
- [struct stat="ERROR", msg="MPI initialization failed"]
- [struct stat="ERROR", msg="Invalid argument for -a flag"]
- [struct stat="ERROR", msg="Cannot open status file: statusfile"]
- [struct stat="ERROR", msg="Invalid image metadata file: filename"]
- [struct stat="ERROR", msg="Need columns: cntr,fname, crpix1, crpix2, cdelt1, cdelt2, naxis1, naxis2, crval1, crval2 in image list"](missing columns in image metadata table)
- [struct stat="ERROR", msg="Memory allocation failed"]
- [struct stat="ERROR", msg="Too many open files"]
- [struct stat="ERROR", msg="Input wcsinit() failed."]
- [struct stat="ERROR", msg="Failed to allocate enough memory for output arrays"]
- [struct stat="ERROR", msg="Bad WCS in header template."]
- [struct stat="ERROR", msg="Images are not in same pixel space."]
- [struct stat="ERROR", msg="Template file not found."]
- [struct stat="ERROR", status=stat, msg="FITS library error"]
- [struct stat="ERROR", msg="general error message"]