Multiple Numeric Limit Test Step

TestStand 2019 Help

Edition Date: May 2019

Part Number: 370052AA-01

»View Product Info
Download Help (Windows Only)

The Multiple Numeric Limit Test step limit checks a set of related measurements. Use the Multiple Numeric Limit Test step to check limits for multiple measurements in a single step instead of using several Numeric Limit Test steps to limit test a set of related measurements.

Use the Multiple Numeric Limit Test step to test limits for any number of measurements. Each measurement can have independent limits, units, display format, data source, and comparison type. Configure each measurement the same way you configure an individual Numeric Limit Test step. A Multiple Numeric Limit test step passes when all of measurements pass.

Configuring the Step

Use the Multiple Numeric Limit Test edit tabs in the TestStand Sequence Editor and the Edit Multiple Numeric Limit Test dialog box in a TestStand User Interface to customize the type of comparison and limits TestStand uses to set the step status.

Step Properties

In addition to the common custom properties, the Multiple Numeric Limit Test step type defines the following step properties:

  • Step.Result.Measurement—An array that stores the measurements you configure for the step. Each element of the measurement array is an instance of the NI_LimitMeasurement data type. The NI_LimitMeasurement type defines the following fields:
    • Limits.Low, High, LowExpr, HighExpr, UseLowExpr, and UseHighExpr—The limits for the comparison.
    • Units—A label that describes the measurement units for the limits and the measurement value.
    • Comp—The type of comparison, such as EQ.
    • CompExpr—The comparison operation using an expression.
    • UseCompExpr—The step uses the expression to compare the measurement values.
    • Data—Stores the numeric measurement value. The step obtains this value from the corresponding element in Step.NumericArray or from the data source you specify.
    • Status—Stores the result of the comparison of the measurement value with the limits. The result is Passed or Failed.
  • Step.DataSource—An expression that identifies the numeric array that provides the data values for all measurements when you do not use a separate data source for each measurement.
  • Step.NumericArray—A numeric array that is the default data source Step.DataSource specifies.
  • Step.UseIndividualDataSources—When this property is True, the step stores separate data source expressions for each measurement in the Step.DataSourceArray. When this property is False, the step obtains the data values for each measurement from the numeric array the Step.DataSource property specifies.
  • Step.DataSourceArray—A data source for each measurement element in the measurement array.
  • Step.ExpectedNumMeasure—The number of measurements for the step.
  • Step.ExtraDataAction—Specifies how the step processes data when the numeric array contains more elements than the number of measurements. The step can apply a specific measurement to extra data, repeat the measurement set again, generate a run-time error, or ignore the extra data.
  • Step.MeasToRepeat—A measurement to repeat when the Step.ExtraDataAction is set to RepeatOne.
  • Step.ExtraMeasAction—Specifies how the step responds when the numeric array contains fewer elements than the expected number of measurements. Options include ignoring the extra measurements or generating a run-time error.
../art/Note Note  The type for measurement and limit values must be double-precision, 64-bit floating-point values, and cannot be signed or unsigned 64-bit integers.

See Also

Multiple Numeric Limit Test Step Type (Example)

Step Types You Can Use with Any Module Adapter


Not Helpful