LoopStart Configuration

To launch the Edit Loop Configuration dialog box, select Edit Loop Configuration in the context menu for the LoopStart step.

The Edit Loop Configuration dialog box contains the following options:

Configuration

· Progress display—When you enable this option, the Loop completion percentage is added to the TestStand progress bar at execution.

Example:

· Label—Specifies the Loop parameter name.

· Default value—Specifies the value used when disabling the Loop (LoopMode = Use default value).

· Unit—Specifies the Loop parameter physical unit.

Tip You can include unit prefix within Unit string (e.g. mV, kHz, MHz)
If found, the prefix will be used to calculate Unit coeff.

· Unit coeff.—(Indicator) Indicates the value multiplier corresponding to Unit prefix.

· Unit coeff. enabled—When you enable this option, the Unit coeff. is calculated by analyzing the Unit string.
The first character of the Unit string of is considered as a prefix ('T'->1E+12, 'G'->1E+9, 'M'->1E+6, 'k'->1E+3, 'm'->1E-3, 'u'->1E-6, 'n'->1-9, 'p'->1E-12, 'f'->1E-15, 'a'->1E-18, 'z'->1E-21).

· Format—Specifies format used to convert numeric value into string when generating report.
The syntax of the numeric format string is identical to the format string that the C printf function accepts, with the following exceptions:

- Place a $ character after the % character in the format string to remove trailing zeros after the decimal point.

- Use a format code 0b%b for binary and 0x%X for hexadecimal.

Tip Common Format examples are %.3f for floating point numbers and %d for decimal numbers.

Note The Error indicator lights on the OK button is disabled if an error occurs when entering values or modifying Format. Complementary error information appears when moving the cursor on Error indicator.

Example:

Values definition

Values can be either calculated at execution or defined as a list of values.

Five modes are available for values definition:

· List of values—Values are defined within a table.

· Begin + End + Step—Calculated values. NbValues is deduced.

· Begin + End + NbValues—Calculated values. Step is deduced.

· Begin + Step + NbValues—Calculated values. End is deduced.

· End + Step + NbValues—Calculated values. Begin is deduced.

List of values

Numerical values are entered in a spreadsheet table.

	Note The indicator NbItems informs you how many valid values have been found in the table. Searching valid values stops as soon as an empty cell is detected.
	Note When using a list of values, NbItems is limited to 4096 (4096 values).
	Tip You can include formula in the table. Formula are stored with the LoopStart values definition.
	Tip Copy/Paste values is possible from/to any spreadsheet application like Microsoft Excel®.

Calculated values

· Step calculation—Specifies how values are calculated

- Linear—Standard calculation

- Logarithmic—Values are calculated logarithmically (requires Begin + End + NbValues mode)

· Begin—Start value.

· End—Final value.

· Step—Value Increment, cannot be null.

· NbValues—Number of calculated values, must be greater or equal to 2.

	Tip Use "0b" or "0x" prefixs to enter a number respectively as binary or hexadecimal.
	Note When using calculated values, NbValues is limited to 100000. The Error indicator lights on if NbValues calculation is greater than 100000.

· Use variable name in step description—When you enable this option and if you use TestStand variable into an expression, the TestStand variable name will be used instead of its current value into the sequence step description.

See Also

Loop Internal Variables

LoopStart Source

LoopStart Mode