Admin Production ni-theme
Current Publication

Create Arbitrary Sequence

IVI Compliance Package

IviFgen Create Arbitrary Sequence

IviFgenArbSeq Capability Group [SEQ]

An arbitrary sequence consists of multiple waveforms. For each waveform, you specify the number of times the function generator produces the waveform before proceeding to the next waveform. The number of times to repeat a specific waveform is called the loop count.

This VI creates an arbitrary sequence from an array of waveform handles and an array of corresponding loop counts. The VI returns a handle that identifies the sequence. You pass this handle to the IviFgen Configure Arbitrary Sequence [SEQ] VI to specify what arbitrary sequence you want the function generator to produce.

instrument handle The instrument handle that you obtain from the IviFgen Initialize or IviFgen Initialize With Options VI.
sequence length (1) Pass the number of waveforms in the new arbitrary sequence you want to create. The value you pass must be between the minimum and maximum sequence lengths the function generator allows. You can obtain the minimum and maximum sequence lengths from the Minimum Sequence Length and Maximum Sequence Length parameters of the IviFgen Query Arb Sequence Capabilities [SEQ] VI.

Default Value: 1

waveform handles array (empty) Pass the array of waveform handles from which you want to create a new arbitrary sequence. The array must have at least as many elements as the value you specify in the Sequence Length parameter. Each Waveform Handles array element has a corresponding Loop Counts array element that indicates how many times that waveform is repeated. You obtain waveform handles when you create arbitrary waveforms with the IviFgen Create Arbitrary Waveform [ARB] VI.

Default Value: None

loop counts array (empty) Pass the array of loop counts you want to use to create a new arbitrary sequence. The array must have at least as many elements as the value you specify in the Sequence Length parameter. Each Loop Counts array element corresponds to a Waveform Handles array element and indicates how many times to repeat that waveform. Each element of the Loop Count array must be less than or equal to the maximum number of loop counts the function generator allows. You can obtain the maximum loop count from the Maximum Loop Count parameter of the IviFgen Query Arb Sequence Capabilities [SEQ] VI.

Default Value: None

error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

instrument handle out The instrument handle that you obtain from the IviFgen Initialize or IviFgen Initialize With Options VI.
sequence handle Returns the handle that identifies the new arbitrary sequence. You pass this handle to the IviFgen Configure Arbitrary Sequence [SEQ] VI to generate the arbitrary sequence.
error out The error out cluster passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.