nifgen.Session¶

class nifgen.Session(self, resource_name, channel_name=None, reset_device=False, options={})¶

Creates and returns a new NI-FGEN session to the specified channel of a waveform generator that is used in all subsequent NI-FGEN method calls.

Parameters:

resource_name (str) –

Caution

Traditional NI-DAQ and NI-DAQmx device names are not case-sensitive. However, all IVI names, such as logical names, are case-sensitive. If you use logical names, driver session names, or virtual names in your program, you must ensure that the name you use matches the name in the IVI Configuration Store file exactly, without any variations in the case of the characters.

Specifies the resource name of the device to initialize.

For Traditional NI-DAQ devices, the syntax is DAQ::n, where n is the device number assigned by MAX, as shown in Example 1.

For NI-DAQmx devices, the syntax is just the device name specified in MAX, as shown in Example 2. Typical default names for NI-DAQmx devices in MAX are Dev1 or PXI1Slot1. You can rename an NI-DAQmx device by right-clicking on the name in MAX and entering a new name.

An alternate syntax for NI-DAQmx devices consists of DAQ::NI-DAQmx device name, as shown in Example 3. This naming convention allows for the use of an NI-DAQmx device in an application that was originally designed for a Traditional NI-DAQ device. For example, if the application expects DAQ::1, you can rename the NI-DAQmx device to 1 in MAX and pass in DAQ::1 for the resource name, as shown in Example 4.

If you use the DAQ::n syntax and an NI-DAQmx device name already exists with that same name, the NI-DAQmx device is matched first.

You can also pass in the name of an IVI logical name or an IVI virtual name configured with the IVI Configuration utility, as shown in Example 5. A logical name identifies a particular virtual instrument. A virtual name identifies a specific device and specifies the initial settings for the session.

Example #	Device Type	Syntax	Variable
1	Traditional NI-DAQ device	DAQ::1	(1 = device number)
2	NI-DAQmx device	myDAQmxDevice	(myDAQmxDevice = device name)
3	NI-DAQmx device	DAQ::myDAQmxDevice	(myDAQmxDevice = device name)
4	NI-DAQmx device	DAQ::2	(2 = device name)
5	IVI logical name or IVI virtual name	myLogicalName	(myLogicalName = name)

channel_name (str) –
Specifies the channel that this VI uses.

Default Value: “0”
reset_device (bool) –
Specifies whether you want to reset the device during the initialization procedure. True specifies that the device is reset and performs the same method as the nifgen_Reset method.

**Defined Values**

Default Value: False

True Reset device

False Do not reset device
options (str) –
Specifies the initial value of certain properties for the session. The syntax for options is a dictionary of properties with an assigned value. For example:

{ ‘simulate’: False }

You do not have to specify a value for all the properties. If you do not specify a value for a property, the default value is used.

Advanced Example: { ‘simulate’: True, ‘driver_setup’: { ‘Model’: ‘<model number>’, ‘BoardType’: ‘<type>’ } }

Property Default

range_check True

query_instrument_status False

cache True

simulate False

record_value_coersions False

driver_setup {}

Properties

Property	Datatype
`all_marker_events_latched_status`	int
`all_marker_events_live_status`	int
`analog_data_mask`	int
`analog_filter_enabled`	bool
`analog_path`	`AnalogPath`
`analog_static_value`	int
`arb_gain`	float
`arb_marker_position`	int
`arb_offset`	float
`arb_repeat_count`	int
`arb_sample_rate`	float
`arb_sequence_handle`	int
`arb_waveform_handle`	int
`aux_power_enabled`	bool
`bus_type`	`BusType`
`channel_delay`	float
`clock_mode`	`ClockMode`
`common_mode_offset`	float
`data_marker_events_count`	int
`data_marker_event_data_bit_number`	int
`data_marker_event_level_polarity`	`DataMarkerEventLevelPolarity`
`data_marker_event_output_terminal`	str
`data_transfer_block_size`	int
`data_transfer_maximum_bandwidth`	float
`data_transfer_maximum_in_flight_reads`	int
`data_transfer_preferred_packet_size`	int
`digital_data_mask`	int
`digital_edge_script_trigger_edge`	`ScriptTriggerDigitalEdgeEdge`
`digital_edge_script_trigger_source`	str
`digital_edge_start_trigger_edge`	`StartTriggerDigitalEdgeEdge`
`digital_edge_start_trigger_source`	str
`digital_filter_enabled`	bool
`digital_filter_interpolation_factor`	float
`digital_gain`	float
`digital_level_script_trigger_active_level`	`ScriptTriggerDigitalLevelActiveLevel`
`digital_level_script_trigger_source`	str
`digital_pattern_enabled`	bool
`digital_static_value`	int
`direct_dma_enabled`	bool
`direct_dma_window_address`	int
`direct_dma_window_size`	int
`done_event_delay`	float
`done_event_delay_units`	`DoneEventDelayUnits`
`done_event_latched_status`	bool
`done_event_level_active_level`	`DoneEventActiveLevel`
`done_event_output_behavior`	`DoneEventOutputBehavior`
`done_event_output_terminal`	str
`done_event_pulse_polarity`	`DoneEventPulsePolarity`
`done_event_pulse_width`	float
`done_event_pulse_width_units`	`DoneEventPulseWidthUnits`
`driver_setup`	str
`exported_onboard_reference_clock_output_terminal`	str
`exported_reference_clock_output_terminal`	str
`exported_sample_clock_divisor`	int
`exported_sample_clock_output_terminal`	str
`exported_sample_clock_timebase_divisor`	int
`exported_sample_clock_timebase_output_terminal`	str
`exported_script_trigger_output_terminal`	str
`exported_start_trigger_output_terminal`	str
`external_clock_delay_binary_value`	int
`external_sample_clock_multiplier`	float
`file_transfer_block_size`	int
`filter_correction_frequency`	float
`flatness_correction_enabled`	bool
`fpga_bitfile_path`	str
`freq_list_duration_quantum`	float
`freq_list_handle`	int
`func_amplitude`	float
`func_buffer_size`	int
`func_dc_offset`	float
`func_duty_cycle_high`	float
`func_frequency`	float
`func_max_buffer_size`	int
`func_start_phase`	float
`func_waveform`	`Waveform`
`gain_dac_value`	int
`idle_behavior`	`IdleBehavior`
`idle_value`	int
`id_query_response`	str
`instrument_firmware_revision`	str
`instrument_manufacturer`	str
`instrument_model`	str
`io_resource_descriptor`	str
`load_impedance`	float
`logical_name`	str
`major_version`	int
`marker_events_count`	int
`marker_event_delay`	float
`marker_event_delay_units`	`MarkerEventDelayUnits`
`marker_event_latched_status`	bool
`marker_event_live_status`	bool
`marker_event_output_behavior`	`MarkerEventOutputBehavior`
`marker_event_output_terminal`	str
`marker_event_pulse_polarity`	`MarkerEventPulsePolarity`
`marker_event_pulse_width`	float
`marker_event_pulse_width_units`	`MarkerEventPulseWidthUnits`
`marker_event_toggle_initial_state`	`MarkerEventToggleInitialState`
`max_freq_list_duration`	float
`max_freq_list_length`	int
`max_loop_count`	int
`max_num_freq_lists`	int
`max_num_sequences`	int
`max_num_waveforms`	int
`max_sequence_length`	int
`max_waveform_size`	int
`memory_size`	int
`minor_version`	int
`min_freq_list_duration`	float
`min_freq_list_length`	int
`min_sequence_length`	int
`min_waveform_size`	int
`module_revision`	str
`num_channels`	int
`offset_dac_value`	int
`oscillator_freq_dac_value`	int
`oscillator_phase_dac_value`	int
`osp_carrier_enabled`	bool
`osp_carrier_frequency`	float
`osp_carrier_phase_i`	float
`osp_carrier_phase_q`	float
`osp_cic_filter_enabled`	bool
`osp_cic_filter_gain`	float
`osp_cic_filter_interpolation`	float
`osp_compensate_for_filter_group_delay`	bool
`osp_data_processing_mode`	`DataProcessingMode`
`osp_enabled`	bool
`osp_fir_filter_enabled`	bool
`osp_fir_filter_flat_passband`	float
`osp_fir_filter_gaussian_bt`	float
`osp_fir_filter_interpolation`	float
`osp_fir_filter_raised_cosine_alpha`	float
`osp_fir_filter_root_raised_cosine_alpha`	float
`osp_fir_filter_type`	`FilterType`
`osp_frequency_shift`	float
`osp_mode`	`OSPMode`
`osp_overflow_error_reporting`	`OSPOverflowErrorReporting`
`osp_overflow_status`	int
`osp_pre_filter_gain_i`	float
`osp_pre_filter_gain_q`	float
`osp_pre_filter_offset_i`	float
`osp_pre_filter_offset_q`	float
`output_enabled`	bool
`output_impedance`	float
`output_mode`	`OutputMode`
`p2p_endpoint_fullness_start_trigger_level`	int
`pci_dma_optimizations_enabled`	bool
`post_amplifier_attenuation`	float
`pre_amplifier_attenuation`	float
`ready_for_start_event_level_active_level`	`ReadyForStartEventActiveLevel`
`ready_for_start_event_live_status`	bool
`ready_for_start_event_output_terminal`	str
`reference_clock_source`	`ReferenceClockSource`
`ref_clock_frequency`	float
`sample_clock_absolute_delay`	float
`sample_clock_source`	`SampleClockSource`
`sample_clock_timebase_rate`	float
`sample_clock_timebase_source`	`SampleClockTimebaseSource`
`script_to_generate`	str
`script_triggers_count`	int
`script_trigger_type`	`ScriptTriggerType`
`serial_number`	str
`simulate`	bool
`specific_driver_description`	str
`specific_driver_revision`	str
`specific_driver_vendor`	str
`started_event_delay`	float
`started_event_delay_units`	`StartedEventDelayUnits`
`started_event_latched_status`	bool
`started_event_level_active_level`	`StartedEventActiveLevel`
`started_event_output_behavior`	`StartedEventOutputBehavior`
`started_event_output_terminal`	str
`started_event_pulse_polarity`	`StartedEventPulsePolarity`
`started_event_pulse_width`	float
`started_event_pulse_width_units`	`StartedEventPulseWidthUnits`
`start_trigger_type`	`StartTriggerType`
`streaming_space_available_in_waveform`	int
`streaming_waveform_handle`	int
`streaming_waveform_name`	str
`streaming_write_timeout`	float in seconds or datetime.timedelta
`supported_instrument_models`	str
`synchronization`	`SynchronizationSource`
`sync_duty_cycle_high`	float
`sync_out_output_terminal`	str
`terminal_configuration`	`TerminalConfiguration`
`trigger_mode`	`TriggerMode`
`trigger_source`	`TriggerSource`
`video_waveform_type`	`VideoWaveformType`
`wait_behavior`	`WaitBehavior`
`wait_value`	int
`waveform_quantum`	int

Public methods

Method name
`abort()`
`allocate_named_waveform()`
`allocate_waveform()`
`clear_arb_memory()`
`clear_arb_sequence()`
`clear_arb_waveform()`
`clear_freq_list()`
`clear_user_standard_waveform()`
`commit()`
`configure_arb_sequence()`
`configure_arb_waveform()`
`configure_custom_fir_filter_coefficients()`
`configure_digital_edge_script_trigger()`
`configure_digital_edge_start_trigger()`
`configure_digital_level_script_trigger()`
`configure_freq_list()`
`configure_standard_waveform()`
`create_advanced_arb_sequence()`
`create_arb_sequence()`
`create_freq_list()`
`create_waveform_from_file_f64()`
`create_waveform_from_file_i16()`
`create_waveform_numpy()`
`define_user_standard_waveform()`
`delete_named_waveform()`
`delete_script()`
`disable()`
`get_ext_cal_last_date_and_time()`
`get_ext_cal_last_temp()`
`get_ext_cal_recommended_interval()`
`get_fir_filter_coefficients()`
`get_hardware_state()`
`get_self_cal_last_date_and_time()`
`get_self_cal_last_temp()`
`get_self_cal_supported()`
`is_done()`
`query_arb_seq_capabilities()`
`query_arb_wfm_capabilities()`
`query_freq_list_capabilities()`
`read_current_temperature()`
`reset()`
`reset_device()`
`reset_with_defaults()`
`self_cal()`
`self_test()`
`send_software_edge_trigger()`
`set_named_waveform_next_write_position()`
`set_waveform_next_write_position()`
`wait_until_done()`
`write_script()`
`write_waveform()`

Properties¶

all_marker_events_latched_status¶

nifgen.Session.all_marker_events_latched_status¶

Returns a bit field of the latched status of all Marker Events. Write 0 to this property to clear the latched status of all Marker Events.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Marker:Advanced:All Marker Events Latched Status

C Attribute: NIFGEN_ATTR_ALL_MARKER_EVENTS_LATCHED_STATUS

all_marker_events_live_status¶

nifgen.Session.all_marker_events_live_status¶

Returns a bit field of the live status of all Marker Events.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Marker:Advanced:All Marker Events Live Status

C Attribute: NIFGEN_ATTR_ALL_MARKER_EVENTS_LIVE_STATUS

analog_data_mask¶

nifgen.Session.analog_data_mask¶

Specifies the mask to apply to the analog output. The masked data is replaced with the data in nifgen.Session.analog_static_value.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Data Mask:Analog Data Mask

C Attribute: NIFGEN_ATTR_ANALOG_DATA_MASK

analog_filter_enabled¶

nifgen.Session.analog_filter_enabled¶

Controls whether the signal generator applies to an analog filter to the output signal. This property is valid in arbitrary waveform, arbitrary sequence, and script modes. This property can also be used in standard method and frequency list modes for user-defined waveforms.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Filters:Analog Filter Enabled

C Attribute: NIFGEN_ATTR_ANALOG_FILTER_ENABLED

analog_path¶

nifgen.Session.analog_path¶

Specifies the analog signal path that should be used. The main path allows you to configure gain, offset, analog filter status, output impedance, and output enable. The main path has two amplifier options, high- and low-gain. The direct path presents a much smaller gain range, and you cannot adjust offset or the filter status. The direct path also provides a smaller output range but also lower distortion. NI-FGEN normally chooses the amplifier based on the user-specified gain.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.AnalogPath

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Analog Path

C Attribute: NIFGEN_ATTR_ANALOG_PATH

analog_static_value¶

nifgen.Session.analog_static_value¶

Specifies the static value that replaces data masked by nifgen.Session.analog_data_mask.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Data Mask:Analog Static Value

C Attribute: NIFGEN_ATTR_ANALOG_STATIC_VALUE

arb_gain¶

nifgen.Session.arb_gain¶

Specifies the factor by which the signal generator scales the arbitrary waveform data. When you create arbitrary waveforms, you must first normalize the data points to the range -1.0 to +1.0. Use this property to scale the arbitrary waveform to other ranges. For example, when you set this property to 2.0, the output signal ranges from -2.0 V to +2.0 V. Use this property when nifgen.Session.output_mode is set to ARB or SEQ.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Gain

C Attribute: NIFGEN_ATTR_ARB_GAIN

arb_marker_position¶

nifgen.Session.arb_marker_position¶

Specifies the position for a marker to be asserted in the arbitrary waveform. This property defaults to -1 when no marker position is specified. Use this property when nifgen.Session.output_mode is set to ARB. Use nifgen.Session.ExportSignal() to export the marker signal.

Note

One or more of the referenced methods are not in the Python API for this driver.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Arbitrary Waveform Mode:Marker Position

C Attribute: NIFGEN_ATTR_ARB_MARKER_POSITION

arb_offset¶

nifgen.Session.arb_offset¶

Specifies the value that the signal generator adds to the arbitrary waveform data. When you create arbitrary waveforms, you must first normalize the data points to the range -1.0 to +1.0. Use this property to shift the arbitrary waveform range. For example, when you set this property to 1.0, the output signal ranges from 2.0 V to 0.0 V. Use this property when nifgen.Session.output_mode is set to ARB or SEQ. Units: Volts

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Offset

C Attribute: NIFGEN_ATTR_ARB_OFFSET

arb_repeat_count¶

nifgen.Session.arb_repeat_count¶

Specifies number of times to repeat the arbitrary waveform when the triggerMode parameter of nifgen_ConfigureTriggerMode is set to SINGLE or STEPPED. This property is ignored if the triggerMode parameter is set to CONTINUOUS or BURST. Use this property when nifgen.Session.output_mode is set to ARB. When used during streaming, this property specifies the number of times to repeat the streaming waveform (the onboard memory allocated for streaming). For more information about streaming, refer to the Streaming topic.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Arbitrary Waveform Mode:Repeat Count

C Attribute: NIFGEN_ATTR_ARB_REPEAT_COUNT

arb_sample_rate¶

nifgen.Session.arb_sample_rate¶

Specifies the rate at which the signal generator outputs the points in arbitrary waveforms. Use this property when nifgen.Session.output_mode is set to ARB or SEQ. Units: Samples/s

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Sample Clock:Rate

C Attribute: NIFGEN_ATTR_ARB_SAMPLE_RATE

arb_sequence_handle¶

nifgen.Session.arb_sequence_handle¶

This channel-based property identifies which sequence the signal generator produces. You can create multiple sequences using nifgen.Session.create_arb_sequence(). nifgen.Session.create_arb_sequence() returns a handle that you can use to identify the particular sequence. To configure the signal generator to produce a particular sequence, set this property to the sequence handle. Use this property only when nifgen.Session.output_mode is set to SEQ.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Arbitrary Sequence Mode:Arbitrary Sequence Handle

C Attribute: NIFGEN_ATTR_ARB_SEQUENCE_HANDLE

arb_waveform_handle¶

nifgen.Session.arb_waveform_handle¶

Selects which arbitrary waveform the signal generator produces. You can create multiple arbitrary waveforms using one of the following niFgen Create Waveform methods: nifgen.Session.create_waveform() nifgen.Session.create_waveform() nifgen.Session.create_waveform_from_file_i16() nifgen.Session.create_waveform_from_file_f64() nifgen.Session.CreateWaveformFromFileHWS() These methods return a handle that you can use to identify the particular waveform. To configure the signal generator to produce a particular waveform, set this property to the waveform handle. Use this property only when nifgen.Session.output_mode is set to ARB.

