Admin Production ni-theme
Current Publication

Configure Arbitrary Sequence

IVI Compliance Package

IviFgen Configure Arbitrary Sequence

IviFgenArbSeq Capability Group [SEQ]

This VI configures the properties of the function generator that affect arbitrary sequence generation. These properties are the arbitrary sequence handle, gain, and offset.

instrument handle The instrument handle that you obtain from the IviFgen Initialize or IviFgen Initialize With Options VI.
channel name ("CHANNEL1") Pass the virtual channel name that you assign to the instrument in MAX.

Virtual channel names are aliases for instrument specific channel strings. The instrument specific channel strings can differ from one instrument to another. Virtual channel names allow you to use and swap instruments without having to change the channel names in your source code. You assign a virtual channel name to an instrument specific channel through MAX. This control accepts virtual channel names you have assigned to the specific instrument you are using. It also accepts the instrument specific channel names.

Default Value: "CHANNEL1"

sequence handle (0) Pass the handle of the arbitrary sequence you want the function generator to produce. The driver sets the IviFgen Arbitrary Sequence Handle [SEQ] property to this value. You create an arbitrary sequence using the IviFgen Create Arbitrary Sequence [SEQ] VI. The IviFgen Create Arbitrary Sequence VI returns a handle that you use to identify the sequence.

Default Value: None

gain (1.00) Specifies the factor by which the function generator scales the arbitrary waveforms in the sequence. When you create arbitrary waveforms, you must first normalize the data points to a range of —1.00 to +1.00. You use this property to scale the waveforms in the sequence to other ranges. The driver sets the IviFgen Arbitrary Waveform Gain [ARB] property to this value. For example, to configure the output signal to range from —2.00 V to +2.00 V, set the gain to 2.00.

Units: None

Default Value: 1.00

offset (0.00 V) Specifies the value the function generator adds to the arbitrary waveforms in the sequence. When you create arbitrary waveforms, you must first normalize the data points to a range of —1.00 to +1.00. You use this parameter to shift the ranges of the arbitrary waveforms in the sequence. The driver sets the IviFgen Arbitrary Waveform Offset [ARB] property to this value. For example, to configure the output signal to range from 0.00 V to 2.00 V instead of —1.00 V to 1.00 V, set the Offset to 1.00.

Units: Volts (V)

Default Value: 0

error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

instrument handle out The instrument handle that you obtain from the IviFgen Initialize or IviFgen Initialize With Options VI.
error out The error out cluster passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.