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 contains the following options:

• Data Source Array Expression —The data source for the selected measurement. For each measurement, you typically specify values or combinations of values you already store in variable or property values.
• Specify a Data Source for Each Measurement —When you enable this option, the Data Source tab displays a list of measurements and the Data Source Array Expression control is dimmed.
• Measurement Table —Lists the properties the step uses for each measurement when you enable the Specify a 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 a Data Source for Each Measurement option.
• Data Source Array Options —This section contains the following options:
  • If More Data Than Measurements —If there is more data than measurements, 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, the step compares the data to the limits using the following mode:

      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 as follows:

      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 there are more data elements than measurements, TestStand generates 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 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 when you have more measurements than data.
    • Ignore Extra Measurements —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]