NI-FGEN LabVIEW VIs

Content Type
Programming Language
Current manual

niFgen Create Advanced Arb Sequence VI

niFgen Create Advanced Arb 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 in the niFgen Configure Output Mode VI to Arbitrary Sequence before calling this VI.

An arbitrary sequence consists of multiple waveforms. For each waveform, you specify the number of times 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 Advanced Arb Sequence VI extends the niFgen Create Arbitrary Sequence VI by adding the ability to set the number of samples in each sequence step and to set marker locations.

niFgen Create Advanced Arb Sequence

civrn.gif

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.

ci32.gif

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.

c1di32.gif

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.

c1di32.gif

Marker Location Array specifies the array of marker locations where you want a marker to be generated in the sequence.

Each Marker Location Array element corresponds to a Waveform Handles 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).

c1di32.gif

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.

c1di32.gif

Sample Counts Array specifies the array of sample counts that you want to use to create a new arbitrary sequence.

Sample Counts Array element corresponds to a Waveform Handles Array element and indicates the subset, in samples, of the given waveform to generate. Each element of the Sample Count Array 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 the niFgen Query Arb Waveform Capabilities VI.

cerrcodeclst.gif

error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

Default value: no error

iivrn.gif

Instrument Handle Out passes a reference to your instrument session to the next VI.

i1di32.gif

Coerced Markers Array returns an array of all given markers that are coerced (rounded) to the nearest marker quantum. Not all devices coerce markers.

ii32.gif

Sequence Handle returns a handle that identifies the new sequence.

ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

Was this information helpful?