Table Of Contents

Create Advanced Arbitrary Sequence (G Dataflow)

Last Modified: August 3, 2017

Creates an arbitrary sequence from an array of waveform handles 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.

Programming Patterns

You must set the output mode input of Configure Output Mode to arbitrary sequence before calling this node. Wire the sequence handle output to Configure Arbitrary Sequence to specify which arbitrary sequence you want the waveform generator to produce.

connector_pane_image
datatype_icon

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 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).

datatype_icon

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 handles 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.

datatype_icon

session in

Handle that identifies your instrument session previously allocated by Initialize With Options.

datatype_icon

error in

Error conditions that occur before this node runs.

The node responds to this input according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error error in contains an error
If no error occurred before the node runs, the node begins execution normally.

If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Default: No error

datatype_icon

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.

datatype_icon

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.

datatype_icon

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 handles 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.

datatype_icon

session out

Reference to your instrument session to wire to the next node.

datatype_icon

error out

The node produces this output according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error error in contains an error
If no error occurred before the node runs, the node begins execution normally.

If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.
datatype_icon

coerced markers array

An array of all given markers that are coerced (rounded) to the nearest marker quantum. Not all waveform generators coerce markers.

datatype_icon

sequence handle

Handle that identifies the new sequence.

Where This Node Can Run:

Desktop OS: Windows

FPGA: Not supported


Recently Viewed Topics