COMPARE

compare two data files or one file with zero

<IN1>      First input file
<IN2>      Second input file (optional)
<MAX_OUT>  Optional results parameter with maximum difference value
<MIN_OUT>  Optional results parameter with minimum difference value
<MAX_THR>  Optional threshold below which maximum difference should fall
<MIN_THR>  Optional threshold above which minimum difference should fall
<RESULT>   Optional result label, set to 1 if diff w/in thresholds, 0 if not

COMPARE differences of two input files and outputs the max/min of the difference
if the /VERBOSE switch is used. If only the first input file is given, the
results are compared to zero, and essentially the result is similar to the
MAXMIN command.

The maximum and minimum values of the difference are (optionally) saved in
results parameters.

If RESULT is given, the max and min are compared to MAX_THR and MIN_THR
respectively; the parameter set by RESULT becomes 1 if they are within the
threshold bounds, 0 otherwise.  The thresholds default to +-1E-9.

Since NeXtMidas 2.9.2, support for record base files (type 3000, 5000, and 6000)
was added. Only numeric SubRecords are compared. When running from terminal, a
message will be printed out for any SubRecords that are not numeric unless the
/VERBOSE=FALSE switch is specified. When comparing two record based files that
do not have exactly the same SubRecords (names, types, etc.), this command will
error with appropriate message. Likewise when comparing record base data to
frame based data (type 1000, 2000).

Examples:
  1. Compare a file with zero (max, min)
    nM> WAVEFORM,OUT=TEMP3,FORM=SF,ELEM=100,SHAPE=SIN,AMP=3,FREQ=.01
    nM> COMPARE TEMP3
    INFO: Diff MAX = 3.0 [COMPARE]
    INFO: Diff MIN = -3.000001 [COMPARE]
    INFO: Diff within THRESHOLDS = 0 [COMPARE]

  2. Compare above file with a new file with different amplitude
    nM> WAVEFORM,OUT=temp1,FORM=SF,ELEM=100,SHAPE=SIN,AMP=1,FREQ=.01
    nM> compare temp1 temp3 MAX_OUT=max MIN_OUT=min result=withinThreshold

    the results min and max hold the answers.
      F: MAX             = 2.0000005
      F: MIN             = -2.0000021
      L: WITHINTHRESHOLD = 0

  3. Compare two type 3000 files (record based data) with same values
    nM> compare test3000_ieee.prm test3000_eeei.prm
    INFO: Diff MAX = 0.0 [COMPARE]
    INFO: Diff MIN = 0.0 [COMPARE]
    INFO: Diff within THRESHOLDS = 1 [COMPARE]

  4. Compare two type 5000 files (record based data) with very large thresholds
    nM> compare sv1.prm sv2.prm MAX_THR=3e7 MIN_THR=-2e7
    INFO: Diff MAX = 2.0299538E7 [COMPARE]
    INFO: Diff MIN = -1.5621862E7 [COMPARE]
    INFO: Diff within THRESHOLDS = 1 [COMPARE]

Switches:
  /LEGACYSCALE - DEPRECATED since NeXtMidas 2.9.2: Use deprecated max/min/full
                 scale values for byte and other data type (which does not match
                 data type's actual max/min/full scale values). [DEF=FALSE]
  /TL      - The number of elements to be read each process loop.
             [DEF=4096 for type 1000 or 1 for other file types]
  /VERBOSE - Force output to the screen if present. Default is to output to the
             screen if <MAX_OUT> and <MIN_OUT> are not given or when in terminal