Create Advanced Arbitrary Sequence
- Updated2023-05-15
- 4 minute(s) read
Create Advanced Arbitrary Sequence
Creates an arbitrary sequence from an array of waveform references and an array of corresponding loop counts with the ability to set the number of samples in each sequence step and to set marker locations.
The waveform generator must not be in the Generating state when you call this node.
Inputs/Outputs
marker location array
Array of marker locations where you want a marker to be generated in the sequence.
Each marker location array element corresponds to a waveform references array element and indicates where in the waveform a marker is to occur. The marker location must be less than the size of the waveform the marker is in.
If you do not want a marker generated for a particular sequence stage, set the marker location to -1 (no marker).
loop counts array
Array of loop counts that you want to use to create a new arbitrary sequence.
Each loop counts array element corresponds to a waveform references array element and indicates how many times to repeat that waveform. Each element of the loop counts array must be less than or equal to the maximum loop count the waveform generator allows. You can obtain the maximum loop count from the maximum loop count output of Query Arbitrary Sequence Capabilities.
session in
Handle that identifies your instrument session previously allocated by Initialize With Channels.
error in
Error conditions that occur before this node runs.
The node responds to this input according to standard error behavior.
Default value: No error
sequence length
Number of waveforms in the new arbitrary sequence that you want to create.
The value must be between the minimum and maximum sequence lengths the waveform generator supports, which on some models depend on the remaining unallocated memory. You can obtain the minimum and maximum sequence lengths from the minimum sequence length and maximum sequence length outputs of Query Arbitrary Sequence Capabilities.
waveform references array
Array of waveform references from which you want to create a new arbitrary sequence.
Each waveform references array element has a corresponding loop counts array element that indicates how many times that waveform is repeated. You obtain waveform references when you create arbitrary waveforms with Create Waveform or Allocate Waveform.
sample counts array
Array of sample counts that you want to use to create a new arbitrary sequence.
Each sample counts array element corresponds to a waveform references array element and indicates the subset, in samples, of the given waveform to generate. Each element must be larger than the minimum waveform size, a multiple of the waveform quantum, and no larger than the number of samples in the corresponding waveform. You can obtain these values by calling Query Arbitrary Waveform Capabilities.
session out
Reference to your instrument session to wire to the next node.
error out
Error information.
The node produces this output according to standard error behavior.
coerced markers array
An array of all given markers that are coerced (rounded) to the nearest marker quantum. Not all waveform generators coerce markers.
sequence reference
Handle that identifies the new sequence.
Programming Patterns
You must set the output mode input of Configure Output Mode to arbitrary sequence before calling this node. Wire the sequence reference output to Configure Arbitrary Sequence to specify which arbitrary sequence you want the waveform generator to produce.