Note

One or more of the referenced methods are not in the Python API for this driver.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Arbitrary Waveform Mode:Arbitrary Waveform Handle

C Attribute: NIFGEN_ATTR_ARB_WAVEFORM_HANDLE

aux_power_enabled¶

nifgen.Session.aux_power_enabled¶

Controls the specified auxiliary power pin. Setting this property to TRUE energizes the auxiliary power when the session is committed. When this property is FALSE, the power pin of the connector outputs no power.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Advanced:AUX Power Enabled

C Attribute: NIFGEN_ATTR_AUX_POWER_ENABLED

bus_type¶

nifgen.Session.bus_type¶

The bus type of the signal generator.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.BusType

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Bus Type

C Attribute: NIFGEN_ATTR_BUS_TYPE

channel_delay¶

nifgen.Session.channel_delay¶

Specifies, in seconds, the delay to apply to the analog output of the channel specified by the channel string. You can use the channel delay to configure the timing relationship between channels on a multichannel device. Values for this property can be zero or positive. A value of zero indicates that the channels are aligned. A positive value delays the analog output by the specified number of seconds.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Channel Delay

C Attribute: NIFGEN_ATTR_CHANNEL_DELAY

clock_mode¶

nifgen.Session.clock_mode¶

Controls which clock mode is used for the signal generator. For signal generators that support it, this property allows switching the sample clock to High-Resolution mode. When in Divide-Down mode, the sample rate can only be set to certain frequences, based on dividing down the update clock. However, in High-Resolution mode, the sample rate may be set to any value.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.ClockMode

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Sample Clock:Mode

C Attribute: NIFGEN_ATTR_CLOCK_MODE

common_mode_offset¶

nifgen.Session.common_mode_offset¶

Specifies, in volts, the value the signal generator adds to or subtracts from the arbitrary waveform data. This property applies only when you set the nifgen.Session.terminal_configuration property to DIFFERENTIAL. Common mode offset is applied to the signals generated at each differential output terminal.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Common Mode Offset

C Attribute: NIFGEN_ATTR_COMMON_MODE_OFFSET

data_marker_events_count¶

nifgen.Session.data_marker_events_count¶

Returns the number of Data Marker Events supported by the device.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Data Marker Events Count

C Attribute: NIFGEN_ATTR_DATA_MARKER_EVENTS_COUNT

data_marker_event_data_bit_number¶

nifgen.Session.data_marker_event_data_bit_number¶

Specifies the bit number to assign to the Data Marker Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Data Marker:Data Bit Number

C Attribute: NIFGEN_ATTR_DATA_MARKER_EVENT_DATA_BIT_NUMBER

data_marker_event_level_polarity¶

nifgen.Session.data_marker_event_level_polarity¶

Specifies the output polarity of the Data marker event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.DataMarkerEventLevelPolarity

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Data Marker:Level:Active Level

C Attribute: NIFGEN_ATTR_DATA_MARKER_EVENT_LEVEL_POLARITY

data_marker_event_output_terminal¶

nifgen.Session.data_marker_event_output_terminal¶

Specifies the destination terminal for the Data Marker Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Data Marker:Output Terminal

C Attribute: NIFGEN_ATTR_DATA_MARKER_EVENT_OUTPUT_TERMINAL

data_transfer_block_size¶

nifgen.Session.data_transfer_block_size¶

The number of samples at a time to download to onboard memory. Useful when the total data to be transferred to onboard memory is large.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Data Transfer:Data Transfer Block Size

C Attribute: NIFGEN_ATTR_DATA_TRANSFER_BLOCK_SIZE

data_transfer_maximum_bandwidth¶

nifgen.Session.data_transfer_maximum_bandwidth¶

Specifies the maximum amount of bus bandwidth (in bytes per second) to use for data transfers. The signal generator limits data transfer speeds on the PCIe bus to the value you specify for this property. Set this property to optimize bus bandwidth usage for multi-device streaming applications by preventing the signal generator from consuming all of the available bandwidth on a PCI express link when waveforms are being written to the onboard memory of the device.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Data Transfer:Maximum Bandwidth

C Attribute: NIFGEN_ATTR_DATA_TRANSFER_MAXIMUM_BANDWIDTH

data_transfer_maximum_in_flight_reads¶

nifgen.Session.data_transfer_maximum_in_flight_reads¶

Specifies the maximum number of concurrent PCI Express read requests the signal generator can issue. When transferring data from computer memory to device onboard memory across the PCI Express bus, the signal generator can issue multiple memory reads at the same time. In general, the larger the number of read requests, the more efficiently the device uses the bus because the multiple read requests keep the data flowing, even in a PCI Express topology that has high latency due to PCI Express switches in the data path. Most NI devices can issue a large number of read requests (typically 8 or 16). By default, this property is set to the highest value the signal generator supports. If other devices in your system cannot tolerate long data latencies, it may be helpful to decrease the number of in-flight read requests the NI signal generator issues. This helps to reduce the amount of data the signal generator reads at one time.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Data Transfer:Advanced:Maximum In-Flight Read Requests

C Attribute: NIFGEN_ATTR_DATA_TRANSFER_MAXIMUM_IN_FLIGHT_READS

data_transfer_preferred_packet_size¶

nifgen.Session.data_transfer_preferred_packet_size¶

Specifies the preferred size of the data field in a PCI Express read request packet. In general, the larger the packet size, the more efficiently the device uses the bus. By default, NI signal generators use the largest packet size allowed by the system. However, due to different system implementations, some systems may perform better with smaller packet sizes. Recommended values for this property are powers of two between 64 and 512. In some cases, the signal generator generates packets smaller than the preferred size you set with this property. You cannot change this property while the device is generating a waveform. If you want to change the device configuration, call the nifgen.Session.abort() method or wait for the generation to complete.

Note

:

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Data Transfer:Advanced:Preferred Packet Size

C Attribute: NIFGEN_ATTR_DATA_TRANSFER_PREFERRED_PACKET_SIZE

digital_data_mask¶

nifgen.Session.digital_data_mask¶

Specifies the mask to apply to the output on the digital connector. The masked data is replaced with the data in nifgen.Session.digital_static_value.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Data Mask:Digital Data Mask

C Attribute: NIFGEN_ATTR_DIGITAL_DATA_MASK

digital_edge_script_trigger_edge¶

nifgen.Session.digital_edge_script_trigger_edge¶

Specifies the active edge for the Script trigger. This property is used when nifgen.Session.script_trigger_type is set to Digital Edge.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.ScriptTriggerDigitalEdgeEdge

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Triggers:Script:Digital Edge:Edge

C Attribute: NIFGEN_ATTR_DIGITAL_EDGE_SCRIPT_TRIGGER_EDGE

digital_edge_script_trigger_source¶

nifgen.Session.digital_edge_script_trigger_source¶

Specifies the source terminal for the Script trigger. This property is used when nifgen.Session.script_trigger_type is set to Digital Edge.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Triggers:Script:Digital Edge:Source

C Attribute: NIFGEN_ATTR_DIGITAL_EDGE_SCRIPT_TRIGGER_SOURCE

digital_edge_start_trigger_edge¶

nifgen.Session.digital_edge_start_trigger_edge¶

Specifies the active edge for the Start trigger. This property is used only when nifgen.Session.start_trigger_type is set to Digital Edge.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.StartTriggerDigitalEdgeEdge

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Triggers:Start:Digital Edge:Edge

C Attribute: NIFGEN_ATTR_DIGITAL_EDGE_START_TRIGGER_EDGE

digital_edge_start_trigger_source¶

nifgen.Session.digital_edge_start_trigger_source¶

Specifies the source terminal for the Start trigger. This property is used only when nifgen.Session.start_trigger_type is set to Digital Edge.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Triggers:Start:Digital Edge:Source

C Attribute: NIFGEN_ATTR_DIGITAL_EDGE_START_TRIGGER_SOURCE

digital_filter_enabled¶

nifgen.Session.digital_filter_enabled¶

Controls whether the signal generator applies a digital filter to the output signal. This property is valid in arbitrary waveform, arbitrary sequence, and script modes. This property can also be used in standard method and frequency list modes for user-defined waveforms.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Filters:Digital Filter Enabled

C Attribute: NIFGEN_ATTR_DIGITAL_FILTER_ENABLED

digital_filter_interpolation_factor¶

nifgen.Session.digital_filter_interpolation_factor¶

This property only affects the device when nifgen.Session.digital_filter_enabled is set to True. If you do not set this property directly, NI-FGEN automatically selects the maximum interpolation factor allowed for the current sample rate. Valid values are 2, 4, and 8.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Filters:Digital Filter Interpolation Factor

C Attribute: NIFGEN_ATTR_DIGITAL_FILTER_INTERPOLATION_FACTOR

digital_gain¶

nifgen.Session.digital_gain¶

Specifies a factor by which the signal generator digitally multiplies generated data before converting it to an analog signal in the DAC. For a digital gain greater than 1.0, the product of digital gain times the generated data must be inside the range plus or minus 1.0 (assuming floating point data). If the product exceeds these limits, the signal generator clips the output signal, and an error results. Some signal generators support both digital gain and an analog gain (analog gain is specified with the nifgen.Session.func_amplitude property or the nifgen.Session.arb_gain property). Digital gain can be changed during generation without the glitches that may occur when changing analog gains, due to relay switching. However, the DAC output resolution is a method of analog gain, so only analog gain makes full use of the resolution of the DAC.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Digital Gain

C Attribute: NIFGEN_ATTR_DIGITAL_GAIN

digital_level_script_trigger_active_level¶

nifgen.Session.digital_level_script_trigger_active_level¶

Specifies the active level for the Script trigger. This property is used when nifgen.Session.script_trigger_type is set to Digital Level.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.ScriptTriggerDigitalLevelActiveLevel

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Triggers:Script:Digital Level:Active Level

C Attribute: NIFGEN_ATTR_DIGITAL_LEVEL_SCRIPT_TRIGGER_ACTIVE_LEVEL

digital_level_script_trigger_source¶

nifgen.Session.digital_level_script_trigger_source¶

Specifies the source terminal for the Script trigger. This property is used when nifgen.Session.script_trigger_type is set to Digital Level.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Triggers:Script:Digital Level:Source

C Attribute: NIFGEN_ATTR_DIGITAL_LEVEL_SCRIPT_TRIGGER_SOURCE

digital_pattern_enabled¶

nifgen.Session.digital_pattern_enabled¶

Controls whether the signal generator generates a digital pattern of the output signal.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Advanced:Digital Pattern Enabled

C Attribute: NIFGEN_ATTR_DIGITAL_PATTERN_ENABLED

digital_static_value¶

nifgen.Session.digital_static_value¶

Specifies the static value that replaces data masked by nifgen.Session.digital_data_mask.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Data Mask:Digital Static Value

C Attribute: NIFGEN_ATTR_DIGITAL_STATIC_VALUE

direct_dma_enabled¶

nifgen.Session.direct_dma_enabled¶

Enable the device for Direct DMA writes. When enabled, all Create Waveform and Write Waveform method calls that are given a data address in the Direct DMA Window will download data residing on the Direct DMA device to the instrument’s onboard memory.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Data Transfer:Direct DMA:Direct DMA Enabled

C Attribute: NIFGEN_ATTR_DIRECT_DMA_ENABLED

direct_dma_window_address¶

nifgen.Session.direct_dma_window_address¶

Specifies the window address (beginning of window) of the waveform data source. This window address is specified by your Direct DMA-compatible data source.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Data Transfer:Direct DMA:Window Address

C Attribute: NIFGEN_ATTR_DIRECT_DMA_WINDOW_ADDRESS

direct_dma_window_size¶

nifgen.Session.direct_dma_window_size¶

Specifies the size of the memory window in bytes (not samples) provided by your Direct DMA-compatible data source.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Data Transfer:Direct DMA:Window Size in Bytes

C Attribute: NIFGEN_ATTR_DIRECT_DMA_WINDOW_SIZE

done_event_delay¶

nifgen.Session.done_event_delay¶

Specifies the amount of delay applied to a Done Event with respect to the analog output of the signal generator. A positive delay value indicates that the Done Event will come out after the analog data, while a negative delay value indicates that the Done Event will come out before the analog data. The default value is zero, which will align the Done Event with the analog output. You can specify the units of the delay value by setting the nifgen.Session.done_event_delay property.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Done:Advanced:Delay Value

C Attribute: NIFGEN_ATTR_DONE_EVENT_DELAY

done_event_delay_units¶

nifgen.Session.done_event_delay_units¶

Specifies the units applied to the value of the nifgen.Session.done_event_delay property. Valid units are seconds and sample clock periods.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.DoneEventDelayUnits

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Done:Advanced:Delay Units

C Attribute: NIFGEN_ATTR_DONE_EVENT_DELAY_UNITS

done_event_latched_status¶

nifgen.Session.done_event_latched_status¶

Returns the latched status of the specified Done Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Done:Advanced:Latched Status

C Attribute: NIFGEN_ATTR_DONE_EVENT_LATCHED_STATUS

done_event_level_active_level¶

nifgen.Session.done_event_level_active_level¶

Specifies the output polarity of the Done Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.DoneEventActiveLevel

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Done:Level:Active Level

C Attribute: NIFGEN_ATTR_DONE_EVENT_LEVEL_ACTIVE_LEVEL

done_event_output_behavior¶

nifgen.Session.done_event_output_behavior¶

Specifies the output behavior for the Done Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.DoneEventOutputBehavior

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Done:Output Behavior

C Attribute: NIFGEN_ATTR_DONE_EVENT_OUTPUT_BEHAVIOR

done_event_output_terminal¶

nifgen.Session.done_event_output_terminal¶

Specifies the destination terminal for the Done Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Done:Output Terminal

C Attribute: NIFGEN_ATTR_DONE_EVENT_OUTPUT_TERMINAL

done_event_pulse_polarity¶

nifgen.Session.done_event_pulse_polarity¶

Specifies the output polarity of the Done Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.DoneEventPulsePolarity

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Done:Pulse:Polarity

C Attribute: NIFGEN_ATTR_DONE_EVENT_PULSE_POLARITY

done_event_pulse_width¶

nifgen.Session.done_event_pulse_width¶

Specifies the pulse width for the Done Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Done:Pulse:Width Value

C Attribute: NIFGEN_ATTR_DONE_EVENT_PULSE_WIDTH

done_event_pulse_width_units¶

nifgen.Session.done_event_pulse_width_units¶

Specifies the pulse width units for the Done Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.DoneEventPulseWidthUnits

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Done:Pulse:Width Units

C Attribute: NIFGEN_ATTR_DONE_EVENT_PULSE_WIDTH_UNITS

driver_setup¶

nifgen.Session.driver_setup¶

Specifies the driver setup portion of the option string that was passed into the nifgen.Session.InitWithOptions() method.

Note

One or more of the referenced methods are not in the Python API for this driver.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read only

Channel Based 0

Resettable 0

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

C Attribute: NIFGEN_ATTR_DRIVER_SETUP

exported_onboard_reference_clock_output_terminal¶

nifgen.Session.exported_onboard_reference_clock_output_terminal¶

Specifies the terminal to which to export the Onboard Reference Clock.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Reference Clock:Onboard Reference Clock:Export Output Terminal

C Attribute: NIFGEN_ATTR_EXPORTED_ONBOARD_REFERENCE_CLOCK_OUTPUT_TERMINAL

exported_reference_clock_output_terminal¶

nifgen.Session.exported_reference_clock_output_terminal¶

Specifies the terminal to which to export the Reference Clock.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Reference Clock:Export Output Terminal

C Attribute: NIFGEN_ATTR_EXPORTED_REFERENCE_CLOCK_OUTPUT_TERMINAL

exported_sample_clock_divisor¶

nifgen.Session.exported_sample_clock_divisor¶

Specifies the factor by which to divide the Sample clock, also known as the Update clock, before it is exported. To export the Sample clock, use the nifgen.Session.ExportSignal() method or the nifgen.Session.exported_sample_clock_output_terminal property.

Note

One or more of the referenced methods are not in the Python API for this driver.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Sample Clock:Exported Sample Clock Divisor

C Attribute: NIFGEN_ATTR_EXPORTED_SAMPLE_CLOCK_DIVISOR

exported_sample_clock_output_terminal¶

nifgen.Session.exported_sample_clock_output_terminal¶

Specifies the terminal to which to export the Sample Clock.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Sample Clock:Export Output Terminal

C Attribute: NIFGEN_ATTR_EXPORTED_SAMPLE_CLOCK_OUTPUT_TERMINAL

exported_sample_clock_timebase_divisor¶

nifgen.Session.exported_sample_clock_timebase_divisor¶

Specifies the factor by which to divide the sample clock timebase (board clock) before it is exported. To export the Sample clock timebase, use the nifgen.Session.ExportSignal() method or the nifgen.Session.exported_sample_clock_timebase_output_terminal property.

Note

One or more of the referenced methods are not in the Python API for this driver.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Sample Clock Timebase:Exported Sample Clock Timebase Divisor

C Attribute: NIFGEN_ATTR_EXPORTED_SAMPLE_CLOCK_TIMEBASE_DIVISOR

exported_sample_clock_timebase_output_terminal¶

nifgen.Session.exported_sample_clock_timebase_output_terminal¶

Specifies the terminal to which to export the Sample clock timebase. If you specify a divisor with the nifgen.Session.exported_sample_clock_timebase_divisor property, the Sample clock exported with the nifgen.Session.exported_sample_clock_timebase_output_terminal property is the value of the Sample clock timebase after it is divided-down. For a list of the terminals available on your device, refer to the Device Routes tab in MAX. To change the device configuration, call nifgen.Session.abort() or wait for the generation to complete.

Note

The signal generator must not be in the Generating state when you change this property.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Sample Clock Timebase:Export Output Terminal

C Attribute: NIFGEN_ATTR_EXPORTED_SAMPLE_CLOCK_TIMEBASE_OUTPUT_TERMINAL

