Help for MARSICMINT

PURPOSE:
Simple program to intersect two ICMs and report if the number of intersecting
pixels is over or under the given threshold.  The threshold is a fraction,
with 1.0 meaning every pixel in the image and 0.0 meaning no pixels.

It looks only at band 1 for efficiency, as the zero/non-zero status should
be the same for all bands.

Intersection means a non-value exists for both inputs.

Both inputs must be the same size.

This is intended for use by CRISP ingestion.

EXECUTION:

marsicmin inp=\(icm1 icm2\)
set result = `v2param result`

the output will be 1 (pixels >= threshold) or 0 (pixels < threshold).

METHOD:
Loop through both images and count pixels that are non-zero in both.
If count exceeds threshold, stop and report success.  If there are not
enough pixels left to exceed the threshold, stop and report failure.
At end of image, report result.

If -DO_FRACTION is enabled, it does not stop early, but rather reads
the entire image to compute and return the actual fraction of intersecting
pixels (in FRACTION).  The RESULT still describes whether or not it met
the threshold.

HISTORY:

2020-09-04 rgd	Initial version

COGNIZANT PROGRAMMER:  Bob Deen