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

USE
Use the Comparator to compare a numeric test
value, such as a Waveform or Coord, with 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.  If all values pass the
comparison, an empty Coord is output on the
Failures output pin 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 Comparator compares only numeric values,
not text strings.

The shape of the Ref Value is treated as
the same shape as the Test Value.  For
example, a Scalar 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.

All tests use an "almost equal" algorithm
that checks equality or inequality to at
least six significant digits.  If the Ref
Value is an array with more than one element,
a value for "virtual zero" is derived from
the reference data's magnitude.  Any data
points with a value of "0" must be matched
with this "virtual zero" value.

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