niFgen Create Arbitrary Sequence VI

Download PDF

Updated2023-02-21
3 minute(s) read

niFgen Create Arbitrary Sequence VI

Installed With: NI-FGEN

Creates an arbitrary sequence from an array of waveform handles and an array of corresponding loop counts. This VI returns a handle that identifies the sequence. You pass this handle to the niFgen Configure Arbitrary Sequence VI to specify what arbitrary sequence you want the signal generator to produce.

Note The signal generator must not be in the Generating state when you call this VI.

Note You must set Output Mode to Arbitrary Sequence using the niFgen Configure Output Mode VI before calling this VI.

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

niFgen Create Arbitrary Sequence

	Instrument Handle identifies your instrument session. Instrument Handle is obtained from the niFgen Initialize VI, niFgen Initialize With Options VI, or the niFgen Initialize With Channels VI.
	Sequence Length specifies the number of waveforms in the new arbitrary sequence that you want to create. The value you pass must be between the minimum and maximum sequence lengths the signal generator allows, which on some signal generators depend on the remaining unallocated memory. You can obtain the minimum and maximum sequence lengths from the Minimum Sequence Length and Maximum Sequence Length parameters in the niFgen Query Arb Sequence Capabilities VI.
	Waveform Handles Array specifies the array of waveform handles from which you want to create a new arbitrary sequence. 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 niFgen Create Waveform (poly) VI or the niFgen Allocate Waveform VI.
	Loop Counts Array specifies the array of loop counts that you want to use to create a new arbitrary sequence. 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 loop count the signal generator allows. You can obtain the maximum loop count from the Maximum Loop Count parameter of the niFgen Query Arb Sequence Capabilities VI.
	error in describes error conditions that occur before this node runs. This input provides standard error in functionality. Default value: no error
	Instrument Handle Out passes a reference to your instrument session to the next VI.
	Sequence Handle returns a handle that identifies the new sequence.
	error out contains error information. This output provides standard error out functionality.