exported_script_trigger_output_terminal¶

nifgen.Session.exported_script_trigger_output_terminal¶

Specifies the output terminal for the exported Script trigger. Setting this property to an empty string means that when you commit the session, the signal is removed from that terminal and, if possible, the terminal is tristated.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Triggers:Script:Output Terminal

C Attribute: NIFGEN_ATTR_EXPORTED_SCRIPT_TRIGGER_OUTPUT_TERMINAL

exported_start_trigger_output_terminal¶

nifgen.Session.exported_start_trigger_output_terminal¶

Specifies the destination terminal for exporting the Start trigger.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Triggers:Start:Output Terminal

C Attribute: NIFGEN_ATTR_EXPORTED_START_TRIGGER_OUTPUT_TERMINAL

external_clock_delay_binary_value¶

nifgen.Session.external_clock_delay_binary_value¶

Binary value of the external clock delay.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Advanced:External Clock Delay Binary Value

C Attribute: NIFGEN_ATTR_EXTERNAL_CLOCK_DELAY_BINARY_VALUE

external_sample_clock_multiplier¶

nifgen.Session.external_sample_clock_multiplier¶

Specifies a multiplication factor to use to obtain a desired sample rate from an external Sample clock. The resulting sample rate is equal to this factor multiplied by the external Sample clock rate. You can use this property to generate samples at a rate higher than your external clock rate. When using this property, you do not need to explicitly set the external clock rate.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Advanced:External Sample Clock Multiplier

C Attribute: NIFGEN_ATTR_EXTERNAL_SAMPLE_CLOCK_MULTIPLIER

file_transfer_block_size¶

nifgen.Session.file_transfer_block_size¶

The number of samples at a time to read from the file and download to onboard memory. Used in conjunction with the Create From File and Write From File methods.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Data Transfer:File Transfer Block Size

C Attribute: NIFGEN_ATTR_FILE_TRANSFER_BLOCK_SIZE

filter_correction_frequency¶

nifgen.Session.filter_correction_frequency¶

Controls the filter correction frequency of the analog filter. This property corrects for the ripples in the analog filter frequency response at the frequency specified. For standard waveform output, the filter correction frequency should be set to be the same as the frequency of the standard waveform. To have no filter correction, set this property to 0 Hz.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:5401/5411/5431:Filter Correction Frequency

C Attribute: NIFGEN_ATTR_FILTER_CORRECTION_FREQUENCY

flatness_correction_enabled¶

nifgen.Session.flatness_correction_enabled¶

When True, the signal generator applies a flatness correction factor to the generated sine wave in order to ensure the same output power level at all frequencies. This property should be set to False when performing Flatness Calibration.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Filters:Flatness Correction Enabled

C Attribute: NIFGEN_ATTR_FLATNESS_CORRECTION_ENABLED

fpga_bitfile_path¶

nifgen.Session.fpga_bitfile_path¶

Gets the absolute file path to the bitfile loaded on the FPGA.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:FPGA Bitfile Path

C Attribute: NIFGEN_ATTR_FPGA_BITFILE_PATH

freq_list_duration_quantum¶

nifgen.Session.freq_list_duration_quantum¶

Returns the quantum of which all durations must be a multiple in a frequency list.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Frequency List Mode:Frequency List Duration Quantum

C Attribute: NIFGEN_ATTR_FREQ_LIST_DURATION_QUANTUM

freq_list_handle¶

nifgen.Session.freq_list_handle¶

Sets which frequency list the signal generator produces. Create a frequency list using nifgen.Session.create_freq_list(). nifgen.Session.create_freq_list() returns a handle that you can use to identify the list.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Frequency List Mode:Frequency List Handle

C Attribute: NIFGEN_ATTR_FREQ_LIST_HANDLE

func_amplitude¶

nifgen.Session.func_amplitude¶

Controls the amplitude of the standard waveform that the signal generator produces. This value is the amplitude at the output terminal. For example, to produce a waveform ranging from -5.00 V to +5.00 V, set the amplitude to 10.00 V. set the Waveform parameter to DC. Units: Vpk-pk

Note

This parameter does not affect signal generator behavior when you

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Amplitude

C Attribute: NIFGEN_ATTR_FUNC_AMPLITUDE

func_buffer_size¶

nifgen.Session.func_buffer_size¶

This property contains the number of samples used in the standard method waveform buffer. This property is only valid on devices that implement standard method mode in software, and is read-only for all other devices. implementation of Standard Method Mode on your device.

Note

Refer to the Standard Method Mode topic for more information on the

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Standard Function Mode:Buffer Size

C Attribute: NIFGEN_ATTR_FUNC_BUFFER_SIZE

func_dc_offset¶

nifgen.Session.func_dc_offset¶

Controls the DC offset of the standard waveform that the signal generator produces. This value is the offset at the output terminal. The value is the offset from ground to the center of the waveform that you specify with the Waveform parameter. For example, to configure a waveform with an amplitude of 10.00 V to range from 0.00 V to +10.00 V, set DC Offset to 5.00 V. Units: volts

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:DC Offset

C Attribute: NIFGEN_ATTR_FUNC_DC_OFFSET

func_duty_cycle_high¶

nifgen.Session.func_duty_cycle_high¶

Controls the duty cycle of the square wave the signal generator produces. Specify this property as a percentage of the time the square wave is high in a cycle. set the Waveform parameter to SQUARE. Units: Percentage of time the waveform is high

Note

This parameter only affects signal generator behavior when you

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Duty Cycle High

C Attribute: NIFGEN_ATTR_FUNC_DUTY_CYCLE_HIGH

func_frequency¶

nifgen.Session.func_frequency¶

Controls the frequency of the standard waveform that the signal generator produces. Units: hertz (1) This parameter does not affect signal generator behavior when you set the Waveform parameter of the nifgen.Session.configure_standard_waveform() method to DC. (2) For SINE, the range is between 0 MHz and 16 MHz, but the range is between 0 MHz and 1 MHz for all other waveforms.

Note

:

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Standard Function Mode:Frequency

C Attribute: NIFGEN_ATTR_FUNC_FREQUENCY

func_max_buffer_size¶

nifgen.Session.func_max_buffer_size¶

This property sets the maximum number of samples that can be used in the standard method waveform buffer. Increasing this value may increase the quality of the waveform. This property is only valid on devices that implement standard method mode in software, and is read-only for all other devices. implementation of Standard Method Mode on your device.

Note

Refer to the Standard Method Mode topic for more information on the

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Standard Function Mode:Maximum Buffer Size

C Attribute: NIFGEN_ATTR_FUNC_MAX_BUFFER_SIZE

func_start_phase¶

nifgen.Session.func_start_phase¶

Controls horizontal offset of the standard waveform the signal generator produces. Specify this property in degrees of one waveform cycle. A start phase of 180 degrees means output generation begins halfway through the waveform. A start phase of 360 degrees offsets the output by an entire waveform cycle, which is identical to a start phase of 0 degrees. set the Waveform parameter to DC. Units: Degrees of one cycle

Note

This parameter does not affect signal generator behavior when you

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Start Phase

C Attribute: NIFGEN_ATTR_FUNC_START_PHASE

func_waveform¶

nifgen.Session.func_waveform¶

This channel-based property specifies which standard waveform the signal generator produces. Use this property only when nifgen.Session.output_mode is set to FUNC. SINE - Sinusoid waveform SQUARE - Square waveform TRIANGLE - Triangle waveform RAMP_UP - Positive ramp waveform RAMP_DOWN - Negative ramp waveform DC - Constant voltage NOISE - White noise USER - User-defined waveform as defined with nifgen.Session.define_user_standard_waveform()

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.Waveform

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Waveform

C Attribute: NIFGEN_ATTR_FUNC_WAVEFORM

gain_dac_value¶

nifgen.Session.gain_dac_value¶

Specifies the value programmed to the gain DAC. The value should be treated as an unsigned, right-justified number.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Calibration:Gain DAC Value

C Attribute: NIFGEN_ATTR_GAIN_DAC_VALUE

idle_behavior¶

nifgen.Session.idle_behavior¶

Specifies the behavior of the output during the Idle state. The output can be configured to hold the last generated voltage before entering the Idle state or jump to the Idle Value.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.IdleBehavior

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Advanced:Idle Behavior

C Attribute: NIFGEN_ATTR_IDLE_BEHAVIOR

idle_value¶

nifgen.Session.idle_value¶

Specifies the value to generate in the Idle state. The Idle Behavior must be configured to jump to this value.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Advanced:Idle Value

C Attribute: NIFGEN_ATTR_IDLE_VALUE

id_query_response¶

nifgen.Session.id_query_response¶

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read only

Channel Based 0

Resettable 0

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

C Attribute: NIFGEN_ATTR_ID_QUERY_RESPONSE

instrument_firmware_revision¶

nifgen.Session.instrument_firmware_revision¶

A string that contains the firmware revision information for the device that you are currently using.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Inherent IVI Attributes:Instrument Identification:Firmware Revision

C Attribute: NIFGEN_ATTR_INSTRUMENT_FIRMWARE_REVISION

instrument_manufacturer¶

nifgen.Session.instrument_manufacturer¶

A string that contains the name of the device manufacturer you are currently using.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Inherent IVI Attributes:Instrument Identification:Manufacturer

C Attribute: NIFGEN_ATTR_INSTRUMENT_MANUFACTURER

instrument_model¶

nifgen.Session.instrument_model¶

A string that contains the model number or name of the device that you are currently using.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Inherent IVI Attributes:Instrument Identification:Model

C Attribute: NIFGEN_ATTR_INSTRUMENT_MODEL

io_resource_descriptor¶

nifgen.Session.io_resource_descriptor¶

Indicates the resource descriptor that NI-FGEN uses to identify the physical device. If you initialize NI-FGEN with a logical name, this property contains the resource descriptor that corresponds to the entry in the IVI Configuration Utility. If you initialize NI-FGEN with the resource descriptor, this property contains that value.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Inherent IVI Attributes:Advanced Session Information:Resource Descriptor

C Attribute: NIFGEN_ATTR_IO_RESOURCE_DESCRIPTOR

load_impedance¶

nifgen.Session.load_impedance¶

This channel-based property specifies the load impedance connected to the analog output of the channel. If you set this property to NIFGEN_VAL_MATCHED_LOAD_IMPEDANCE (-1.0), NI-FGEN assumes that the load impedance matches the output impedance. NI-FGEN compensates to give the desired peak-to-peak voltage amplitude or arbitrary gain (relative to 1 V).

Note

One or more of the referenced values are not in the Python API for this driver. Enums that only define values, or represent True/False, have been removed.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Load Impedance

C Attribute: NIFGEN_ATTR_LOAD_IMPEDANCE

logical_name¶

nifgen.Session.logical_name¶

A string containing the logical name that you specified when opening the current IVI session. You may pass a logical name to nifgen.Session.init() or nifgen.Session.InitWithOptions(). The IVI Configuration Utility must contain an entry for the logical name. The logical name entry refers to a virtual instrument section in the IVI Configuration file. The virtual instrument section specifies a physical device and initial user options.

Note

One or more of the referenced methods are not in the Python API for this driver.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Inherent IVI Attributes:Advanced Session Information:Logical Name

C Attribute: NIFGEN_ATTR_LOGICAL_NAME

major_version¶

nifgen.Session.major_version¶

Returns the major version number of NI-FGEN.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Obsolete:Major Version

C Attribute: NIFGEN_ATTR_MAJOR_VERSION

marker_events_count¶

nifgen.Session.marker_events_count¶

Returns the number of markers supported by the device. Use this property when nifgen.Session.output_mode is set to SCRIPT.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Marker Events Count

C Attribute: NIFGEN_ATTR_MARKER_EVENTS_COUNT

marker_event_delay¶

nifgen.Session.marker_event_delay¶

Specifies the amount of delay applied to a Marker Event with respect to the analog output of the signal generator. A positive delay value indicates that the Marker Event will come out after the analog data, while a negative delay value indicates that the Marker Event will come out before the analog data. The default value is zero, which will align the Marker Event with the analog output. You can specify the units of the delay value by setting the nifgen.Session.marker_event_delay property.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Marker:Advanced:Delay Value

C Attribute: NIFGEN_ATTR_MARKER_EVENT_DELAY

marker_event_delay_units¶

nifgen.Session.marker_event_delay_units¶

Specifies the units applied to the value of the nifgen.Session.marker_event_delay property. Valid units are seconds and sample clock periods.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.MarkerEventDelayUnits

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Marker:Advanced:Delay Units

C Attribute: NIFGEN_ATTR_MARKER_EVENT_DELAY_UNITS

marker_event_latched_status¶

nifgen.Session.marker_event_latched_status¶

Specifies the latched status of the specified Marker Event. Write True to this property to clear the latched status of the Marker Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Marker:Advanced:Latched Status

C Attribute: NIFGEN_ATTR_MARKER_EVENT_LATCHED_STATUS

marker_event_live_status¶

nifgen.Session.marker_event_live_status¶

Returns the live status of the specified Marker Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Marker:Advanced:Live Status

C Attribute: NIFGEN_ATTR_MARKER_EVENT_LIVE_STATUS

marker_event_output_behavior¶

nifgen.Session.marker_event_output_behavior¶

Specifies the output behavior for the Marker Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.MarkerEventOutputBehavior

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Marker:Output Behavior

C Attribute: NIFGEN_ATTR_MARKER_EVENT_OUTPUT_BEHAVIOR

marker_event_output_terminal¶

nifgen.Session.marker_event_output_terminal¶

Specifies the destination terminal for the Marker Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Marker:Output Terminal

C Attribute: NIFGEN_ATTR_MARKER_EVENT_OUTPUT_TERMINAL

marker_event_pulse_polarity¶

nifgen.Session.marker_event_pulse_polarity¶

Specifies the output polarity of the Marker Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.MarkerEventPulsePolarity

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Marker:Pulse:Polarity

C Attribute: NIFGEN_ATTR_MARKER_EVENT_PULSE_POLARITY

marker_event_pulse_width¶

nifgen.Session.marker_event_pulse_width¶

Specifies the pulse width for the Marker Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Marker:Pulse:Width Value

C Attribute: NIFGEN_ATTR_MARKER_EVENT_PULSE_WIDTH

marker_event_pulse_width_units¶

nifgen.Session.marker_event_pulse_width_units¶

Specifies the pulse width units for the Marker Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.MarkerEventPulseWidthUnits

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Marker:Pulse:Width Units

C Attribute: NIFGEN_ATTR_MARKER_EVENT_PULSE_WIDTH_UNITS

marker_event_toggle_initial_state¶

nifgen.Session.marker_event_toggle_initial_state¶

Specifies the output polarity of the Marker Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.MarkerEventToggleInitialState

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Marker:Toggle:Initial State

C Attribute: NIFGEN_ATTR_MARKER_EVENT_TOGGLE_INITIAL_STATE

max_freq_list_duration¶

nifgen.Session.max_freq_list_duration¶

Returns the maximum duration of any one step in the frequency list.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Frequency List Mode:Maximum Frequency List Duration

C Attribute: NIFGEN_ATTR_MAX_FREQ_LIST_DURATION

max_freq_list_length¶

nifgen.Session.max_freq_list_length¶

Returns the maximum number of steps that can be in a frequency list.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Frequency List Mode:Maximum Frequency List Length

C Attribute: NIFGEN_ATTR_MAX_FREQ_LIST_LENGTH

max_loop_count¶

nifgen.Session.max_loop_count¶

Returns the maximum number of times that the signal generator can repeat a waveform in a sequence. Typically, this value is constant for the signal generator.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Arbitrary Sequence Mode:Max Loop Count

C Attribute: NIFGEN_ATTR_MAX_LOOP_COUNT

max_num_freq_lists¶

nifgen.Session.max_num_freq_lists¶

Returns the maximum number of frequency lists the signal generator allows.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Frequency List Mode:Maximum Number Of Frequency Lists

C Attribute: NIFGEN_ATTR_MAX_NUM_FREQ_LISTS

max_num_sequences¶

nifgen.Session.max_num_sequences¶

Returns the maximum number of arbitrary sequences that the signal generator allows. Typically, this value is constant for the signal generator.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Arbitrary Sequence Mode:Max Number of Sequences

C Attribute: NIFGEN_ATTR_MAX_NUM_SEQUENCES

max_num_waveforms¶

nifgen.Session.max_num_waveforms¶

Returns the maximum number of arbitrary waveforms that the signal generator allows. Typically, this value is constant for the signal generator.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Capabilities:Max Number of Waveforms

C Attribute: NIFGEN_ATTR_MAX_NUM_WAVEFORMS

max_sequence_length¶

nifgen.Session.max_sequence_length¶

Returns the maximum number of arbitrary waveforms that the signal generator allows in a sequence. Typically, this value is constant for the signal generator.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Arbitrary Sequence Mode:Max Sequence Length

C Attribute: NIFGEN_ATTR_MAX_SEQUENCE_LENGTH

max_waveform_size¶

nifgen.Session.max_waveform_size¶

Returns the size, in samples, of the largest waveform that can be created. This property reflects the space currently available, taking into account previously allocated waveforms and instructions.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Capabilities:Max Waveform Size

C Attribute: NIFGEN_ATTR_MAX_WAVEFORM_SIZE

memory_size¶

nifgen.Session.memory_size¶

The total amount of memory, in bytes, on the signal generator.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Memory Size

C Attribute: NIFGEN_ATTR_MEMORY_SIZE

minor_version¶

nifgen.Session.minor_version¶

Returns the minor version number of NI-FGEN.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Obsolete:Minor Version

C Attribute: NIFGEN_ATTR_MINOR_VERSION

min_freq_list_duration¶

nifgen.Session.min_freq_list_duration¶

Returns the minimum number of steps that can be in a frequency list.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Frequency List Mode:Minimum Frequency List Duration

C Attribute: NIFGEN_ATTR_MIN_FREQ_LIST_DURATION

min_freq_list_length¶

nifgen.Session.min_freq_list_length¶

Returns the minimum number of frequency lists that the signal generator allows.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Frequency List Mode:Minimum Frequency List Length

