HELP
An object that compares two values then
outputs the coordinates where the comparison
fails.

USE
Use Comparator to check a test value, such as
a Waveform, or Coord against a reference
value.  If one or more of the values in Test
Value fails the comparison, a Coord Array 1D
is output on the Failures output pin and the
Failed output pin activates.  Otherwise, the
Passed output pin activates, otherwise
"Failures" activates with an empty Coord and
the "Passed" output pin activates.

The independent field (x) in the Failures
output Coord Array 1D contains the index or
mapping of each failure point.  The dependent
field (y) contains the Test Value that
failed.

LOCATION
Device ==> Comparator

OPEN VIEW PARAMETERS
Test Value == Ref Value - Change the
comparison operator by clicking on it and
selecting the function from the list that is
displayed.  Default is ==.

NOTES
The shape of the Ref Value is treated as the
same shape as the Test Value.  For example, a
Scaler Ref Value of 3 is treated as an Array
1D (with all elements equal to 3) when the
Test Value is an Array 1D.  If arrays are
compared, their size and number of dimensions
must match.

If Test Value is a scalar, Ref Value must
be a scalar.

If Test Value is an unmapped array, any
mappings on Ref Value are ignored.

If Test Value is a mapped array, the
independent variable of the Failures output
Coord (x) is the mapping of the element that
failed.

If Test Value is a Coord, only the
dependent variable of the Coord is used in
the comparison.  The Failures output Coord
contains the Coord value that failed.

Test that involve equality (==, !=, <=,
>=) use and "almost equal" algorithm that
checks equality to at least six significant
digits.  If at least one of the values is
"0", exact equality rules apply.

SEE ALSO
Alloc Array, Build Arb Waveform, Coord,
If/Then, and Set Values
