Help for NSYTGOOD

PURPOSE:

The NSYTGOOD program generates an overall goodness product by looking at
the goodness bands of multiple other products (such as tilt and roughness).

Note that this program is not really InSight specific; it is flexible and
configurable enough to be used anywhere there are multiple status bands.

EXECUTION:

for seis:
nsytgood \( rus ruw tfs tfw tds\) gus mask=wss

for hp3:
nsytgood \( ruh -- tfh\) guh mask=wsh

where ruh/rus/ruw come from NSYTROUGH, tfh/tfs/tfw/tds come from NSYTTILT,
and wss/wsh come from NSYTWKSP.

METHOD:

The BAND parameter specifies which band contains the goodness map for each
input product (default 1).  For each pixel, NSYTGOOD looks at the goodness
value for each product, and compares to THRESH (default 5).  If the value
is >= THRESH, it is good.  If all of the input products are good, the output
is set to GOOD_VALUE (default 5).  If one of them is bad, the corresponding
item is pulled from the SINGLE_BAD parameter, and that value is put in the
output.  If more than one of them are bad, the output is set to the value
in MULTI_BAD.

If the optional MASK file is given, the MASK file is also consulted.  If the
value in MASK is < MASK_THRESH, the pixel is outside of the mask and is marked
bad using MASK_BAD (0), regardless of the status of the inputs.

If an input file is "--" then that slot is skipped, which allows the same
per-band parameter defaults to be used for multiple cases (e.g. InSight
SEIS vs HP3).

For InSight, the default parameters produce the following for SEIS (given
the inputs shown at the top of this help):

0 = no data or outside mask
1 = multiple inputs are bad
2 = roughness of either seis or wts is bad
3 = tilt of either seis or wts is bad
4 = delta-tilt between seis and wts is bad
5 = all good

and the following for HP3:

0 = no data or outside mask
1 = multiple inputs are bad
2 = roughness is bad
3 = tilt is bad
4 = n/a
5 = all good

Note:  multiple inputs can use the same single_bad value, but if more than
one are bad it goes to multi_bad.


HISTORY:
  2015-09    rgd - Initial version
  2016-01    rgd - Wrote help
  2019-12-23 wlb - IDS-7926 - initialized some variables; cleaned up -Wall warnings;
                   added unit test.
                   Note 'mask.SimpleImage<double>::_line_stride' may be used uninitialized

COGNIZANT PROGRAMMER: B. Deen

PARAMETERS: