niFgen Create Advanced Arb Sequence

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 niFgen Configure Arbitrary Sequence VI to specify what arbitrary sequence you want the signal generator to produce.

Notes  The signal generator must not be in the Generating state when you call this VI. You must set Output Mode to Arbitrary Sequence using niFgen Configure Output Mode VI 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 niFgen Create Arbitrary Sequence VI by adding the ability to set the number of samples in each sequence step and to set marker locations.

	Instrument Handle identifies your instrument session. Instrument Handle was obtained from the niFgen Initialize VI or niFgen Initialize With Options VI.
	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).
	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 niFgen Query Arb Sequence Capabilities 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 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 niFgen Create Waveform (poly) VI or niFgen Allocate Waveform VI.
	Sample Counts Array specifies the 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 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 niFgen Query Arb Waveform Capabilities.
	error in describes error conditions that occur before this VI or function runs. status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code. source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
	Instrument Handle Out passes a reference to your instrument session to the next VI.
	Coerced Markers Array returns an array of all given markers that are coerced (rounded) to the nearest marker quantum. Not all devices coerce markers.
	Sequence Handle returns a handle that identifies the new sequence.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.