mDiff

Description:
mDiff calculates a simple difference between a single pair of overlapping images. This is meant for use on reprojected images where the pixels already line up exactly. mDiff analyzes an image metadata table to determine a list of overlapping images. Each image is compared with every other image to determine all overlapping image pairs. A pair of images are deemed to overlap if any pixel around the perimeter of one image falls within the boundary of the other image.
Syntax:
mDiff [-d level] [-n(o-areas)] [-s statusfile] in1.fits in2.fits out.fits template.hdr

Switches:

-d level
Turns on debugging to the specified level (1-4).
-n
No-area-images flag. Creates difference image without requiring pixel area FITS image
-z factor
Scale second image by factor before subtracting.
-s statusfile
Output and errors are sent to statusfile instead of to stdout

Arguments:

in1.fits
First input FITS file. (Also needs area image in1_area.fits, or use -n flag)
in2.fits
Second input FITS file.(Also needs area image in2_area.fits, or use -n flag)
out.fits
Difference FITS image to be generated.
template.hdr
FITS header template used to generate output image.
Results:
FITS image and area image representing the difference in the overlap region.

Examples:

$ mDiff proj/in1.fits proj/in2.fits output/diff.fits template.hdr
[struct stat="OK"]

Return Codes:

  • [struct stat="OK"]
  • [struct stat="ERROR", msg="Usage: mDiff [-d level] [-n(o-areas)] [-s statusfile] in1.fits in2.fits out.fits hdr.template"]
  • [struct stat="ERROR", msg="Cannot open status file: statusfile"]
  • [struct stat="ERROR", msg="Images don't overlap"]
  • [struct stat="ERROR", msg="All pixels are blank"]
  • [struct stat="ERROR", msg="Template file not found"]
  • [struct stat="ERROR", status=n, msg="FITS library error"]
  • [struct stat="ERROR", msg="general error"]