C Attribute: NIFGEN_ATTR_MIN_FREQ_LIST_LENGTH

min_sequence_length¶

nifgen.Session.min_sequence_length¶

Returns the minimum number of arbitrary waveforms that the signal generator allows in a sequence. Typically, this value is constant for the signal generator.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Arbitrary Sequence Mode:Min Sequence Length

C Attribute: NIFGEN_ATTR_MIN_SEQUENCE_LENGTH

min_waveform_size¶

nifgen.Session.min_waveform_size¶

Returns the minimum number of points that the signal generator allows in an arbitrary waveform. Typically, this value is constant for the signal generator.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Capabilities:Min Waveform Size

C Attribute: NIFGEN_ATTR_MIN_WAVEFORM_SIZE

module_revision¶

nifgen.Session.module_revision¶

A string that contains the module revision for the device that you are currently using.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Inherent IVI Attributes:Instrument Identification:Module Revision

C Attribute: NIFGEN_ATTR_MODULE_REVISION

num_channels¶

nifgen.Session.num_channels¶

Indicates the number of channels that the specific instrument driver supports. For each property for which IVI_VAL_MULTI_CHANNEL is set, the IVI Engine maintains a separate cache value for each channel.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Inherent IVI Attributes:Driver Capabilities:Channel Count

C Attribute: NIFGEN_ATTR_NUM_CHANNELS

offset_dac_value¶

nifgen.Session.offset_dac_value¶

Specifies the value programmed to the offset DAC. The value should be treated as an unsigned, right-justified number.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Calibration:Offset DAC Value

C Attribute: NIFGEN_ATTR_OFFSET_DAC_VALUE

oscillator_freq_dac_value¶

nifgen.Session.oscillator_freq_dac_value¶

Specifies the value programmed to the oscillator frequency DAC. The value should be treated as an unsigned, right-justified number.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Calibration:Oscillator Freq DAC Value

C Attribute: NIFGEN_ATTR_OSCILLATOR_FREQ_DAC_VALUE

oscillator_phase_dac_value¶

nifgen.Session.oscillator_phase_dac_value¶

The value of the oscillator phase DAC.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Advanced:Oscillator Phase DAC Value

C Attribute: NIFGEN_ATTR_OSCILLATOR_PHASE_DAC_VALUE

osp_carrier_enabled¶

nifgen.Session.osp_carrier_enabled¶

Enables or disables generation of the carrier.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:Carrier Enabled

C Attribute: NIFGEN_ATTR_OSP_CARRIER_ENABLED

osp_carrier_frequency¶

nifgen.Session.osp_carrier_frequency¶

The frequency of the generated carrier.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:Carrier Frequency

C Attribute: NIFGEN_ATTR_OSP_CARRIER_FREQUENCY

osp_carrier_phase_i¶

nifgen.Session.osp_carrier_phase_i¶

I Carrier Phase in degrees at the first point of the generation.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:IQ Signal Adjustments:Carrier Phase:Carrier Phase I

C Attribute: NIFGEN_ATTR_OSP_CARRIER_PHASE_I

osp_carrier_phase_q¶

nifgen.Session.osp_carrier_phase_q¶

Q Carrier Phase in degrees at the first point of the generation. This property is only used when the nifgen.Session.osp_data_processing_mode property is set to COMPLEX.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:IQ Signal Adjustments:Carrier Phase:Carrier Phase Q

C Attribute: NIFGEN_ATTR_OSP_CARRIER_PHASE_Q

osp_cic_filter_enabled¶

nifgen.Session.osp_cic_filter_enabled¶

Enables or disables the CIC filter. The nifgen.Session.osp_cic_filter_enabled and nifgen.Session.osp_fir_filter_enabled properties must have the same enable/disable setting.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:Advanced:CIC Filter Enabled

C Attribute: NIFGEN_ATTR_OSP_CIC_FILTER_ENABLED

osp_cic_filter_gain¶

nifgen.Session.osp_cic_filter_gain¶

Gain applied at the final stage of the CIC filter. Commonly used to compensate for attenuation in the FIR filter. For FIR filter types other than Custom, NI-FGEN calculates the CIC gain in order to achieve unity gain between the FIR and CIC filters. Setting this property overrides the value set by NI-FGEN.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:Advanced:CIC Filter Gain

C Attribute: NIFGEN_ATTR_OSP_CIC_FILTER_GAIN

osp_cic_filter_interpolation¶

nifgen.Session.osp_cic_filter_interpolation¶

Interpolation factor for the CIC filter. If you do not set this value, NI-FGEN calculates the appropriate value based on the value of the nifgen.Session.osp_iq_rate property.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:Advanced:CIC Interpolation Factor

C Attribute: NIFGEN_ATTR_OSP_CIC_FILTER_INTERPOLATION

osp_compensate_for_filter_group_delay¶

nifgen.Session.osp_compensate_for_filter_group_delay¶

Compensate for OSP Filter Group Delay. If this is enabled, the Event Outputs will be aligned with the Analog Output. The Analog output will also be aligned between synchronized devices (using NI-TClk).

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:Advanced:Compensate for Filter Group Delay

C Attribute: NIFGEN_ATTR_OSP_COMPENSATE_FOR_FILTER_GROUP_DELAY

osp_data_processing_mode¶

nifgen.Session.osp_data_processing_mode¶

The way in which data is processed by the OSP block.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.DataProcessingMode

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:Data Processing Mode

C Attribute: NIFGEN_ATTR_OSP_DATA_PROCESSING_MODE

osp_enabled¶

nifgen.Session.osp_enabled¶

Enables or disables the OSP block of the signal generator. When the OSP block is disabled, all OSP-related properties are disabled and have no effect on the generated signal.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:OSP Enabled

C Attribute: NIFGEN_ATTR_OSP_ENABLED

osp_fir_filter_enabled¶

nifgen.Session.osp_fir_filter_enabled¶

Enables or disables the FIR filter. The nifgen.Session.osp_cic_filter_enabled and nifgen.Session.osp_fir_filter_enabled properties must have the same enable/disable setting.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:Advanced:FIR Filter Enabled

C Attribute: NIFGEN_ATTR_OSP_FIR_FILTER_ENABLED

osp_fir_filter_flat_passband¶

nifgen.Session.osp_fir_filter_flat_passband¶

Passband value to use when calculating the FIR filter coefficients. The FIR filter is designed to be flat to passband × IQ rate. This property is used only when the nifgen.Session.osp_fir_filter_type property is set to FLAT.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:FIR Filter:Flat:Passband

C Attribute: NIFGEN_ATTR_OSP_FIR_FILTER_FLAT_PASSBAND

osp_fir_filter_gaussian_bt¶

nifgen.Session.osp_fir_filter_gaussian_bt¶

BT value to use when calculating the pulse-shaping FIR filter coefficients. Only used when the nifgen.Session.osp_fir_filter_type property is set to GAUSSIAN.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:FIR Filter:Gaussian:BT

C Attribute: NIFGEN_ATTR_OSP_FIR_FILTER_GAUSSIAN_BT

osp_fir_filter_interpolation¶

nifgen.Session.osp_fir_filter_interpolation¶

Interpolation factor for the FIR filter. If you do not set this value, NI-FGEN calculates the appropriate value based on the value of the nifgen.Session.osp_iq_rate property.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:Advanced:FIR Interpolation Factor

C Attribute: NIFGEN_ATTR_OSP_FIR_FILTER_INTERPOLATION

osp_fir_filter_raised_cosine_alpha¶

nifgen.Session.osp_fir_filter_raised_cosine_alpha¶

Alpha value to use when calculating the pulse shaping FIR filter coefficients. Only used when the nifgen.Session.osp_fir_filter_type property is set to RAISED_COSINE.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:FIR Filter:Raised Cosine:Alpha

C Attribute: NIFGEN_ATTR_OSP_FIR_FILTER_RAISED_COSINE_ALPHA

osp_fir_filter_root_raised_cosine_alpha¶

nifgen.Session.osp_fir_filter_root_raised_cosine_alpha¶

Alpha value to use when calculating the pulse-shaping FIR filter coefficients. This property is used only when the nifgen.Session.osp_fir_filter_type property is set to ROOT_RAISED_COSINE.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:FIR Filter:Root Raised Cosine:Alpha

C Attribute: NIFGEN_ATTR_OSP_FIR_FILTER_ROOT_RAISED_COSINE_ALPHA

osp_fir_filter_type¶

nifgen.Session.osp_fir_filter_type¶

Pulse-shaping filter type for the FIR filter.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.FilterType

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:FIR Filter:Filter Type

C Attribute: NIFGEN_ATTR_OSP_FIR_FILTER_TYPE

osp_frequency_shift¶

nifgen.Session.osp_frequency_shift¶

Specifies the amount of frequency shift applied to the baseband signal.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:Frequency Shift

C Attribute: NIFGEN_ATTR_OSP_FREQUENCY_SHIFT

osp_mode¶

nifgen.Session.osp_mode¶

Specifies the generation mode of the OSP, which determines the type of data contained in the output signal.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.OSPMode

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:OSP Mode

C Attribute: NIFGEN_ATTR_OSP_MODE

osp_overflow_error_reporting¶

nifgen.Session.osp_overflow_error_reporting¶

Configures error reporting when the OSP block detects an overflow in any of its stages. Overflows lead to clipping of the waveform. You can use the nifgen.Session.osp_overflow_status property to query for overflow conditions whether or not the nifgen.Session.osp_overflow_error_reporting property is enabled. The device will continue to generate after an overflow whether or not the nifgen.Session.osp_overflow_error_reporting property is enabled.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.OSPOverflowErrorReporting

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:Advanced:OSP Overflow Error Reporting

C Attribute: NIFGEN_ATTR_OSP_OVERFLOW_ERROR_REPORTING

osp_overflow_status¶

nifgen.Session.osp_overflow_status¶

Returns a bit field of the overflow status in any stage of the OSP block. This property is functional regardless of the value for the nifgen.Session.osp_overflow_error_reporting property. Write 0 to this property to clear the current nifgen.Session.osp_overflow_error_reporting value.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:Advanced:OSP Overflow Status

C Attribute: NIFGEN_ATTR_OSP_OVERFLOW_STATUS

osp_pre_filter_gain_i¶

nifgen.Session.osp_pre_filter_gain_i¶

Digital gain to apply to the I data stream before any filtering by the OSP block.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:IQ Signal Adjustments:Gain:Pre-filter Gain I

C Attribute: NIFGEN_ATTR_OSP_PRE_FILTER_GAIN_I

osp_pre_filter_gain_q¶

nifgen.Session.osp_pre_filter_gain_q¶

Digital gain to apply to the Q data stream before any filtering by the OSP block. This property is only used when the nifgen.Session.osp_data_processing_mode property is set to COMPLEX.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:IQ Signal Adjustments:Gain:Pre-filter Gain Q

C Attribute: NIFGEN_ATTR_OSP_PRE_FILTER_GAIN_Q

osp_pre_filter_offset_i¶

nifgen.Session.osp_pre_filter_offset_i¶

Digital offset to apply to the I data stream. This offset is applied after the Pre-Filter Gain and before any filtering.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:IQ Signal Adjustments:Offset:Pre-filter Offset I

C Attribute: NIFGEN_ATTR_OSP_PRE_FILTER_OFFSET_I

osp_pre_filter_offset_q¶

nifgen.Session.osp_pre_filter_offset_q¶

Digital offset to apply to the Q data stream. This offset is applied after the Pre-Filter Gain and before any filtering. This property is used only when the nifgen.Session.osp_data_processing_mode property is set to COMPLEX.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Onboard Signal Processing:IQ Signal Adjustments:Offset:Pre-filter Offset Q

C Attribute: NIFGEN_ATTR_OSP_PRE_FILTER_OFFSET_Q

output_enabled¶

nifgen.Session.output_enabled¶

This channel-based property specifies whether the signal that the signal generator produces appears at the output connector.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Output Enabled

C Attribute: NIFGEN_ATTR_OUTPUT_ENABLED

output_impedance¶

nifgen.Session.output_impedance¶

This channel-based property specifies the signal generator output impedance at the output connector. NI signal sources modules have an output impedance of 50 ohms and an optional 75 ohms on select modules. If the load impedance matches the output impedance, then the voltage at the signal output connector is at the needed level. The voltage at the signal output connector varies with load output impedance, up to doubling the voltage for a high-impedance load.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Output Impedance

C Attribute: NIFGEN_ATTR_OUTPUT_IMPEDANCE

output_mode¶

nifgen.Session.output_mode¶

Sets which output mode the signal generator will use. The value you specify determines which methods and properties you use to configure the waveform the signal generator produces.

Note

The signal generator must not be in the Generating state when you change this property. To change the device configuration, call nifgen.Session.abort() or wait for the generation to complete.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.OutputMode

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Output Mode

C Attribute: NIFGEN_ATTR_OUTPUT_MODE

p2p_endpoint_fullness_start_trigger_level¶

nifgen.Session.p2p_endpoint_fullness_start_trigger_level¶

Specifies the Endpoint threshold for the Start trigger. This property is used only when nifgen.Session.start_trigger_type is set to P2P Endpoint Fullness.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Triggers:Start:P2P Endpoint Fullness:Level

C Attribute: NIFGEN_ATTR_P2P_ENDPOINT_FULLNESS_START_TRIGGER_LEVEL

pci_dma_optimizations_enabled¶

nifgen.Session.pci_dma_optimizations_enabled¶

Controls whether or not NI-FGEN allows performance optimizations for DMA transfers. This property is only valid for PCI and PXI SMC-based devices. This property is enabled (True) by default, and NI recommends leaving it enabled.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Data Transfer:Advanced:PCI DMA Optimizations Enabled

C Attribute: NIFGEN_ATTR_PCI_DMA_OPTIMIZATIONS_ENABLED

post_amplifier_attenuation¶

nifgen.Session.post_amplifier_attenuation¶

Specifies the amount of post-amplifier attenuation that should be applied to the signal (in dB).

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Calibration:Post-Amplifier Attenuation

C Attribute: NIFGEN_ATTR_POST_AMPLIFIER_ATTENUATION

pre_amplifier_attenuation¶

nifgen.Session.pre_amplifier_attenuation¶

Specifies the amount of pre-amplifier attenuation that should be applied to the signal (in dB).

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Calibration:Pre-Amplifier Attenuation

C Attribute: NIFGEN_ATTR_PRE_AMPLIFIER_ATTENUATION

ready_for_start_event_level_active_level¶

nifgen.Session.ready_for_start_event_level_active_level¶

Specifies the output polarity of the Ready for Start Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.ReadyForStartEventActiveLevel

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Ready For Start:Level:Active Level

C Attribute: NIFGEN_ATTR_READY_FOR_START_EVENT_LEVEL_ACTIVE_LEVEL

ready_for_start_event_live_status¶

nifgen.Session.ready_for_start_event_live_status¶

Returns the live status of the specified Ready For Start Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Ready For Start:Advanced:Live Status

C Attribute: NIFGEN_ATTR_READY_FOR_START_EVENT_LIVE_STATUS

ready_for_start_event_output_terminal¶

nifgen.Session.ready_for_start_event_output_terminal¶

Specifies the destination terminal for the Ready for Start Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Ready For Start:Output Terminal

C Attribute: NIFGEN_ATTR_READY_FOR_START_EVENT_OUTPUT_TERMINAL

reference_clock_source¶

nifgen.Session.reference_clock_source¶

Specifies the reference clock source used by the signal generator. The signal generator derives the frequencies and sample rates that it uses to generate waveforms from the source you specify. For example, when you set this property to ClkIn, the signal generator uses the signal it receives at the CLK IN front panel connector as the Reference clock. To change the device configuration, call nifgen.Session.abort() or wait for the generation to complete.

Note

The signal generator must not be in the Generating state when you change this property.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.ReferenceClockSource

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Reference Clock:Source

C Attribute: NIFGEN_ATTR_REFERENCE_CLOCK_SOURCE

ref_clock_frequency¶

nifgen.Session.ref_clock_frequency¶

Sets the frequency of the signal generator reference clock. The signal generator uses the reference clock to derive frequencies and sample rates when generating output.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Reference Clock:Frequency

C Attribute: NIFGEN_ATTR_REF_CLOCK_FREQUENCY

sample_clock_absolute_delay¶

nifgen.Session.sample_clock_absolute_delay¶

Specifies the absolute delay adjustment of the sample clock. The sample clock delay adjustment is expressed in seconds. can only be applied when an external sample clock is used.

Note

For the NI 5421, absolute delay

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Advanced:Sample Clock Absolute Delay

C Attribute: NIFGEN_ATTR_SAMPLE_CLOCK_ABSOLUTE_DELAY

sample_clock_source¶

nifgen.Session.sample_clock_source¶

Specifies the Sample clock source. If you specify a divisor with the nifgen.Session.exported_sample_clock_divisor property, the Sample clock exported with the nifgen.Session.exported_sample_clock_output_terminal property is the value of the Sample clock after it is divided-down. For a list of the terminals available on your device, refer to the Device Routes tab in MAX. To change the device configuration, call nifgen.Session.abort() or wait for the generation to complete.

Note

The signal generator must not be in the Generating state when you change this property.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.SampleClockSource

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Sample Clock:Source

C Attribute: NIFGEN_ATTR_SAMPLE_CLOCK_SOURCE

sample_clock_timebase_rate¶

nifgen.Session.sample_clock_timebase_rate¶

Specifies the Sample clock timebase rate. This property applies only to external Sample clock timebases. To change the device configuration, call nifgen.Session.abort() or wait for the generation to complete.

Note

The signal generator must not be in the Generating state when you change this property.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Sample Clock Timebase:Rate

C Attribute: NIFGEN_ATTR_SAMPLE_CLOCK_TIMEBASE_RATE

sample_clock_timebase_source¶

nifgen.Session.sample_clock_timebase_source¶

Specifies the Sample Clock Timebase source. To change the device configuration, call the nifgen.Session.abort() method or wait for the generation to complete.

Note

The signal generator must not be in the Generating state when you change this property.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.SampleClockTimebaseSource

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Clocks:Sample Clock Timebase:Source

