mProjExec1

Usage

Overview

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.

Options

-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).

Result

[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.

Messages

OK

[struct stat="OK", count=nimages, failed=nfailed, nooverlap=noutside]

ERROR

MPI initialization failed

ERROR

Path (outdir) is not a directory

ERROR

Restart index value string n cannot be interpreted as an integer

ERROR

Restart index value n must be greater than or equal to zero

ERROR

Cannot open status file: statusfile

ERROR

Can't open output file.

ERROR

Can't open tmp status file.

ERROR

Can't delete tmp status file.

ERROR

Need column fname in input

ERROR

Need column scaleCol in input

ERROR

Output would overwrite input

ERROR

Template file template.hdr not found

ERROR

Output wcsinit() failed

ERROR

mProject or mProjectPP error

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.