mProjExec
- Description:
- An executive which runs mProject (or, if possible for the input/output projections, mProjectPP) for each image in an image metadata table. In the case of data cubes, mProjectCube will be used.
- Syntax:
- mProjExec [-q] [-p rawdir] [-d] [-e] [-X] [-b border] [-r restartrec] [-s statusfile] [-x scaleColumn] images.tbl template.hdr projdir stats.tbl
Switches:
- -q
- Use mProjectQL for reprojections. Much faster but not quite flux-conserving.
- -p rawdir
- Specifies the path to the directory containing the images to be reprojected. If the -p switch is not included, mProjExec looks for the images in the current working directory.
- -d
- Turns on debugging
- -e
- Flag indicating output image should exactly match the FITS header template, and not crop off blank pixels
- -X
- Force reprojection of whole images, even if they exceed the area of the FITS header template
- -b border
- Ignore border width of pixels around edge of images
- -r restartrec
- Allows restart at record number restartrec, if mProjExec exits upon an error
- -s statusfile
- Output and errors are written to statusfile instead of being written to stdout.
- -x scaleColumn
- Turn on flux rescaling (e.g. magnitude zero point correction): scaleColumn is the name of a column in images.tbl which contains scale information.
Arguments:
- images.tbl
- ASCII table (generated by mImgtbl) containing metadata for all images to be reprojected.
- template.hdr
- FITS header template to be used in generation of output FITS.
- projdir
- Directory in which to create reprojected images.
- stats.tbl
- Name of table for output statistics (time of each reprojection, or error messages).
- Results:
- [struct stat="OK", count=16, failed=0, nooverlap=0]
- For each input file name.fits in the table images.tbl, mProjExec creates a corresponding name.fits and name_area.fits in the directory projdir.
- nimages is the number of images successfully processed, nfailed is the number of images mProject was unable to process, and noutside is the number of images that did not overlap with the given template.hdr.
- The file stats.tbl is an ASCII table containing the filename, status, and time for each file.
Examples
The following example runs mProjExec on a directory containing 16 images. The -f switch specifies that mProjExec will use mProjectPP to reproject the files, as opposed to mProject. Relevant files are images.tbl, generated by mImgtbl, and template.hdr. Files will be created in the directory projdir.
- $ mProjExec -p raw images.tbl template.hdr proj stats.tbl
- [struct stat="OK", count=16, failed=0, nooverlap=0]
See output file stats.tbl.
Return Codes:
- [struct stat="OK", count=nimages, failed=nfailed, nooverlap=noutside]
- [struct stat="ERROR", msg="Usage: mProjExec [-p rawdir] [-d] [-e(xact)] [-X(whole image)] [-b border] [-r restartrec] [-s statusfile] [-x scaleColumn] images.tbl template.hdr projdir stats.tbl"]
- [struct stat="ERROR", msg="MPI initialization failed"]
- [struct stat="ERROR", msg="Path (outdir) is not a directory"]
- [struct stat="ERROR", msg="Restart index value string n cannot be interpreted as an integer"]
- [struct stat="ERROR", msg="Restart index value n must be greater than or equal to zero"]
- [struct stat="ERROR", msg="Cannot open status file: statusfile"]
- [struct stat="ERROR", msg="Usage: Image metadata file (filename) does not exist"]
- [struct stat="ERROR", msg="Usage: Output directory (filename) does not exist"]
- [struct stat="ERROR", msg="Can't open output file."]
- [struct stat="ERROR", msg="Can't open tmp status file."]
- [struct stat="ERROR", msg="Can't delete tmp status file."]
- [struct stat="ERROR", msg="Need column fname in input"] (column missing from image metadata table)
- [struct stat="ERROR", msg="Need column scaleCol in input"] (scale column as specified missing from image metadata table)
- [struct stat="ERROR", msg="Output would overwrite input"]
- [struct stat="ERROR", msg="Template file template.hdr not found"]
- [struct stat="ERROR", msg="Output wcsinit() failed"]
- [struct stat="ERROR", msg="mProject or mProjectPP error"]