C Attribute: NIFGEN_ATTR_SAMPLE_CLOCK_TIMEBASE_SOURCE

script_to_generate¶

nifgen.Session.script_to_generate¶

Specifies which script the generator produces. To configure the generator to run a particular script, set this property to the name of the script. Use nifgen.Session.write_script() to create multiple scripts. Use this property when nifgen.Session.output_mode is set to SCRIPT.

Note

The signal generator must not be in the Generating state when you change this property. To change the device configuration, call nifgen.Session.abort() or wait for the generation to complete.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Script Mode:Script to Generate

C Attribute: NIFGEN_ATTR_SCRIPT_TO_GENERATE

script_triggers_count¶

nifgen.Session.script_triggers_count¶

Specifies the number of Script triggers supported by the device. Use this property when nifgen.Session.output_mode is set to SCRIPT.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Script Triggers Count

C Attribute: NIFGEN_ATTR_SCRIPT_TRIGGERS_COUNT

script_trigger_type¶

nifgen.Session.script_trigger_type¶

Specifies the Script trigger type. Depending upon the value of this property, additional properties may need to be configured to fully configure the trigger.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.ScriptTriggerType

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Triggers:Script:Trigger Type

C Attribute: NIFGEN_ATTR_SCRIPT_TRIGGER_TYPE

serial_number¶

nifgen.Session.serial_number¶

The signal generator’s serial number.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Serial Number

C Attribute: NIFGEN_ATTR_SERIAL_NUMBER

simulate¶

nifgen.Session.simulate¶

Specifies whether to simulate NI-FGEN I/O operations. If simulation is enabled, NI-FGEN methods perform range checking and call Ivi_GetAttribute and Ivi_SetAttribute, but they do not perform device I/O. For output parameters that represent device data, NI-FGEN methods return calculated values. Default Value: False Use nifgen.Session.InitWithOptions() to override default value.

Note

One or more of the referenced methods are not in the Python API for this driver.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Inherent IVI Attributes:User Options:Simulate

C Attribute: NIFGEN_ATTR_SIMULATE

specific_driver_description¶

nifgen.Session.specific_driver_description¶

Returns a brief description of NI-FGEN.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Inherent IVI Attributes:Driver Identification:Description

C Attribute: NIFGEN_ATTR_SPECIFIC_DRIVER_DESCRIPTION

specific_driver_revision¶

nifgen.Session.specific_driver_revision¶

A string that contains additional version information about NI-FGEN.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Inherent IVI Attributes:Driver Identification:Revision

C Attribute: NIFGEN_ATTR_SPECIFIC_DRIVER_REVISION

specific_driver_vendor¶

nifgen.Session.specific_driver_vendor¶

A string that contains the name of the vendor that supplies NI-FGEN.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Inherent IVI Attributes:Driver Identification:Driver Vendor

C Attribute: NIFGEN_ATTR_SPECIFIC_DRIVER_VENDOR

started_event_delay¶

nifgen.Session.started_event_delay¶

Specifies the amount of delay applied to a Started Event with respect to the analog output of the signal generator. A positive delay value specifies that the Started Event occurs after the analog data, and a negative delay value specifies that the Started Event occurs before the analog data. The default value is zero, which will align the Started event with the analog output. You can specify the units of the delay value by setting the nifgen.Session.started_event_delay property.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Started:Advanced:Delay Value

C Attribute: NIFGEN_ATTR_STARTED_EVENT_DELAY

started_event_delay_units¶

nifgen.Session.started_event_delay_units¶

Specifies the units applied to the value of the nifgen.Session.started_event_delay property. Valid units are seconds and sample clock periods.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.StartedEventDelayUnits

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Started:Advanced:Delay Units

C Attribute: NIFGEN_ATTR_STARTED_EVENT_DELAY_UNITS

started_event_latched_status¶

nifgen.Session.started_event_latched_status¶

Specifies the latched status of the Started Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype bool

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Started:Advanced:Latched Status

C Attribute: NIFGEN_ATTR_STARTED_EVENT_LATCHED_STATUS

started_event_level_active_level¶

nifgen.Session.started_event_level_active_level¶

Specifies the output polarity of the Started Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.StartedEventActiveLevel

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Started:Level:Active Level

C Attribute: NIFGEN_ATTR_STARTED_EVENT_LEVEL_ACTIVE_LEVEL

started_event_output_behavior¶

nifgen.Session.started_event_output_behavior¶

Specifies the output behavior for the Started Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.StartedEventOutputBehavior

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Started:Output Behavior

C Attribute: NIFGEN_ATTR_STARTED_EVENT_OUTPUT_BEHAVIOR

started_event_output_terminal¶

nifgen.Session.started_event_output_terminal¶

Specifies the destination terminal for the Started Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Started:Output Terminal

C Attribute: NIFGEN_ATTR_STARTED_EVENT_OUTPUT_TERMINAL

started_event_pulse_polarity¶

nifgen.Session.started_event_pulse_polarity¶

Specifies the output polarity of the Started Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.StartedEventPulsePolarity

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Started:Pulse:Polarity

C Attribute: NIFGEN_ATTR_STARTED_EVENT_PULSE_POLARITY

started_event_pulse_width¶

nifgen.Session.started_event_pulse_width¶

Specifies the pulse width for the Started Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Started:Pulse:Width Value

C Attribute: NIFGEN_ATTR_STARTED_EVENT_PULSE_WIDTH

started_event_pulse_width_units¶

nifgen.Session.started_event_pulse_width_units¶

Specifies the pulse width units for the Started Event.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.StartedEventPulseWidthUnits

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Events:Started:Pulse:Width Units

C Attribute: NIFGEN_ATTR_STARTED_EVENT_PULSE_WIDTH_UNITS

start_trigger_type¶

nifgen.Session.start_trigger_type¶

Specifies whether you want the Start trigger to be a Digital Edge, or Software trigger. You can also choose None as the value for this property.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.StartTriggerType

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Triggers:Start:Trigger Type

C Attribute: NIFGEN_ATTR_START_TRIGGER_TYPE

streaming_space_available_in_waveform¶

nifgen.Session.streaming_space_available_in_waveform¶

Indicates the space available (in samples) in the streaming waveform for writing new data. During generation, this available space may be in multiple locations with, for example, part of the available space at the end of the streaming waveform and the rest at the beginning. In this situation, writing a block of waveform data the size of the total space available in the streaming waveform causes NI-FGEN to return an error, as NI-FGEN will not wrap the data from the end of the waveform to the beginning and cannot write data past the end of the waveform buffer. To avoid writing data past the end of the waveform, write new data to the waveform in a fixed size that is an integer divisor of the total size of the streaming waveform. Used in conjunction with the nifgen.Session.streaming_waveform_handle or nifgen.Session.streaming_waveform_name properties.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Data Transfer:Streaming:Space Available in Streaming Waveform

C Attribute: NIFGEN_ATTR_STREAMING_SPACE_AVAILABLE_IN_WAVEFORM

streaming_waveform_handle¶

nifgen.Session.streaming_waveform_handle¶

Specifies the waveform handle of the waveform used to continuously stream data during generation. This property defaults to -1 when no streaming waveform is specified. Used in conjunction with nifgen.Session.streaming_space_available_in_waveform.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Data Transfer:Streaming:Streaming Waveform Handle

C Attribute: NIFGEN_ATTR_STREAMING_WAVEFORM_HANDLE

streaming_waveform_name¶

nifgen.Session.streaming_waveform_name¶

Specifies the name of the waveform used to continuously stream data during generation. This property defaults to // when no streaming waveform is specified. Use in conjunction with nifgen.Session.streaming_space_available_in_waveform.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Data Transfer:Streaming:Streaming Waveform Name

C Attribute: NIFGEN_ATTR_STREAMING_WAVEFORM_NAME

streaming_write_timeout¶

nifgen.Session.streaming_write_timeout¶

Specifies the maximum amount of time allowed to complete a streaming write operation.

The following table lists the characteristics of this property.

Characteristic Value

Datatype float in seconds or datetime.timedelta

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Data Transfer:Streaming:Streaming Write Timeout

C Attribute: NIFGEN_ATTR_STREAMING_WRITE_TIMEOUT

supported_instrument_models¶

nifgen.Session.supported_instrument_models¶

Returns a model code of the device. For NI-FGEN versions that support more than one device, this property contains a comma-separated list of supported device models.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:Inherent IVI Attributes:Driver Capabilities:Supported Instrument Models

C Attribute: NIFGEN_ATTR_SUPPORTED_INSTRUMENT_MODELS

synchronization¶

nifgen.Session.synchronization¶

Specify the source of the synchronization signal that you want to use.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.SynchronizationSource

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:5401/5411/5431:Synchronization Source

C Attribute: NIFGEN_ATTR_SYNCHRONIZATION

sync_duty_cycle_high¶

nifgen.Session.sync_duty_cycle_high¶

Controls the duty cycle of the square wave the signal generator produces on the SYNC out line. Specify this property as a percentage of the time the square wave is high in each cycle. Units: Percentage of time the waveform is high

The following table lists the characteristics of this property.

Characteristic Value

Datatype float

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Sync Duty Cycle High

C Attribute: NIFGEN_ATTR_SYNC_DUTY_CYCLE_HIGH

sync_out_output_terminal¶

nifgen.Session.sync_out_output_terminal¶

Specifies the terminal to which to export the SYNC OUT signal. This property is not supported for all devices.

The following table lists the characteristics of this property.

Characteristic Value

Datatype str

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Standard Function:Sync Out Output Terminal

C Attribute: NIFGEN_ATTR_SYNC_OUT_OUTPUT_TERMINAL

terminal_configuration¶

nifgen.Session.terminal_configuration¶

Specifies whether gain and offset values will be analyzed based on single-ended or differential operation.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.TerminalConfiguration

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Terminal Configuration

C Attribute: NIFGEN_ATTR_TERMINAL_CONFIGURATION

trigger_mode¶

nifgen.Session.trigger_mode¶

Controls the trigger mode.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.TriggerMode

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Triggers:Trigger Mode

C Attribute: NIFGEN_ATTR_TRIGGER_MODE

trigger_source¶

nifgen.Session.trigger_source¶

Controls which trigger source the signal generator uses. After you call the nifgen.Session._initiate_generation() method, the signal generator waits for the trigger that you specify in the triggerSource parameter. After the signal generator receives a trigger, it produces the number of cycles that you specify in the nifgen.Session.CYCLE_COUNT property. This property is also the source for the trigger in the other trigger modes as specified by the nifgen.Session.trigger_mode property.

Note

One or more of the referenced properties are not in the Python API for this driver.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.TriggerSource

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:5401/5411/5431:Trigger Source

C Attribute: NIFGEN_ATTR_TRIGGER_SOURCE

video_waveform_type¶

nifgen.Session.video_waveform_type¶

Selects which waveform type that the NI 5431 generates. Setting this property ensures that the crystal is set to the proper frequency.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.VideoWaveformType

Permissions read-write

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Instrument:5401/5411/5431:Video Waveform Type

C Attribute: NIFGEN_ATTR_VIDEO_WAVEFORM_TYPE

wait_behavior¶

nifgen.Session.wait_behavior¶

Specifies the behavior of the output while waiting for a script trigger or during a wait instruction. The output can be configured to hold the last generated voltage before waiting or jump to the Wait Value.

The following table lists the characteristics of this property.

Characteristic Value

Datatype enums.WaitBehavior

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Advanced:Wait Behavior

C Attribute: NIFGEN_ATTR_WAIT_BEHAVIOR

wait_value¶

nifgen.Session.wait_value¶

Specifies the value to generate while waiting. The Wait Behavior must be configured to jump to this value.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read-write

Channel Based False

Resettable Yes

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Output:Advanced:Wait Value

C Attribute: NIFGEN_ATTR_WAIT_VALUE

waveform_quantum¶

nifgen.Session.waveform_quantum¶

The size of each arbitrary waveform must be a multiple of a quantum value. This property returns the quantum value that the signal generator allows. For example, when this property returns a value of 8, all waveform sizes must be a multiple of 8. Typically, this value is constant for the signal generator.

The following table lists the characteristics of this property.

Characteristic Value

Datatype int

Permissions read only

Channel Based False

Resettable No

Tip

This property corresponds to the following LabVIEW Property or C Attribute:

LabVIEW Property: Arbitrary Waveform:Capabilities:Waveform Quantum

C Attribute: NIFGEN_ATTR_WAVEFORM_QUANTUM

Methods¶

abort¶

nifgen.Session.abort()¶

Aborts any previously initiated signal generation. Call the nifgen_InitiateGeneration method to cause the signal generator to produce a signal again.

allocate_named_waveform¶

nifgen.Session.allocate_named_waveform(waveform_name, waveform_size)¶
Specifies the size of a named waveform up front so that it can be allocated in onboard memory before loading the associated data. Data can then be loaded in smaller blocks with the niFgen Write (Binary16) Waveform methods.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].allocate_named_waveform(waveform_name, waveform_size)
Parameters:

waveform_name (str) – Specifies the name to associate with the allocated waveform.

waveform_size (int) –
Specifies the size of the waveform to allocate in samples.

Default Value: “4096”

allocate_waveform¶

nifgen.Session.allocate_waveform(waveform_size)¶
Specifies the size of a waveform so that it can be allocated in onboard memory before loading the associated data. Data can then be loaded in smaller blocks with the Write Binary 16 Waveform methods.

Note

The signal generator must not be in the Generating state when you call this method.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].allocate_waveform(waveform_size)
Parameters: waveform_size (int) – Specifies, in samples, the size of the waveform to allocate.

Return type: int

Returns: The handle that identifies the new waveform. This handle is used later when referring to this waveform.

clear_arb_memory¶

nifgen.Session.clear_arb_memory()¶

Removes all previously created arbitrary waveforms, sequences, and scripts from the signal generator memory and invalidates all waveform handles, sequence handles, and waveform names.

Note

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

clear_arb_sequence¶

nifgen.Session.clear_arb_sequence(sequence_handle)¶

Removes a previously created arbitrary sequence from the signal generator memory and invalidates the sequence handle.

Note

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

Parameters: sequence_handle (int) –
Specifies the handle of the arbitrary sequence that you want the signal generator to remove. You can create an arbitrary sequence using the nifgen_CreateArbSequence or nifgen_CreateAdvancedArbSequence method. These methods return a handle that you use to identify the sequence.

Defined Value:

NIFGEN_VAL_ALL_SEQUENCES—Remove all sequences from the signal generator

Default Value: None

Note

One or more of the referenced values are not in the Python API for this driver. Enums that only define values, or represent True/False, have been removed.

clear_arb_waveform¶

nifgen.Session.clear_arb_waveform(waveform_handle)¶

Removes a previously created arbitrary waveform from the signal generator memory and invalidates the waveform handle.

Note

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

Parameters: waveform_handle (int) –
Specifies the handle of the arbitrary waveform that you want the signal generator to remove.

You can create multiple arbitrary waveforms using one of the following niFgen Create Waveform methods:

nifgen.Session.create_waveform()

nifgen.Session.create_waveform()

nifgen.Session.create_waveform_from_file_i16()

nifgen.Session.create_waveform_from_file_f64()

nifgen.Session.CreateWaveformFromFileHWS()

Defined Value:

NIFGEN_VAL_ALL_WAVEFORMS—Remove all waveforms from the signal generator.

Default Value: None

Note

One or more of the referenced methods are not in the Python API for this driver.

Note

One or more of the referenced values are not in the Python API for this driver. Enums that only define values, or represent True/False, have been removed.

clear_freq_list¶

nifgen.Session.clear_freq_list(frequency_list_handle)¶

Removes a previously created frequency list from the signal generator memory and invalidates the frequency list handle.

Note

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

Parameters: frequency_list_handle (int) –
Specifies the handle of the frequency list you want the signal generator to remove. You create multiple frequency lists using nifgen.Session.create_freq_list(). nifgen.Session.create_freq_list() returns a handle that you use to identify each list. Specify a value of -1 to clear all frequency lists.

Defined Value

NIFGEN_VAL_ALL_FLISTS—Remove all frequency lists from the signal generator.

Default Value: None

Note

One or more of the referenced values are not in the Python API for this driver. Enums that only define values, or represent True/False, have been removed.

clear_user_standard_waveform¶

nifgen.Session.clear_user_standard_waveform()¶
Clears the user-defined waveform created by the nifgen_DefineUserStandardWaveform method.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].clear_user_standard_waveform()

commit¶

nifgen.Session.commit()¶

Causes a transition to the Committed state. This method verifies property values, reserves the device, and commits the property values to the device. If the property values are all valid, NI-FGEN sets the device hardware configuration to match the session configuration. This method does not support the NI 5401/5404/5411/5431 signal generators.

In the Committed state, you can load waveforms, scripts, and sequences into memory. If any properties are changed, NI-FGEN implicitly transitions back to the Idle state, where you can program all session properties before applying them to the device. This method has no effect if the device is already in the Committed or Generating state and returns a successful status value.

Calling this VI before the niFgen Initiate Generation VI is optional but has the following benefits:

Routes are committed, so signals are exported or imported.

Any Reference Clock and external clock circuits are phase-locked.

A subsequent nifgen.Session._initiate_generation() method can run faster because the device is already configured.

configure_arb_sequence¶

nifgen.Session.configure_arb_sequence(sequence_handle, gain, offset)¶
Configures the signal generator properties that affect arbitrary sequence generation. Sets the nifgen.Session.arb_sequence_handle, nifgen.Session.arb_gain, and nifgen.Session.arb_offset properties.

Note

The signal generator must not be in the Generating state when you call this method.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].configure_arb_sequence(sequence_handle, gain, offset)
Parameters:

sequence_handle (int) –
Specifies the handle of the arbitrary sequence that you want the signal generator to produce. NI-FGEN sets the nifgen.Session.arb_sequence_handle property to this value. You can create an arbitrary sequence using the nifgen.Session.create_arb_sequence() or nifgen.Session.create_advanced_arb_sequence() method. These methods return a handle that you use to identify the sequence.

Default Value: None

