Data Source Tab

Use the Data Source tab to specify the data source for each measurement you configure. By default, the data source is the numeric array property Step.NumericArray . The code module the step calls can return multiple measurement values in one operation by setting the value of the Step.NumericArray property. You can also specify an alternate numeric array from which the step obtains measurement values.

The Data Source tab of the Multiple Numeric Limit Test edit pane contains the following options:

• Data Source Expression —A numeric array expression the step uses as the measurement values when performing the limit tests. You can customize this expression when you do not want to set the value of Step.NumericArray . For example, you can set the data source expression to refer to variables and properties such as, Locals.MyLocalArray .
• Specify Data Source for Each Measurement —When you enable this option, the Data Source tab displays a list of measurements and the Data Source Expression control is dimmed.
• Measurement Table —Lists the properties the step uses for each measurement when you enable the Specify Data Source for Each Measurement control.
• Reset All Data Sources to Default —Resets the expression in the Data Source Expression control and the list of measurements in the Measurement Table to the default settings if you made changes to these options. The Reset All Data Sources to Default option is available only when you enable the Specify Data Source for Each Measurement option.
• Data Source Array Options —This section contains the following options:
  • If More Data Than Measurements —If more data than measurements exists, you can choose from one of the following options:
    • Repeat One Measurement —When you enable this option, the Repeat This Measurement control contains the list of measurements defined on the Limits tab. When you select one of these measurements, it is applied to the data that remains after the other measurements have been applied. For example, when three measurements (Meas 0, Meas 1, and Meas 2) exist, the data array contains six elements, and you select Meas 1 to repeat, TestStand uses the following mode to compare the data to the limits:

      Data [0]	----------	Meas[0]
      Data [1]	----------	Meas[1]
      Data [2]	----------	Meas[2]
      Data [3]	----------	Meas[1]
      Data [4]	----------	Meas[1]
      Data [5]	----------	Meas[1]

    • Repeat Measurement Set —Measurements are repeated as a set over the extra data. If the set does not fit evenly, the number of data elements is not a multiple of the number of measurements, and the remaining measurements are not used. The step compares data and measurements using the following mode:

      Data [0]	----------	Meas[0]
      Data [1]	----------	Meas[1]
      Data [2]	----------	Meas[2]
      Data [3]	----------	Meas[0]
      Data [4]	----------	Meas[1]
      Data [5]	----------	Meas[2]

      If 8 data elements exist, the step compares them using the following mode:

      Data [0]	----------	Meas[0]
      Data [1]	----------	Meas[1]
      Data [2]	----------	Meas[2]
      Data [3]	----------	Meas[0]
      Data [4]	----------	Meas[1]
      Data [5]	----------	Meas[2]
      Data [6]	----------	Meas[0]
      Data [7]	----------	Meas[1]

    • Run-time Error —If you have more data elements than measurements, TestStand returns an error. This mode forces data and measurements to be exactly the same size.
    • Ignore Extra Data —TestStand ignores any extra data. This was the default behavior in TestStand 2.0 and is the default mode for this step type. The step compares data and measurements using the following mode:

      Data [0]	----------	Meas[0]
      Data [1]	----------	Meas[1]
      Data [2]	----------	Meas[2]
      Data [3]	----------	Ignored
      Data [4]	----------	Ignored
      Data [5]	----------	Ignored

  • Repeat This Measurement —TestStand repeats this measurement when you select Repeat One Measurement in the If More Data Than Measurement control.
  • If More Measurements Than Data —If you have more measurements than data array elements, you can choose one of the following options:
    • Run-time Error —TestStand always generates an error if you have more measurements than data.
    • Ignore Extra Measurement —Measurement -- TestStand ignores any extra measurements. TestStand compares data and measurements using the following mode:

      Data [0]	----------	Meas[0]
      Data [1]	----------	Meas[1]
      Data [2]	----------	Meas[2]
      Ignored	----------	Meas[3]
      Ignored	----------	Meas[4]
      Ignored	----------	Meas[5]