mDiffExec
- Description:
- Runs mDiff on all the pairs identified by mOverlaps.
- Syntax:
- mDiffExec [-p projdir] [-d] [-n(o-areas)] [-s statusfile] diffs.tbl template.hdr diffdir
Switches:
- -p projdir
- Specifies path to the directory containing reprojected input images.
- -d
- Turns on debugging.
- -n
- No-area-images flag. Creates difference image without requiring _area FITS images
- -s statusfile
- Output and errors are sent to statusfile instead of to stdout
Arguments:
- diffs.tbl
- Table generated by mOverlaps for the images in projdir.
- template.hdr
- FITS header template for output files.
- diffdir
- Path to output files.
- Results:
- FITS images representing the differences for each pair of overlapping images. nimages is the total number of images succesfully processed, and nfailed is the number of images that failed. The most likely cause of failure is that the FITS images overlapped, but only in areas where they contained blank pixels (especially common in images with large degree of rotation).
Examples:
First, diffs.tbl is generated using mOverlaps. Then mDiff can be run on reprojected images, using this template.hdr.
- $ mDiffExec -n -p projdir projdir/diffs.tbl template.hdr diffdir
- [struct stat="OK", count=42, failed=0]
Return Codes:
- [struct stat="OK", count=nimages, failed=nfailed]
- [struct stat="ERROR", msg="Usage: mDiffExec [-p projdir] [-d] [-n(o-areas)] [-s statusfile] diffs.tbl template.hdr diffdir"]
- [struct stat="ERROR", msg="MPI initialization failed"]
- [struct stat="ERROR", msg="Cannot open status file: statusfile"]
- [struct stat="ERROR", msg="Cannot access diffdir"]
- [struct stat="ERROR", msg="diffdir is not a directory"]
- [struct stat="ERROR", msg="Invalid image metadata file: filename"]
- [struct stat="ERROR", msg="Need columns: cntr1 cntr2 plus minus diff"] (columns missing from differences table)
- [struct stat="ERROR", msg="mDiff error"]