gain (float) –
Specifies the factor by which the signal generator scales the arbitrary waveforms in the sequence. When you create an arbitrary waveform, you must first normalize the data points to a range of –1.00 to +1.00. You can use this parameter to scale the waveform to other ranges. The gain is applied before the offset is added.

For example, to configure the output signal to range from –2.00 to +2.00 V, set gain to 2.00.

Units: unitless

Default Value: None

offset (float) –
Specifies the value the signal generator adds to the arbitrary waveform data. When you create arbitrary waveforms, you must first normalize the data points to a range of –1.00 to +1.00 V. You can use this parameter to shift the range of the arbitrary waveform. NI-FGEN sets the nifgen.Session.arb_offset property to this value.

For example, to configure the output signal to range from 0.00 to 2.00 V instead of –1.00 to 1.00 V, set the offset to 1.00.

Units: volts

Default Value: None

configure_arb_waveform¶

nifgen.Session.configure_arb_waveform(waveform_handle, gain, offset)¶
Configures the properties of the signal generator that affect arbitrary waveform generation. Sets the nifgen.Session.arb_waveform_handle, nifgen.Session.arb_gain, and nifgen.Session.arb_offset properties.

Note

The signal generator must not be in the Generating state when you call this method.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].configure_arb_waveform(waveform_handle, gain, offset)
Parameters:

waveform_handle (int) –
Specifies the handle of the arbitrary waveform you want the signal generator to produce. NI-FGEN sets the nifgen.Session.arb_waveform_handle property to this value. You can create an arbitrary waveform using one of the following niFgen Create Waveform methods:

nifgen.Session.create_waveform()

nifgen.Session.create_waveform()

nifgen.Session.create_waveform_from_file_i16()

nifgen.Session.create_waveform_from_file_f64()

nifgen.Session.CreateWaveformFromFileHWS()

These methods return a handle that you use to identify the waveform.

Default Value: None

Note

One or more of the referenced methods are not in the Python API for this driver.

gain (float) –
Specifies the factor by which the signal generator scales the arbitrary waveforms in the sequence. When you create an arbitrary waveform, you must first normalize the data points to a range of –1.00 to +1.00. You can use this parameter to scale the waveform to other ranges. The gain is applied before the offset is added.

For example, to configure the output signal to range from –2.00 to +2.00 V, set gain to 2.00.

Units: unitless

Default Value: None

offset (float) –
Specifies the value the signal generator adds to the arbitrary waveform data. When you create arbitrary waveforms, you must first normalize the data points to a range of –1.00 to +1.00 V. You can use this parameter to shift the range of the arbitrary waveform. NI-FGEN sets the nifgen.Session.arb_offset property to this value.

For example, to configure the output signal to range from 0.00 to 2.00 V instead of –1.00 to 1.00 V, set the offset to 1.00.

Units: volts

Default Value: None

configure_custom_fir_filter_coefficients¶

nifgen.Session.configure_custom_fir_filter_coefficients(coefficients_array)¶
Sets the FIR filter coefficients used by the onboard signal processing block. The values are coerced to the closest settings achievable by the signal generator.

Refer to the FIR Filter topic for your device in the NI Signal Generators Help for more information about FIR filter coefficients. This method is supported only for the NI 5441.

Note

The signal generator must not be in the Generating state when you call this method.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].configure_custom_fir_filter_coefficients(coefficients_array)
Parameters: coefficients_array (list of float) – Specifies the array of data the onboard signal processor uses for the FIR filter coefficients. For the NI 5441, provide a symmetric array of 95 coefficients to this parameter. The array must have at least as many elements as the value that you specify in the numberOfCoefficients parameter in this method. The coefficients should range between –1.00 and +1.00.

configure_digital_edge_script_trigger¶

nifgen.Session.configure_digital_edge_script_trigger(source, edge=nifgen.ScriptTriggerDigitalEdgeEdge.RISING)¶
Configures the specified Script Trigger for digital edge triggering.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].configure_digital_edge_script_trigger(source, edge=nifgen.ScriptTriggerDigitalEdgeEdge.RISING)
Parameters:

source (str) –
Specifies which trigger source the signal generator uses.

Defined Values

Default Value: “PFI0”

”PFI0” PFI 0

”PFI1” PFI 1

”PFI2” PFI 2

”PFI3” PFI 3

”PFI4” PFI 4

”PFI5” PFI 5

”PFI6” PFI 6

”PFI7” PFI 7

”PXI_Trig0” PXI trigger line 0 or RTSI line 0

”PXI_Trig1” PXI trigger line 1 or RTSI line 1

”PXI_Trig2” PXI trigger line 2 or RTSI line 2

”PXI_Trig3” PXI trigger line 3 or RTSI line 3

”PXI_Trig4” PXI trigger line 4 or RTSI line 4

”PXI_Trig5” PXI trigger line 5 or RTSI line 5

”PXI_Trig6” PXI trigger line 6 or RTSI line 6

”PXI_Trig7” PXI trigger line 7 or RTSI line 7

”PXI_Star” PXI star trigger line

edge (nifgen.ScriptTriggerDigitalEdgeEdge) –
Specifies the edge to detect.

**Defined Values**

**Default Value:** RISING

RISING Occurs when the signal transitions from low level to high level.

FALLING Occurs when the signal transitions from high level to low level.

Note

One or more of the referenced values are not in the Python API for this driver. Enums that only define values, or represent True/False, have been removed.

configure_digital_edge_start_trigger¶

nifgen.Session.configure_digital_edge_start_trigger(source, edge=nifgen.StartTriggerDigitalEdgeEdge.RISING)¶

Configures the Start Trigger for digital edge triggering.

Parameters:

source (str) –
Specifies which trigger source the signal generator uses.

Defined Values

Default Value: “PFI0”

”PFI0” PFI 0

”PFI1” PFI 1

”PFI2” PFI 2

”PFI3” PFI 3

”PFI4” PFI 4

”PFI5” PFI 5

”PFI6” PFI 6

”PFI7” PFI 7

”PXI_Trig0” PXI trigger line 0 or RTSI line 0

”PXI_Trig1” PXI trigger line 1 or RTSI line 1

”PXI_Trig2” PXI trigger line 2 or RTSI line 2

”PXI_Trig3” PXI trigger line 3 or RTSI line 3

”PXI_Trig4” PXI trigger line 4 or RTSI line 4

”PXI_Trig5” PXI trigger line 5 or RTSI line 5

”PXI_Trig6” PXI trigger line 6 or RTSI line 6

”PXI_Trig7” PXI trigger line 7 or RTSI line 7

”PXI_Star” PXI star trigger line

edge (nifgen.StartTriggerDigitalEdgeEdge) –
Specifies the edge to detect.

**Defined Values**

**Default Value:** RISING

RISING Occurs when the signal transitions from low level to high level.

FALLING Occurs when the signal transitions from high level to low level.

Note

One or more of the referenced values are not in the Python API for this driver. Enums that only define values, or represent True/False, have been removed.

configure_digital_level_script_trigger¶

nifgen.Session.configure_digital_level_script_trigger(source, trigger_when)¶
Configures the specified Script Trigger for digital level triggering.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].configure_digital_level_script_trigger(source, trigger_when)
Parameters:

source (str) –
Specifies which trigger source the signal generator uses.

Defined Values

Default Value: “PFI0”

”PFI0” PFI 0

”PFI1” PFI 1

”PFI2” PFI 2

”PFI3” PFI 3

”PFI4” PFI 4

”PFI5” PFI 5

”PFI6” PFI 6

”PFI7” PFI 7

”PXI_Trig0” PXI trigger line 0 or RTSI line 0

”PXI_Trig1” PXI trigger line 1 or RTSI line 1

”PXI_Trig2” PXI trigger line 2 or RTSI line 2

”PXI_Trig3” PXI trigger line 3 or RTSI line 3

”PXI_Trig4” PXI trigger line 4 or RTSI line 4

”PXI_Trig5” PXI trigger line 5 or RTSI line 5

”PXI_Trig6” PXI trigger line 6 or RTSI line 6

”PXI_Trig7” PXI trigger line 7 or RTSI line 7

”PXI_Star” PXI star trigger line

trigger_when (nifgen.TriggerWhen) –
Specifies whether the Script Trigger asserts on a high or low digital level.

Defined Values

Default Value: “HighLevel”

”HighLevel” Script Trigger asserts on a high digital level.

”LowLevel” Script Trigger asserts on a low digital level.

configure_freq_list¶

nifgen.Session.configure_freq_list(frequency_list_handle, amplitude, dc_offset=0.0, start_phase=0.0)¶
Configures the properties of the signal generator that affect frequency list generation (the nifgen.Session.freq_list_handle, nifgen.Session.func_amplitude, nifgen.Session.func_dc_offset, and nifgen.Session.func_start_phase properties).

Note

The signal generator must not be in the Generating state when you call this method.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].configure_freq_list(frequency_list_handle, amplitude, dc_offset=0.0, start_phase=0.0)
Parameters:

frequency_list_handle (int) – Specifies the handle of the frequency list that you want the signal generator to produce. NI-FGEN sets the nifgen.Session.freq_list_handle property to this value. You can create a frequency list using the nifgen.Session.create_freq_list() method, which returns a handle that you use to identify the list. Default Value: None

amplitude (float) –
Specifies the amplitude of the standard waveform that you want the signal generator to produce. This value is the amplitude at the output terminal. NI-FGEN sets the nifgen.Session.func_amplitude property to this value.

For example, to produce a waveform ranging from –5.00 V to +5.00 V, set the amplitude to 10.00 V.

Units: peak-to-peak voltage

Default Value: None

Note

This parameter does not affect signal generator behavior when you set the waveform parameter of the nifgen.Session.configure_standard_waveform() method to DC.

dc_offset (float) –
Specifies the DC offset of the standard waveform that you want the signal generator to produce. The value is the offset from ground to the center of the waveform you specify with the waveform parameter, observed at the output terminal. For example, to configure a waveform with an amplitude of 10.00 V to range from 0.00 V to +10.00 V, set the dcOffset to 5.00 V. NI-FGEN sets the nifgen.Session.func_dc_offset property to this value.

Units: volts

Default Value: None

start_phase (float) –
Specifies the horizontal offset of the standard waveform you want the signal generator to produce. Specify this property in degrees of one waveform cycle. NI-FGEN sets the nifgen.Session.func_start_phase property to this value. A start phase of 180 degrees means output generation begins halfway through the waveform. A start phase of 360 degrees offsets the output by an entire waveform cycle, which is identical to a start phase of 0 degrees.

Units: degrees of one cycle

Default Value: None degrees

Note

This parameter does not affect signal generator behavior when you set the waveform parameter to DC.

configure_standard_waveform¶

nifgen.Session.configure_standard_waveform(waveform, amplitude, frequency, dc_offset=0.0, start_phase=0.0)¶
Configures the following properties of the signal generator that affect standard waveform generation:

nifgen.Session.func_waveform

nifgen.Session.func_amplitude

nifgen.Session.func_dc_offset

nifgen.Session.func_frequency

nifgen.Session.func_start_phase

Note

You must call the nifgen.Session.ConfigureOutputMode() method with the outputMode parameter set to FUNC before calling this method.

Note

One or more of the referenced methods are not in the Python API for this driver.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].configure_standard_waveform(waveform, amplitude, frequency, dc_offset=0.0, start_phase=0.0)
Parameters:

waveform (nifgen.Waveform) –
Specifies the standard waveform that you want the signal generator to produce. NI-FGEN sets the nifgen.Session.func_waveform property to this value.

**Defined Values**

Default Value: SINE

SINE Specifies that the signal generator produces a sinusoid waveform.

SQUARE Specifies that the signal generator produces a square waveform.

TRIANGLE Specifies that the signal generator produces a triangle waveform.

RAMP_UP Specifies that the signal generator produces a positive ramp waveform.

RAMP_DOWN Specifies that the signal generator produces a negative ramp waveform.

DC Specifies that the signal generator produces a constant voltage.

NOISE Specifies that the signal generator produces white noise.

USER Specifies that the signal generator produces a user-defined waveform as defined with the nifgen_DefineUserStandardWaveform method.

amplitude (float) –
Specifies the amplitude of the standard waveform that you want the signal generator to produce. This value is the amplitude at the output terminal. NI-FGEN sets the nifgen.Session.func_amplitude property to this value.

For example, to produce a waveform ranging from –5.00 V to +5.00 V, set the amplitude to 10.00 V.

Units: peak-to-peak voltage

Default Value: None

Note

This parameter does not affect signal generator behavior when you set the waveform parameter of the nifgen.Session.configure_standard_waveform() method to DC.

frequency (float) –

Specifies the frequency of the standard waveform that you want the signal generator to produce. NI-FGEN sets the nifgen.Session.func_frequency property to this value.

Units: hertz

Default Value: None

Note

This parameter does not affect signal generator behavior when you set the waveform parameter of the nifgen.Session.configure_standard_waveform() method to DC.

dc_offset (float) –
Specifies the DC offset of the standard waveform that you want the signal generator to produce. The value is the offset from ground to the center of the waveform you specify with the waveform parameter, observed at the output terminal. For example, to configure a waveform with an amplitude of 10.00 V to range from 0.00 V to +10.00 V, set the dcOffset to 5.00 V. NI-FGEN sets the nifgen.Session.func_dc_offset property to this value.

Units: volts

Default Value: None

start_phase (float) –
Specifies the horizontal offset of the standard waveform that you want the signal generator to produce. Specify this parameter in degrees of one waveform cycle. NI-FGEN sets the nifgen.Session.func_start_phase property to this value. A start phase of 180 degrees means output generation begins halfway through the waveform. A start phase of 360 degrees offsets the output by an entire waveform cycle, which is identical to a start phase of 0 degrees.

Units: degrees of one cycle

Default Value: 0.00

Note

This parameter does not affect signal generator behavior when you set the waveform parameter to DC.

create_advanced_arb_sequence¶

nifgen.Session.create_advanced_arb_sequence(waveform_handles_array, loop_counts_array, sample_counts_array=None, marker_location_array=None)¶

Creates an arbitrary sequence from an array of waveform handles and an array of corresponding loop counts. This method returns a handle that identifies the sequence. You pass this handle to the nifgen.Session.configure_arb_sequence() method to specify what arbitrary sequence you want the signal generator to produce.

The nifgen.Session.create_advanced_arb_sequence() method extends on the nifgen.Session.create_arb_sequence() method by adding the ability to set the number of samples in each sequence step and to set marker locations.

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.

Note

The signal generator must not be in the Generating state when you call this method. You must call the nifgen_ConfigureOutputMode method to set the outputMode parameter to SEQ before calling this method.

Parameters:

waveform_handles_array (list of int) –
Specifies the array of waveform handles from which you want to create a new arbitrary sequence. The array must have at least as many elements as the value that you specify in sequenceLength. Each waveformHandlesArray element has a corresponding loopCountsArray element that indicates how many times that waveform is repeated. You obtain waveform handles when you create arbitrary waveforms with the nifgen_AllocateWaveform method or one of the following niFgen CreateWaveform methods:

nifgen_CreateWaveformF64

nifgen_CreateWaveformI16

nifgen_CreateWaveformFromFileI16

nifgen_CreateWaveformFromFileF64

nifgen_CreateWaveformFromFileHWS

Default Value: None

loop_counts_array (list of int) –
Specifies the array of loop counts you want to use to create a new arbitrary sequence. The array must have at least as many elements as the value that you specify in the sequenceLength parameter. Each loopCountsArray element corresponds to a waveformHandlesArray element and indicates how many times to repeat that waveform. Each element of the loopCountsArray must be less than or equal to the maximum number of loop counts that the signal generator allows. You can obtain the maximum loop count from maximumLoopCount in the nifgen_QueryArbSeqCapabilities method.

Default Value: None

sample_counts_array (list of int) –
Specifies the array of sample counts that you want to use to create a new arbitrary sequence. The array must have at least as many elements as the value you specify in the sequenceLength parameter. Each sampleCountsArray element corresponds to a waveformHandlesArray element and indicates the subset, in samples, of the given waveform to generate. Each element of the sampleCountsArray 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_QueryArbWfmCapabilities method.

Default Value: None

marker_location_array (list of int) –
Specifies the array of marker locations to where you want a marker to be generated in the sequence. The array must have at least as many elements as the value you specify in the sequenceLength parameter. Each markerLocationArray element corresponds to a waveformHandlesArray element and indicates where in the waveform a marker is to generate. The marker location must be less than the size of the waveform the marker is in. The markers are coerced to the nearest marker quantum and the coerced values are returned in the coercedMarkersArray parameter.

If you do not want a marker generated for a particular sequence stage, set this parameter to NIFGEN_VAL_NO_MARKER.

Defined Value: NIFGEN_VAL_NO_MARKER

Default Value: None

Note

One or more of the referenced values are not in the Python API for this driver. Enums that only define values, or represent True/False, have been removed.

Return type:
tuple (coerced_markers_array, sequence_handle)

WHERE

coerced_markers_array (list of int):

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

Default Value: None

sequence_handle (int):

Returns the handle that identifies the new arbitrary sequence. You can pass this handle to nifgen_ConfigureArbSequence to generate the arbitrary sequence.

create_arb_sequence¶

nifgen.Session.create_arb_sequence(waveform_handles_array, loop_counts_array)¶

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

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.

Note

You must call the nifgen_ConfigureOutputMode method to set the outputMode parameter to SEQ before calling this method.

Parameters:

waveform_handles_array (list of int) –
Specifies the array of waveform handles from which you want to create a new arbitrary sequence. The array must have at least as many elements as the value that you specify in sequenceLength. Each waveformHandlesArray element has a corresponding loopCountsArray element that indicates how many times that waveform is repeated. You obtain waveform handles when you create arbitrary waveforms with the nifgen_AllocateWaveform method or one of the following niFgen CreateWaveform methods:

nifgen_CreateWaveformF64

nifgen_CreateWaveformI16

nifgen_CreateWaveformFromFileI16

nifgen_CreateWaveformFromFileF64

nifgen_CreateWaveformFromFileHWS

Default Value: None

loop_counts_array (list of int) –
Specifies the array of loop counts you want to use to create a new arbitrary sequence. The array must have at least as many elements as the value that you specify in the sequenceLength parameter. Each loopCountsArray element corresponds to a waveformHandlesArray element and indicates how many times to repeat that waveform. Each element of the loopCountsArray must be less than or equal to the maximum number of loop counts that the signal generator allows. You can obtain the maximum loop count from maximumLoopCount in the nifgen_QueryArbSeqCapabilities method.

Default Value: None

Return type:
int

Returns:
Returns the handle that identifies the new arbitrary sequence. You can pass this handle to nifgen_ConfigureArbSequence to generate the arbitrary sequence.

create_freq_list¶

nifgen.Session.create_freq_list(waveform, frequency_array, duration_array)¶

Creates a frequency list from an array of frequencies (frequencyArray) and an array of durations (durationArray). The two arrays should have the same number of elements, and this value must also be the size of the frequencyListLength. The method returns a handle that identifies the frequency list (the frequencyListHandle). You can pass this handle to nifgen_ConfigureFreqList to specify what frequency list you want the signal generator to produce.

A frequency list consists of a list of frequencies and durations. The signal generator generates each frequency for the given amount of time and then proceeds to the next frequency. When the end of the list is reached, the signal generator starts over at the beginning of the list.

Note

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

Parameters:

waveform (nifgen.Waveform) –
Specifies the standard waveform that you want the signal generator to produce. NI-FGEN sets the nifgen.Session.func_waveform property to this value.

**Defined Values**

Default Value: SINE

SINE Specifies that the signal generator produces a sinusoid waveform.

SQUARE Specifies that the signal generator produces a square waveform.

TRIANGLE Specifies that the signal generator produces a triangle waveform.

RAMP_UP Specifies that the signal generator produces a positive ramp waveform.

RAMP_DOWN Specifies that the signal generator produces a negative ramp waveform.

DC Specifies that the signal generator produces a constant voltage.

NOISE Specifies that the signal generator produces white noise.

USER Specifies that the signal generator produces a user-defined waveform as defined with the nifgen_DefineUserStandardWaveform method.

frequency_array (list of float) –
Specifies the array of frequencies to form the frequency list. The array must have at least as many elements as the value you specify in frequencyListLength. Each frequencyArray element has a corresponding durationArray element that indicates how long that frequency is repeated.

Units: hertz

Default Value: None

duration_array (list of float) –
Specifies the array of durations to form the frequency list. The array must have at least as many elements as the value that you specify in frequencyListLength. Each durationArray element has a corresponding frequencyArray element and indicates how long in seconds to generate the corresponding frequency.

Units: seconds

Default Value: None

Return type:
int

Returns:
Returns the handle that identifies the new frequency list. You can pass this handle to nifgen_ConfigureFreqList to generate the arbitrary sequence.

create_waveform_from_file_f64¶

nifgen.Session.create_waveform_from_file_f64(file_name, byte_order)¶
This method takes the floating point double (F64) data from the specified file and creates an onboard waveform for use in Arbitrary Waveform or Arbitrary Sequence output mode. The waveformHandle returned by this method can later be used for setting the active waveform, changing the data in the waveform, building sequences of waveforms, or deleting the waveform when it is no longer needed.

Note

The F64 data must be between –1.0 and +1.0 V. Use the nifgen.Session.digital_gain property to generate different voltage outputs.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].create_waveform_from_file_f64(file_name, byte_order)
Parameters:

file_name (str) – The full path and name of the file where the waveform data resides.

byte_order (nifgen.ByteOrder) –
Specifies the byte order of the data in the file.

**Defined Values**

**Default Value:** LITTLE

LITTLE Little Endian Data—The least significant bit is stored at the lowest address, followed by the other bits, in order of increasing significance.

BIG Big Endian Data—The most significant bit is stored at the lowest address, followed by the other bits, in order of decreasing significance.

Note

Data written by most applications in Windows (including LabWindows™/CVI™) is in Little Endian format. Data written to a file from LabVIEW is in Big Endian format by default on all platforms. Big Endian and Little Endian refer to the way data is stored in memory, which can differ on different processors.

Return type:
int

Returns:
The handle that identifies the new waveform. This handle is used later when referring to this waveform.

create_waveform_from_file_i16¶

nifgen.Session.create_waveform_from_file_i16(file_name, byte_order)¶
Takes the binary 16-bit signed integer (I16) data from the specified file and creates an onboard waveform for use in Arbitrary Waveform or Arbitrary Sequence output mode. The waveformHandle returned by this method can later be used for setting the active waveform, changing the data in the waveform, building sequences of waveforms, or deleting the waveform when it is no longer needed.

Note

The I16 data (values between –32768 and +32767) is assumed to represent –1 to +1 V. Use the nifgen.Session.digital_gain property to generate different voltage outputs.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].create_waveform_from_file_i16(file_name, byte_order)
Parameters:

file_name (str) – The full path and name of the file where the waveform data resides.

byte_order (nifgen.ByteOrder) –
Specifies the byte order of the data in the file.

**Defined Values**

**Default Value:** LITTLE

LITTLE Little Endian Data—The least significant bit is stored at the lowest address, followed by the other bits, in order of increasing significance.

BIG Big Endian Data—The most significant bit is stored at the lowest address, followed by the other bits, in order of decreasing significance.

Note

Data written by most applications in Windows (including LabWindows™/CVI™) is in Little Endian format. Data written to a file from LabVIEW is in Big Endian format by default on all platforms. Big Endian and Little Endian refer to the way data is stored in memory, which can differ on different processors.

Return type:
int

Returns:
The handle that identifies the new waveform. This handle is used later when referring to this waveform.

create_waveform_numpy¶

nifgen.Session.create_waveform_numpy(waveform_data_array)¶
Creates an onboard waveform for use in Arbitrary Waveform output mode or Arbitrary Sequence output mode.

Note

You must set nifgen.Session.output_mode to ARB or SEQ before calling this method.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].create_waveform(waveform_data_array)
Parameters: waveform_data_array (list of float) – Array of data for the new arbitrary waveform. This may be an iterable of float, or for best performance a numpy.ndarray of dtype int16 or float64.

Return type: int

Returns: The handle that identifies the new waveform. This handle is used in other methods when referring to this waveform.

define_user_standard_waveform¶

nifgen.Session.define_user_standard_waveform(waveform_data_array)¶
Defines a user waveform for use in either Standard Method or Frequency List output mode.

To select the waveform, set the waveform parameter to USER with either the nifgen_ConfigureStandardWaveform or the nifgen_CreateFreqList method.

The waveform data must be scaled between –1.0 and 1.0. Use the amplitude parameter in the nifgen.Session.configure_standard_waveform() method to generate different output voltages.

Note

You must call the nifgen_ConfigureOutputMode method to set the outputMode parameter to FUNC or FREQ_LIST before calling this method.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].define_user_standard_waveform(waveform_data_array)
Parameters: waveform_data_array (list of float) –
Specifies the array of data you want to use for the new arbitrary waveform. The array must have at least as many elements as the value that you specify in waveformSize.

You must normalize the data points in the array to be between –1.00 and +1.00.

Default Value: None

delete_named_waveform¶

nifgen.Session.delete_named_waveform(waveform_name)¶
Removes a previously created arbitrary waveform from the signal generator memory and invalidates the waveform handle.

Note

The signal generator must not be in the Generating state when you call this method.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].delete_named_waveform(waveform_name)
Parameters: waveform_name (str) – Specifies the name to associate with the allocated waveform.

delete_script¶

nifgen.Session.delete_script(script_name)¶
Deletes the specified script from onboard memory.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].delete_script(script_name)
Parameters: script_name (str) – Specifies the name of the script you want to delete. The script name appears in the text of the script following the script keyword.

disable¶

nifgen.Session.disable()¶

Places the instrument in a quiescent state where it has minimal or no impact on the system to which it is connected. The analog output and all exported signals are disabled.

get_ext_cal_last_date_and_time¶

nifgen.Session.get_ext_cal_last_date_and_time()¶

Returns the date and time of the last successful external calibration. The time returned is 24-hour (military) local time; for example, if the device was calibrated at 2:30 PM, this method returns 14 for the hour parameter and 30 for the minute parameter.

Return type: datetime.datetime

Returns: Indicates date and time of the last calibration.

get_ext_cal_last_temp¶

nifgen.Session.get_ext_cal_last_temp()¶

Returns the temperature at the last successful external calibration. The temperature is returned in degrees Celsius.

Return type: float

Returns: Specifies the temperature at the last successful calibration in degrees Celsius.

get_ext_cal_recommended_interval¶

nifgen.Session.get_ext_cal_recommended_interval()¶

Returns the recommended interval between external calibrations in months.

Return type: datetime.timedelta

Returns: Specifies the recommended interval between external calibrations in months.

get_fir_filter_coefficients¶

nifgen.Session.get_fir_filter_coefficients()¶
Returns the FIR filter coefficients used by the onboard signal processing block. These coefficients are determined by NI-FGEN and based on the FIR filter type and corresponding property (Alpha, Passband, BT) unless you are using the custom filter. If you are using a custom filter, the coefficients returned are those set with the nifgen_ConfigureCustomFIRFilterCoefficients method coerced to the quantized values used by the device.

To use this method, first call an instance of the nifgen.Session.get_fir_filter_coefficients() method with the coefficientsArray parameter set to VI_NULL. Calling the method in this state returns the current size of the coefficientsArray as the value of the numberOfCoefficientsRead parameter. Create an array of this size, and call the nifgen.Session.get_fir_filter_coefficients() method a second time, passing the new array as the coefficientsArray parameter and the size as the arraySize parameter. This second method call populates the array with the FIR filter coefficients.

Refer to the FIR Filter topic for your device in the NI Signal Generators Help for more information about FIR filter coefficients. This method is supported only for the NI 5441.

Default Value: None
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].get_fir_filter_coefficients()
Return type: int

Returns: Specifies the array of data containing the number of coefficients you want to read.

get_hardware_state¶

nifgen.Session.get_hardware_state()¶

Returns the current hardware state of the device and, if the device is in the hardware error state, the current hardware error.

Note

Hardware states do not necessarily correspond to NI-FGEN states.

Return type: nifgen.HardwareState

Returns: Returns the hardware state of the signal generator.
Defined Values

IDLE The device is in the Idle state.

WAITING_FOR_START_TRIGGER The device is waiting for Start Trigger.

RUNNING The device is in the Running state.

DONE The generation has completed successfully.

HARDWARE_ERROR There is a hardware error.

get_self_cal_last_date_and_time¶

nifgen.Session.get_self_cal_last_date_and_time()¶

Returns the date and time of the last successful self-calibration.

Return type: datetime.datetime

Returns: Returns the date and time the device was last calibrated.

get_self_cal_last_temp¶

nifgen.Session.get_self_cal_last_temp()¶

Returns the temperature at the last successful self-calibration. The temperature is returned in degrees Celsius.

Return type: float

Returns: Specifies the temperature at the last successful calibration in degrees Celsius.

get_self_cal_supported¶

nifgen.Session.get_self_cal_supported()¶

Returns whether the device supports self–calibration.

Return type: bool

Returns: Returns whether the device supports self-calibration.
**Defined Values**

True Self–calibration is supported.

False Self–calibration is not supported.

is_done¶

nifgen.Session.is_done()¶

Determines whether the current generation is complete. This method sets the done parameter to True if the session is in the Idle or Committed states.

Note

NI-FGEN only reports the done parameter as True after the current generation is complete in Single trigger mode.

Return type: bool

Returns: Returns information about the completion of waveform generation.
Defined Values

True Generation is complete.

False Generation is not complete.

query_arb_seq_capabilities¶

nifgen.Session.query_arb_seq_capabilities()¶

Returns the properties of the signal generator that are related to creating arbitrary sequences (the nifgen.Session.max_num_sequences, nifgen.Session.min_sequence_length, nifgen.Session.max_sequence_length, and nifgen.Session.max_loop_count properties).

Return type: tuple (maximum_number_of_sequences, minimum_sequence_length, maximum_sequence_length, maximum_loop_count)
WHERE

maximum_number_of_sequences (int):

Returns the maximum number of arbitrary waveform sequences that the signal generator allows. NI-FGEN obtains this value from the nifgen.Session.max_num_sequences property.

minimum_sequence_length (int):

Returns the minimum number of arbitrary waveforms the signal generator allows in a sequence. NI-FGEN obtains this value from the nifgen.Session.min_sequence_length property.

maximum_sequence_length (int):

Returns the maximum number of arbitrary waveforms the signal generator allows in a sequence. NI-FGEN obtains this value from the nifgen.Session.max_sequence_length property.

maximum_loop_count (int):

Returns the maximum number of times the signal generator can repeat an arbitrary waveform in a sequence. NI-FGEN obtains this value from the nifgen.Session.max_loop_count property.

query_arb_wfm_capabilities¶

nifgen.Session.query_arb_wfm_capabilities()¶

Returns the properties of the signal generator that are related to creating arbitrary waveforms. These properties are the maximum number of waveforms, waveform quantum, minimum waveform size, and maximum waveform size.

Note

If you do not want to obtain the waveform quantum, pass a value of VI_NULL for this parameter.

Return type: tuple (maximum_number_of_waveforms, waveform_quantum, minimum_waveform_size, maximum_waveform_size)
WHERE

maximum_number_of_waveforms (int):

Returns the maximum number of arbitrary waveforms that the signal generator allows. NI-FGEN obtains this value from the nifgen.Session.max_num_waveforms property.

waveform_quantum (int):

The size (number of points) of each waveform must be a multiple of a constant quantum value. This parameter obtains the quantum value that the signal generator uses. NI-FGEN returns this value from the nifgen.Session.waveform_quantum property.
For example, when this property returns a value of 8, all waveform sizes must be a multiple of 8.

minimum_waveform_size (int):

Returns the minimum number of points that the signal generator allows in a waveform. NI-FGEN obtains this value from the nifgen.Session.min_waveform_size property.

maximum_waveform_size (int):

Returns the maximum number of points that the signal generator allows in a waveform. NI-FGEN obtains this value from the nifgen.Session.max_waveform_size property.

query_freq_list_capabilities¶

nifgen.Session.query_freq_list_capabilities()¶

Returns the properties of the signal generator that are related to creating frequency lists. These properties are nifgen.Session.max_num_freq_lists, nifgen.Session.min_freq_list_length, nifgen.Session.max_freq_list_length, nifgen.Session.min_freq_list_duration, nifgen.Session.max_freq_list_duration, and nifgen.Session.freq_list_duration_quantum.

Return type: tuple (maximum_number_of_freq_lists, minimum_frequency_list_length, maximum_frequency_list_length, minimum_frequency_list_duration, maximum_frequency_list_duration, frequency_list_duration_quantum)
WHERE

maximum_number_of_freq_lists (int):

Returns the maximum number of frequency lists that the signal generator allows. NI-FGEN obtains this value from the nifgen.Session.max_num_freq_lists property.

minimum_frequency_list_length (int):

Returns the minimum number of steps that the signal generator allows in a frequency list. NI-FGEN obtains this value from the nifgen.Session.min_freq_list_length property.

maximum_frequency_list_length (int):

Returns the maximum number of steps that the signal generator allows in a frequency list. NI-FGEN obtains this value from the nifgen.Session.max_freq_list_length property.

minimum_frequency_list_duration (float):

Returns the minimum duration that the signal generator allows in a step of a frequency list. NI-FGEN obtains this value from the nifgen.Session.min_freq_list_duration property.

maximum_frequency_list_duration (float):

Returns the maximum duration that the signal generator allows in a step of a frequency list. NI-FGEN obtains this value from the nifgen.Session.max_freq_list_duration property.

frequency_list_duration_quantum (float):

Returns the quantum of which all durations must be a multiple in a frequency list. NI-FGEN obtains this value from the nifgen.Session.freq_list_duration_quantum property.

read_current_temperature¶

nifgen.Session.read_current_temperature()¶

Reads the current onboard temperature of the device. The temperature is returned in degrees Celsius.

Return type: float

Returns: Returns the current temperature read from onboard temperature sensors, in degrees Celsius.

reset¶

nifgen.Session.reset()¶

Resets the instrument to a known state. This method aborts the generation, clears all routes, and resets session properties to the default values. This method does not, however, commit the session properties or configure the device hardware to its default state.

Note

For the NI 5401/5404/5411/5431, this method exhibits the same behavior as the nifgen_ResetDevice method.

reset_device¶

nifgen.Session.reset_device()¶

Performs a hard reset on the device. Generation is stopped, all routes are released, external bidirectional terminals are tristated, FPGAs are reset, hardware is configured to its default state, and all session properties are reset to their default states.

reset_with_defaults¶

nifgen.Session.reset_with_defaults()¶

Resets the instrument and reapplies initial user–specified settings from the logical name that was used to initialize the session. If the session was created without a logical name, this method is equivalent to the nifgen_reset method.

self_cal¶

nifgen.Session.self_cal()¶

Performs a full internal self-calibration on the device. If the calibration is successful, new calibration data and constants are stored in the onboard EEPROM.

self_test¶

nifgen.Session.self_test()¶

Runs the instrument self-test routine and returns the test result(s).

Raises SelfTestError on self test failure. Properties on exception object:

code - failure code from driver

message - status message from driver

Self-Test Code Description

0 Passed self-test

1 Self-test failed

Note

When used on some signal generators, the device is reset after the nifgen.Session.self_test() method runs. If you use the nifgen.Session.self_test() method, your device may not be in its previously configured state after the method runs.

send_software_edge_trigger¶

nifgen.Session.send_software_edge_trigger(trigger, trigger_id)¶

Sends a command to trigger the signal generator. This VI can act as an override for an external edge trigger.

Note

This VI does not override external digital edge triggers of the NI 5401/5411/5431.

Parameters:

trigger (nifgen.Trigger) –
Sets the clock mode of the signal generator.

**Defined Values**

DIVIDE_DOWN

HIGH_RESOLUTION

AUTOMATIC

trigger_id (str) –

set_named_waveform_next_write_position¶

nifgen.Session.set_named_waveform_next_write_position(waveform_name, relative_to, offset)¶
Sets the position in the waveform to which data is written at the next write. This method allows you to write to arbitrary locations within the waveform. These settings apply only to the next write to the waveform specified by the waveformHandle parameter. Subsequent writes to that waveform begin where the last write left off, unless this method is called again. The waveformHandle passed in must have been created with a call to one of the following methods:

nifgen_AllocateWaveform

nifgen_CreateWaveformF64

nifgen_CreateWaveformI16

nifgen_CreateWaveformFromFileI16

nifgen_CreateWaveformFromFileF64

nifgen_CreateWaveformFromFileHWS
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].set_named_waveform_next_write_position(waveform_name, relative_to, offset)
Parameters:

waveform_name (str) – Specifies the name to associate with the allocated waveform.

relative_to (nifgen.RelativeTo) –
Specifies the reference position in the waveform. This position and offset together determine where to start loading data into the waveform.

**Defined Values**

START (0) Use the start of the waveform as the reference position.

CURRENT (1) Use the current position within the waveform as the reference position.

offset (int) – Specifies the offset from the relativeTo parameter at which to start loading the data into the waveform.

set_waveform_next_write_position¶

nifgen.Session.set_waveform_next_write_position(waveform_handle, relative_to, offset)¶
Sets the position in the waveform at which the next waveform data is written. This method allows you to write to arbitrary locations within the waveform. These settings apply only to the next write to the waveform specified by the waveformHandle parameter. Subsequent writes to that waveform begin where the last write left off, unless this method is called again. The waveformHandle passed in must have been created by a call to the nifgen_AllocateWaveform method or one of the following niFgen CreateWaveform methods:

nifgen_CreateWaveformF64

nifgen_CreateWaveformI16

nifgen_CreateWaveformFromFileI16

nifgen_CreateWaveformFromFileF64

nifgen_CreateWaveformFromFileHWS
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].set_waveform_next_write_position(waveform_handle, relative_to, offset)
Parameters:

waveform_handle (int) – Specifies the handle of the arbitrary waveform previously allocated with the nifgen_AllocateWaveform method.

relative_to (nifgen.RelativeTo) –
Specifies the reference position in the waveform. This position and offset together determine where to start loading data into the waveform.

**Defined Values**

START (0) Use the start of the waveform as the reference position.

CURRENT (1) Use the current position within the waveform as the reference position.

offset (int) – Specifies the offset from relativeTo at which to start loading the data into the waveform.

wait_until_done¶

nifgen.Session.wait_until_done(max_time=10000)¶

Waits until the device is done generating or until the maximum time has expired.

Parameters: max_time (float in seconds or datetime.timedelta) – Specifies the timeout value in milliseconds.

write_script¶

nifgen.Session.write_script(script)¶
Writes a string containing one or more scripts that govern the generation of waveforms.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].write_script(script)
Parameters: script (str) – Contains the text of the script you want to use for your generation operation. Refer to scripting Instructions for more information about writing scripts.

write_waveform¶

nifgen.Session.write_waveform(waveform_name_or_handle, data)¶
Writes data to the waveform in onboard memory.

By default, subsequent calls to this method continue writing data from the position of the last sample written. You can set the write position and offset by calling the nifgen_SetNamedWaveformNextWritePosition nifgen_SetWaveformNextWritePosition method.
Tip

This method requires repeated capabilities (usually channels). If called directly on the nifgen.Session object, then the method will use all repeated capabilities in the session. You can specify a subset of repeated capabilities using the Python index notation on an nifgen.Session instance, and calling this method on the result.:
session.channels['0,1'].write_waveform(waveform_name_or_handle, data)
Parameters:

waveform_name_or_handle (int) – The name (str) or handle (int) of an arbitrary waveform previously allocated with nifgen.Session.allocate_named_waveform() or nifgen.Session.allocate_waveform().

data (list of float) – Array of data to load into the waveform. This may be an iterable of float, or for best performance a numpy.ndarray of dtype int16 or float64.

Properties¶

Property	Datatype
`nifgen.Session.all_marker_events_latched_status`	int
`nifgen.Session.all_marker_events_live_status`	int
`nifgen.Session.analog_data_mask`	int
`nifgen.Session.analog_filter_enabled`	bool
`nifgen.Session.analog_path`	`AnalogPath`
`nifgen.Session.analog_static_value`	int
`nifgen.Session.arb_gain`	float
`nifgen.Session.arb_marker_position`	int
`nifgen.Session.arb_offset`	float
`nifgen.Session.arb_repeat_count`	int
`nifgen.Session.arb_sample_rate`	float
`nifgen.Session.arb_sequence_handle`	int
`nifgen.Session.arb_waveform_handle`	int
`nifgen.Session.aux_power_enabled`	bool
`nifgen.Session.bus_type`	`BusType`
`nifgen.Session.channel_delay`	float
`nifgen.Session.clock_mode`	`ClockMode`
`nifgen.Session.common_mode_offset`	float
`nifgen.Session.data_marker_events_count`	int
`nifgen.Session.data_marker_event_data_bit_number`	int
`nifgen.Session.data_marker_event_level_polarity`	`DataMarkerEventLevelPolarity`
`nifgen.Session.data_marker_event_output_terminal`	str
`nifgen.Session.data_transfer_block_size`	int
`nifgen.Session.data_transfer_maximum_bandwidth`	float
`nifgen.Session.data_transfer_maximum_in_flight_reads`	int
`nifgen.Session.data_transfer_preferred_packet_size`	int
`nifgen.Session.digital_data_mask`	int
`nifgen.Session.digital_edge_script_trigger_edge`	`ScriptTriggerDigitalEdgeEdge`
`nifgen.Session.digital_edge_script_trigger_source`	str
`nifgen.Session.digital_edge_start_trigger_edge`	`StartTriggerDigitalEdgeEdge`
`nifgen.Session.digital_edge_start_trigger_source`	str
`nifgen.Session.digital_filter_enabled`	bool
`nifgen.Session.digital_filter_interpolation_factor`	float
`nifgen.Session.digital_gain`	float
`nifgen.Session.digital_level_script_trigger_active_level`	`ScriptTriggerDigitalLevelActiveLevel`
`nifgen.Session.digital_level_script_trigger_source`	str
`nifgen.Session.digital_pattern_enabled`	bool
`nifgen.Session.digital_static_value`	int
`nifgen.Session.direct_dma_enabled`	bool
`nifgen.Session.direct_dma_window_address`	int
`nifgen.Session.direct_dma_window_size`	int
`nifgen.Session.done_event_delay`	float
`nifgen.Session.done_event_delay_units`	`DoneEventDelayUnits`
`nifgen.Session.done_event_latched_status`	bool
`nifgen.Session.done_event_level_active_level`	`DoneEventActiveLevel`
`nifgen.Session.done_event_output_behavior`	`DoneEventOutputBehavior`
`nifgen.Session.done_event_output_terminal`	str
`nifgen.Session.done_event_pulse_polarity`	`DoneEventPulsePolarity`
`nifgen.Session.done_event_pulse_width`	float
`nifgen.Session.done_event_pulse_width_units`	`DoneEventPulseWidthUnits`
`nifgen.Session.driver_setup`	str
`nifgen.Session.exported_onboard_reference_clock_output_terminal`	str
`nifgen.Session.exported_reference_clock_output_terminal`	str
`nifgen.Session.exported_sample_clock_divisor`	int
`nifgen.Session.exported_sample_clock_output_terminal`	str
`nifgen.Session.exported_sample_clock_timebase_divisor`	int
`nifgen.Session.exported_sample_clock_timebase_output_terminal`	str
`nifgen.Session.exported_script_trigger_output_terminal`	str
`nifgen.Session.exported_start_trigger_output_terminal`	str
`nifgen.Session.external_clock_delay_binary_value`	int
`nifgen.Session.external_sample_clock_multiplier`	float
`nifgen.Session.file_transfer_block_size`	int
`nifgen.Session.filter_correction_frequency`	float
`nifgen.Session.flatness_correction_enabled`	bool
`nifgen.Session.fpga_bitfile_path`	str
`nifgen.Session.freq_list_duration_quantum`	float
`nifgen.Session.freq_list_handle`	int
`nifgen.Session.func_amplitude`	float
`nifgen.Session.func_buffer_size`	int
`nifgen.Session.func_dc_offset`	float
`nifgen.Session.func_duty_cycle_high`	float
`nifgen.Session.func_frequency`	float
`nifgen.Session.func_max_buffer_size`	int
`nifgen.Session.func_start_phase`	float
`nifgen.Session.func_waveform`	`Waveform`
`nifgen.Session.gain_dac_value`	int
`nifgen.Session.idle_behavior`	`IdleBehavior`
`nifgen.Session.idle_value`	int
`nifgen.Session.id_query_response`	str
`nifgen.Session.instrument_firmware_revision`	str
`nifgen.Session.instrument_manufacturer`	str
`nifgen.Session.instrument_model`	str
`nifgen.Session.io_resource_descriptor`	str
`nifgen.Session.load_impedance`	float
`nifgen.Session.logical_name`	str
`nifgen.Session.major_version`	int
`nifgen.Session.marker_events_count`	int
`nifgen.Session.marker_event_delay`	float
`nifgen.Session.marker_event_delay_units`	`MarkerEventDelayUnits`
`nifgen.Session.marker_event_latched_status`	bool
`nifgen.Session.marker_event_live_status`	bool
`nifgen.Session.marker_event_output_behavior`	`MarkerEventOutputBehavior`
`nifgen.Session.marker_event_output_terminal`	str
`nifgen.Session.marker_event_pulse_polarity`	`MarkerEventPulsePolarity`
`nifgen.Session.marker_event_pulse_width`	float
`nifgen.Session.marker_event_pulse_width_units`	`MarkerEventPulseWidthUnits`
`nifgen.Session.marker_event_toggle_initial_state`	`MarkerEventToggleInitialState`
`nifgen.Session.max_freq_list_duration`	float
`nifgen.Session.max_freq_list_length`	int
`nifgen.Session.max_loop_count`	int
`nifgen.Session.max_num_freq_lists`	int
`nifgen.Session.max_num_sequences`	int
`nifgen.Session.max_num_waveforms`	int
`nifgen.Session.max_sequence_length`	int
`nifgen.Session.max_waveform_size`	int
`nifgen.Session.memory_size`	int
`nifgen.Session.minor_version`	int
`nifgen.Session.min_freq_list_duration`	float
`nifgen.Session.min_freq_list_length`	int
`nifgen.Session.min_sequence_length`	int
`nifgen.Session.min_waveform_size`	int
`nifgen.Session.module_revision`	str
`nifgen.Session.num_channels`	int
`nifgen.Session.offset_dac_value`	int
`nifgen.Session.oscillator_freq_dac_value`	int
`nifgen.Session.oscillator_phase_dac_value`	int
`nifgen.Session.osp_carrier_enabled`	bool
`nifgen.Session.osp_carrier_frequency`	float
`nifgen.Session.osp_carrier_phase_i`	float
`nifgen.Session.osp_carrier_phase_q`	float
`nifgen.Session.osp_cic_filter_enabled`	bool
`nifgen.Session.osp_cic_filter_gain`	float
`nifgen.Session.osp_cic_filter_interpolation`	float
`nifgen.Session.osp_compensate_for_filter_group_delay`	bool
`nifgen.Session.osp_data_processing_mode`	`DataProcessingMode`
`nifgen.Session.osp_enabled`	bool
`nifgen.Session.osp_fir_filter_enabled`	bool
`nifgen.Session.osp_fir_filter_flat_passband`	float
`nifgen.Session.osp_fir_filter_gaussian_bt`	float
`nifgen.Session.osp_fir_filter_interpolation`	float
`nifgen.Session.osp_fir_filter_raised_cosine_alpha`	float
`nifgen.Session.osp_fir_filter_root_raised_cosine_alpha`	float
`nifgen.Session.osp_fir_filter_type`	`FilterType`
`nifgen.Session.osp_frequency_shift`	float
`nifgen.Session.osp_mode`	`OSPMode`
`nifgen.Session.osp_overflow_error_reporting`	`OSPOverflowErrorReporting`
`nifgen.Session.osp_overflow_status`	int
`nifgen.Session.osp_pre_filter_gain_i`	float
`nifgen.Session.osp_pre_filter_gain_q`	float
`nifgen.Session.osp_pre_filter_offset_i`	float
`nifgen.Session.osp_pre_filter_offset_q`	float
`nifgen.Session.output_enabled`	bool
`nifgen.Session.output_impedance`	float
`nifgen.Session.output_mode`	`OutputMode`
`nifgen.Session.p2p_endpoint_fullness_start_trigger_level`	int
`nifgen.Session.pci_dma_optimizations_enabled`	bool
`nifgen.Session.post_amplifier_attenuation`	float
`nifgen.Session.pre_amplifier_attenuation`	float
`nifgen.Session.ready_for_start_event_level_active_level`	`ReadyForStartEventActiveLevel`
`nifgen.Session.ready_for_start_event_live_status`	bool
`nifgen.Session.ready_for_start_event_output_terminal`	str
`nifgen.Session.reference_clock_source`	`ReferenceClockSource`
`nifgen.Session.ref_clock_frequency`	float
`nifgen.Session.sample_clock_absolute_delay`	float
`nifgen.Session.sample_clock_source`	`SampleClockSource`
`nifgen.Session.sample_clock_timebase_rate`	float
`nifgen.Session.sample_clock_timebase_source`	`SampleClockTimebaseSource`
`nifgen.Session.script_to_generate`	str
`nifgen.Session.script_triggers_count`	int
`nifgen.Session.script_trigger_type`	`ScriptTriggerType`
`nifgen.Session.serial_number`	str
`nifgen.Session.simulate`	bool
`nifgen.Session.specific_driver_description`	str
`nifgen.Session.specific_driver_revision`	str
`nifgen.Session.specific_driver_vendor`	str
`nifgen.Session.started_event_delay`	float
`nifgen.Session.started_event_delay_units`	`StartedEventDelayUnits`
`nifgen.Session.started_event_latched_status`	bool
`nifgen.Session.started_event_level_active_level`	`StartedEventActiveLevel`
`nifgen.Session.started_event_output_behavior`	`StartedEventOutputBehavior`
`nifgen.Session.started_event_output_terminal`	str
`nifgen.Session.started_event_pulse_polarity`	`StartedEventPulsePolarity`
`nifgen.Session.started_event_pulse_width`	float
`nifgen.Session.started_event_pulse_width_units`	`StartedEventPulseWidthUnits`
`nifgen.Session.start_trigger_type`	`StartTriggerType`
`nifgen.Session.streaming_space_available_in_waveform`	int
`nifgen.Session.streaming_waveform_handle`	int
`nifgen.Session.streaming_waveform_name`	str
`nifgen.Session.streaming_write_timeout`	float in seconds or datetime.timedelta
`nifgen.Session.supported_instrument_models`	str
`nifgen.Session.synchronization`	`SynchronizationSource`
`nifgen.Session.sync_duty_cycle_high`	float
`nifgen.Session.sync_out_output_terminal`	str
`nifgen.Session.terminal_configuration`	`TerminalConfiguration`
`nifgen.Session.trigger_mode`	`TriggerMode`
`nifgen.Session.trigger_source`	`TriggerSource`
`nifgen.Session.video_waveform_type`	`VideoWaveformType`
`nifgen.Session.wait_behavior`	`WaitBehavior`
`nifgen.Session.wait_value`	int
`nifgen.Session.waveform_quantum`	int

Methods¶

Method name
`nifgen.Session.abort()`
`nifgen.Session.allocate_named_waveform()`
`nifgen.Session.allocate_waveform()`
`nifgen.Session.clear_arb_memory()`
`nifgen.Session.clear_arb_sequence()`
`nifgen.Session.clear_arb_waveform()`
`nifgen.Session.clear_freq_list()`
`nifgen.Session.clear_user_standard_waveform()`
`nifgen.Session.commit()`
`nifgen.Session.configure_arb_sequence()`
`nifgen.Session.configure_arb_waveform()`
`nifgen.Session.configure_custom_fir_filter_coefficients()`
`nifgen.Session.configure_digital_edge_script_trigger()`
`nifgen.Session.configure_digital_edge_start_trigger()`
`nifgen.Session.configure_digital_level_script_trigger()`
`nifgen.Session.configure_freq_list()`
`nifgen.Session.configure_standard_waveform()`
`nifgen.Session.create_advanced_arb_sequence()`
`nifgen.Session.create_arb_sequence()`
`nifgen.Session.create_freq_list()`
`nifgen.Session.create_waveform_from_file_f64()`
`nifgen.Session.create_waveform_from_file_i16()`
`nifgen.Session.create_waveform_numpy()`
`nifgen.Session.define_user_standard_waveform()`
`nifgen.Session.delete_named_waveform()`
`nifgen.Session.delete_script()`
`nifgen.Session.disable()`
`nifgen.Session.get_ext_cal_last_date_and_time()`
`nifgen.Session.get_ext_cal_last_temp()`
`nifgen.Session.get_ext_cal_recommended_interval()`
`nifgen.Session.get_fir_filter_coefficients()`
`nifgen.Session.get_hardware_state()`
`nifgen.Session.get_self_cal_last_date_and_time()`
`nifgen.Session.get_self_cal_last_temp()`
`nifgen.Session.get_self_cal_supported()`
`nifgen.Session.is_done()`
`nifgen.Session.query_arb_seq_capabilities()`
`nifgen.Session.query_arb_wfm_capabilities()`
`nifgen.Session.query_freq_list_capabilities()`
`nifgen.Session.read_current_temperature()`
`nifgen.Session.reset()`
`nifgen.Session.reset_device()`
`nifgen.Session.reset_with_defaults()`
`nifgen.Session.self_cal()`
`nifgen.Session.self_test()`
`nifgen.Session.send_software_edge_trigger()`
`nifgen.Session.set_named_waveform_next_write_position()`
`nifgen.Session.set_waveform_next_write_position()`
`nifgen.Session.wait_until_done()`
`nifgen.Session.write_script()`
`nifgen.Session.write_waveform()`