nidaqmx.task.ai_channel_collection

class nidaqmx._task_modules.ai_channel_collection.AIChannelCollection(task_handle)[source]

Bases: nidaqmx._task_modules.channel_collection.ChannelCollection

Contains the collection of analog input channels for a DAQmx Task.

add_ai_accel_4_wire_dc_voltage_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 5.0, max_val=5.0, units=AccelUnits.G, sensitivity=1000.0, sensitivity_units=AccelSensitivityUnits.MILLIVOLTS_PER_G, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=0.0, use_excit_for_scaling=False, custom_scale_name='')[source]

Creates channel(s) to measure acceleration. Use this instance for custom sensors that require excitation. You can use the excitation to scale the measurement.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.AccelUnits]) – Specifies the units to use to return acceleration measurements from the channel.

  • sensitivity (Optional[float]) – Is the sensitivity of the sensor. This value is in the units you specify with the sensitivity_units input. Refer to the sensor documentation to determine this value.

  • sensitivity_units (Optional[nidaqmx.constants.AccelSensitivityUnits]) – Specifies the units of the sensitivity input.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • voltage_excit_val (Optional[float]) – Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values.

  • use_excit_for_scaling (Optional[bool]) – Specifies if NI- DAQmx divides the measurement by the excitation. You should typically set use_excit_for_scaling to True for ratiometric transducers. If you set use_excit_for_scaling to True, set max_val and min_val to reflect the scaling.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_accel_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 5.0, max_val=5.0, units=AccelUnits.G, sensitivity=1000.0, sensitivity_units=AccelSensitivityUnits.MILLIVOLTS_PER_G, current_excit_source=ExcitationSource.INTERNAL, current_excit_val=0.004, custom_scale_name='')[source]

Creates channel(s) that use an accelerometer to measure acceleration.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.AccelUnits]) – Specifies the units to use to return acceleration measurements from the channel.

  • sensitivity (Optional[float]) – Is the sensitivity of the sensor. This value is in the units you specify with the sensitivity_units input. Refer to the sensor documentation to determine this value.

  • sensitivity_units (Optional[nidaqmx.constants.AccelSensitivityUnits]) – Specifies the units of the sensitivity input.

  • current_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • current_excit_val (Optional[float]) – Specifies in amperes the amount of excitation to supply to the sensor. Refer to the sensor documentation to determine this value.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_accel_charge_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 5.0, max_val=5.0, units=AccelUnits.G, sensitivity=100.0, sensitivity_units=AccelChargeSensitivityUnits.PICO_COULOMBS_PER_G, custom_scale_name='')[source]

Creates channel(s) that use a charge-based sensor to measure acceleration.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.AccelUnits]) – Specifies the units to use to return acceleration measurements from the channel.

  • sensitivity (Optional[float]) – Is the sensitivity of the sensor. This value is in the units you specify with the sensitivity_units input. Refer to the sensor documentation to determine this value.

  • sensitivity_units (Optional[nidaqmx.constants.AccelChargeSensitivityUnits]) – Specifies the units of the sensitivity input.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_bridge_chan(physical_channel, name_to_assign_to_channel='', min_val=- 0.002, max_val=0.002, units=BridgeUnits.VOLTS_PER_VOLT, bridge_config=BridgeConfiguration.FULL_BRIDGE, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, nominal_bridge_resistance=350.0, custom_scale_name='')[source]

Creates channel(s) that measure voltage ratios from a Wheatstone bridge. Use this instance with bridge-based sensors that measure phenomena other than strain, force, pressure, or torque, or that scale data to physical units NI-DAQmx does not support.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.BridgeUnits]) – Specifies in which unit to return voltage ratios from the channel.

  • bridge_config (Optional[nidaqmx.constants.BridgeConfiguration]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_val (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • nominal_bridge_resistance (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_charge_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 1e-09, max_val=1e-09, units=ChargeUnits.COULOMBS, custom_scale_name='')[source]

Creates channel(s) that use a sensor with charge output.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.ChargeUnits]) – Specifies the units to use to return charge measurements from the channel.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_current_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 0.01, max_val=0.01, units=CurrentUnits.AMPS, shunt_resistor_loc=CurrentShuntResistorLocation.LET_DRIVER_CHOOSE, ext_shunt_resistor_val=249.0, custom_scale_name='')[source]

Creates channel(s) to measure current.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.CurrentUnits]) – Specifies the units to use to return current measurements.

  • shunt_resistor_loc (Optional[nidaqmx.constants.CurrentShuntResistorLocation]) – Specifies the location of the shunt resistor. For devices with built-in shunt resistors, specify the location as INTERNAL. For devices that do not have built-in shunt resistors, you must attach an external one, set this input to EXTERNAL and use the ext_shunt_resistor_val input to specify the value of the resistor.

  • ext_shunt_resistor_val (Optional[float]) – Specifies in ohms the resistance of an external shunt resistor.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_current_rms_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 0.01, max_val=0.01, units=CurrentUnits.AMPS, shunt_resistor_loc=CurrentShuntResistorLocation.LET_DRIVER_CHOOSE, ext_shunt_resistor_val=249.0, custom_scale_name='')[source]

Creates a channel to measure current RMS, the average (mean) power of the acquired current.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.CurrentUnits]) – Specifies the units to use to return current measurements.

  • shunt_resistor_loc (Optional[nidaqmx.constants.CurrentShuntResistorLocation]) – Specifies the location of the shunt resistor. For devices with built-in shunt resistors, specify the location as INTERNAL. For devices that do not have built-in shunt resistors, you must attach an external one, set this input to EXTERNAL and use the ext_shunt_resistor_val input to specify the value of the resistor.

  • ext_shunt_resistor_val (Optional[float]) – Specifies in ohms the resistance of an external shunt resistor.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_force_bridge_polynomial_chan(physical_channel, name_to_assign_to_channel='', min_val=- 100.0, max_val=100.0, units=ForceUnits.POUNDS, bridge_config=BridgeConfiguration.FULL_BRIDGE, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, nominal_bridge_resistance=350.0, forward_coeffs=None, reverse_coeffs=None, electrical_units=BridgeElectricalUnits.MILLIVOLTS_PER_VOLT, physical_units=BridgePhysicalUnits.POUNDS, custom_scale_name='')[source]

Creates channel(s) that use a Wheatstone bridge to measure force or load. Use this instance with sensors whose specifications provide a polynomial to convert electrical values to physical values. When you use this scaling type, NI-DAQmx requires coefficients for a polynomial that converts electrical values to physical values (forward), as well as coefficients for a polynomial that converts physical values to electrical values (reverse). If you only know one set of coefficients, use the DAQmx Compute Reverse Polynomial Coefficients function to generate the other set.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.ForceUnits]) – Specifies in which unit to return force measurements from the channel.

  • bridge_config (Optional[nidaqmx.constants.BridgeConfiguration]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_val (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • nominal_bridge_resistance (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • forward_coeffs (Optional[List[float]]) – Specifies how to scale electrical values from the sensor to physical units.

  • reverse_coeffs (Optional[List[float]]) – Specifies how to scale electrical values from the sensor to physical units.

  • electrical_units (Optional[nidaqmx.constants.BridgeElectricalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • physical_units (Optional[nidaqmx.constants.BridgePhysicalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_force_bridge_table_chan(physical_channel, name_to_assign_to_channel='', min_val=- 100.0, max_val=100.0, units=ForceUnits.POUNDS, bridge_config=BridgeConfiguration.FULL_BRIDGE, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, nominal_bridge_resistance=350.0, electrical_vals=None, electrical_units=BridgeElectricalUnits.MILLIVOLTS_PER_VOLT, physical_vals=None, physical_units=BridgePhysicalUnits.POUNDS, custom_scale_name='')[source]

Creates channel(s) that use a Wheatstone bridge to measure force or load. Use this instance with sensors whose specifications provide a table of electrical values and the corresponding physical values. When you use this scaling type, NI-DAQmx performs linear scaling between each pair of electrical and physical values. The input limits specified with min_val and max_val must fall within the smallest and largest physical values. For any data outside those endpoints, NI-DAQmx coerces that data to the endpoints.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.ForceUnits]) – Specifies in which unit to return force measurements from the channel.

  • bridge_config (Optional[nidaqmx.constants.BridgeConfiguration]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_val (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • nominal_bridge_resistance (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • electrical_vals (Optional[List[float]]) – Specifies how to scale electrical values from the sensor to physical units.

  • electrical_units (Optional[nidaqmx.constants.BridgeElectricalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • physical_vals (Optional[List[float]]) – Specifies how to scale electrical values from the sensor to physical units.

  • physical_units (Optional[nidaqmx.constants.BridgePhysicalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_force_bridge_two_point_lin_chan(physical_channel, name_to_assign_to_channel='', min_val=- 100.0, max_val=100.0, units=ForceUnits.POUNDS, bridge_config=BridgeConfiguration.FULL_BRIDGE, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, nominal_bridge_resistance=350.0, first_electrical_val=0.0, second_electrical_val=2.0, electrical_units=BridgeElectricalUnits.MILLIVOLTS_PER_VOLT, first_physical_val=0.0, second_physical_val=100.0, physical_units=BridgePhysicalUnits.POUNDS, custom_scale_name='')[source]

Creates channel(s) that use a Wheatstone bridge to measure force or load. Use this instance with sensors whose specifications do not provide a polynomial for scaling or a table of electrical and physical values. When you use this scaling type, NI-DAQmx uses two points of electrical and physical values to calculate the slope and y-intercept of a linear equation and uses that equation to scale electrical values to physical values.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.ForceUnits]) – Specifies in which unit to return force measurements from the channel.

  • bridge_config (Optional[nidaqmx.constants.BridgeConfiguration]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_val (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • nominal_bridge_resistance (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • first_electrical_val (Optional[float]) – Specifies how to scale electrical values from the sensor to physical units.

  • second_electrical_val (Optional[float]) – Specifies how to scale electrical values from the sensor to physical units.

  • electrical_units (Optional[nidaqmx.constants.BridgeElectricalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • first_physical_val (Optional[float]) – Specifies how to scale electrical values from the sensor to physical units.

  • second_physical_val (Optional[float]) – Specifies how to scale electrical values from the sensor to physical units.

  • physical_units (Optional[nidaqmx.constants.BridgePhysicalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_force_iepe_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 2000.0, max_val=2000.0, units=ForceUnits.NEWTONS, sensitivity=2.25, sensitivity_units=ForceIEPESensorSensitivityUnits.MILLIVOLTS_PER_NEWTON, current_excit_source=ExcitationSource.INTERNAL, current_excit_val=0.004, custom_scale_name='')[source]

Creates channel(s) that use an IEPE force sensor to measure force or load.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.ForceUnits]) – Specifies in which unit to return force measurements from the channel.

  • sensitivity (Optional[float]) – Is the sensitivity of the sensor. This value is in the units you specify with the sensitivity_units input. Refer to the sensor documentation to determine this value.

  • sensitivity_units (Optional[nidaqmx.constants.ForceIEPESensorSensitivityUnits]) – Specifies the units of the sensitivity input.

  • current_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • current_excit_val (Optional[float]) – Specifies in amperes the amount of excitation to supply to the sensor. Refer to the sensor documentation to determine this value.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_freq_voltage_chan(physical_channel, name_to_assign_to_channel='', min_val=1, max_val=100, units=FrequencyUnits.HZ, threshold_level=0.0, hysteresis=0.0, custom_scale_name='')[source]

Creates channel(s) that use a frequency-to-voltage converter to measure frequency.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.FrequencyUnits]) – Specifies the units to use to return frequency measurements.

  • threshold_level (Optional[float]) – Specifies in volts the level at which to recognize waveform repetitions. You should select a voltage level that occurs only once within the entire period of a waveform. You also can select a voltage that occurs only once while the voltage rises or falls.

  • hysteresis (Optional[float]) – Specifies in volts a window below level. The input voltage must pass below threshold_level minus hysteresis before NI-DAQmx recognizes a waveform repetition. Hysteresis can improve measurement accuracy when the signal contains noise or jitter.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_microphone_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, units=SoundPressureUnits.PA, mic_sensitivity=10.0, max_snd_press_level=100.0, current_excit_source=ExcitationSource.INTERNAL, current_excit_val=0.004, custom_scale_name='')[source]

Creates channel(s) that use a microphone to measure sound pressure.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • units (Optional[nidaqmx.constants.SoundPressureUnits]) – Specifies the units to use to return sound pressure measurements.

  • mic_sensitivity (Optional[float]) – Is the sensitivity of the microphone. Specify this value in mV/Pa.

  • max_snd_press_level (Optional[float]) – Is the maximum instantaneous sound pressure level you expect to measure. This value is in decibels, referenced to 20 micropascals.

  • current_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • current_excit_val (Optional[float]) – Specifies in amperes the amount of excitation to supply to the sensor. Refer to the sensor documentation to determine this value.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_pos_eddy_curr_prox_probe_chan(physical_channel, name_to_assign_to_channel='', min_val=0.0, max_val=0.00254, units=LengthUnits.METERS, sensitivity=200.0, sensitivity_units=EddyCurrentProxProbeSensitivityUnits.MILLIVOLTS_PER_MIL, custom_scale_name='')[source]

Creates channel(s) that use an eddy current proximity probe to measure position.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.LengthUnits]) – Specifies the units to use to return position measurements from the channel.

  • sensitivity (Optional[float]) – Is the sensitivity of the sensor. This value is in the units you specify with the sensitivity_units input. Refer to the sensor documentation to determine this value.

  • sensitivity_units (Optional[nidaqmx.constants.EddyCurrentProxProbeSensitivityUnits]) – Specifies the units of the sensitivity input.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_pos_lvdt_chan(physical_channel, name_to_assign_to_channel='', min_val=- 0.1, max_val=0.1, units=LengthUnits.METERS, sensitivity=50.0, sensitivity_units=LVDTSensitivityUnits.MILLIVOLTS_PER_VOLT_PER_MILLIMETER, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=1.0, voltage_excit_freq=2500.0, ac_excit_wire_mode=ACExcitWireMode.FOUR_WIRE, custom_scale_name='')[source]

Creates channel(s) that use an LVDT to measure linear position.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.LengthUnits]) – Specifies the units to use to return linear position measurements from the channel.

  • sensitivity (Optional[float]) – Is the sensitivity of the sensor. This value is in the units you specify with the sensitivity_units input. Refer to the sensor documentation to determine this value.

  • sensitivity_units (Optional[nidaqmx.constants.LVDTSensitivityUnits]) – Specifies the units of the sensitivity input.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • voltage_excit_val (Optional[float]) – Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values.

  • voltage_excit_freq (Optional[float]) – Specifies in hertz the excitation frequency that the sensor requires. Refer to the sensor documentation to determine this value.

  • ac_excit_wire_mode (Optional[nidaqmx.constants.ACExcitWireMode]) – Is the number of leads on the sensor. Some sensors require you to tie leads together to create a four- or five- wire sensor. Refer to the sensor documentation for more information.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_pos_rvdt_chan(physical_channel, name_to_assign_to_channel='', min_val=- 70.0, max_val=70.0, units=AngleUnits.DEGREES, sensitivity=50.0, sensitivity_units=RVDTSensitivityUnits.MILLIVOLTS_PER_VOLT_PER_DEGREE, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=1.0, voltage_excit_freq=2500.0, ac_excit_wire_mode=ACExcitWireMode.FOUR_WIRE, custom_scale_name='')[source]

Creates channel(s) that use an RVDT to measure angular position.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.AngleUnits]) – Specifies the units to use to return angular position measurements from the channel.

  • sensitivity (Optional[float]) – Is the sensitivity of the sensor. This value is in the units you specify with the sensitivity_units input. Refer to the sensor documentation to determine this value.

  • sensitivity_units (Optional[nidaqmx.constants.RVDTSensitivityUnits]) – Specifies the units of the sensitivity input.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • voltage_excit_val (Optional[float]) – Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values.

  • voltage_excit_freq (Optional[float]) – Specifies in hertz the excitation frequency that the sensor requires. Refer to the sensor documentation to determine this value.

  • ac_excit_wire_mode (Optional[nidaqmx.constants.ACExcitWireMode]) – Is the number of leads on the sensor. Some sensors require you to tie leads together to create a four- or five- wire sensor. Refer to the sensor documentation for more information.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_power_chan(physical_channel, voltage_setpoint, current_setpoint, output_enable, name_to_assign_to_channel='')[source]

Creates channel(s) to measure power.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • voltage_setpoint (float) – Specifies in volts the constant output voltage.

  • current_setpoint (float) – Specifies in amperes the output current.

  • output_enable (bool) – Specifies whether to enable or disable the output.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_pressure_bridge_polynomial_chan(physical_channel, name_to_assign_to_channel='', min_val=- 100.0, max_val=100.0, units=PressureUnits.POUNDS_PER_SQ_INCH, bridge_config=BridgeConfiguration.FULL_BRIDGE, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, nominal_bridge_resistance=350.0, forward_coeffs=None, reverse_coeffs=None, electrical_units=BridgeElectricalUnits.MILLIVOLTS_PER_VOLT, physical_units=BridgePhysicalUnits.POUNDS_PER_SQ_INCH, custom_scale_name='')[source]

Creates channel(s) that use a Wheatstone bridge to measure pressure. Use this instance with sensors whose specifications provide a polynomial to convert electrical values to physical values. When you use this scaling type, NI-DAQmx requires coefficients for a polynomial that converts electrical values to physical values (forward), as well as coefficients for a polynomial that converts physical values to electrical values (reverse). If you only know one set of coefficients, use the DAQmx Compute Reverse Polynomial Coefficients function to generate the other set.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.PressureUnits]) – Specifies in which unit to return pressure measurements from the channel.

  • bridge_config (Optional[nidaqmx.constants.BridgeConfiguration]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_val (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • nominal_bridge_resistance (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • forward_coeffs (Optional[List[float]]) – Specifies how to scale electrical values from the sensor to physical units.

  • reverse_coeffs (Optional[List[float]]) – Specifies how to scale electrical values from the sensor to physical units.

  • electrical_units (Optional[nidaqmx.constants.BridgeElectricalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • physical_units (Optional[nidaqmx.constants.BridgePhysicalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_pressure_bridge_table_chan(physical_channel, name_to_assign_to_channel='', min_val=- 100.0, max_val=100.0, units=PressureUnits.POUNDS_PER_SQ_INCH, bridge_config=BridgeConfiguration.FULL_BRIDGE, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, nominal_bridge_resistance=350.0, electrical_vals=None, electrical_units=BridgeElectricalUnits.MILLIVOLTS_PER_VOLT, physical_vals=None, physical_units=BridgePhysicalUnits.POUNDS_PER_SQ_INCH, custom_scale_name='')[source]

Creates channel(s) that use a Wheatstone bridge to measure pressure. Use this instance with sensors whose specifications provide a table of electrical values and the corresponding physical values. When you use this scaling type, NI-DAQmx performs linear scaling between each pair of electrical and physical values. The input limits specified with min_val and max_val must fall within the smallest and largest physical values. For any data outside those endpoints, NI-DAQmx coerces that data to the endpoints.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.PressureUnits]) – Specifies in which unit to return pressure measurements from the channel.

  • bridge_config (Optional[nidaqmx.constants.BridgeConfiguration]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_val (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • nominal_bridge_resistance (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • electrical_vals (Optional[List[float]]) – Specifies how to scale electrical values from the sensor to physical units.

  • electrical_units (Optional[nidaqmx.constants.BridgeElectricalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • physical_vals (Optional[List[float]]) – Specifies how to scale electrical values from the sensor to physical units.

  • physical_units (Optional[nidaqmx.constants.BridgePhysicalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_pressure_bridge_two_point_lin_chan(physical_channel, name_to_assign_to_channel='', min_val=- 100.0, max_val=100.0, units=PressureUnits.POUNDS_PER_SQ_INCH, bridge_config=BridgeConfiguration.FULL_BRIDGE, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, nominal_bridge_resistance=350.0, first_electrical_val=0.0, second_electrical_val=2.0, electrical_units=BridgeElectricalUnits.MILLIVOLTS_PER_VOLT, first_physical_val=0.0, second_physical_val=100.0, physical_units=BridgePhysicalUnits.POUNDS_PER_SQ_INCH, custom_scale_name='')[source]

Creates channel(s) that use a Wheatstone bridge to measure pressure. Use this instance with sensors whose specifications do not provide a polynomial for scaling or a table of electrical and physical values. When you use this scaling type, NI-DAQmx uses two points of electrical and physical values to calculate the slope and y-intercept of a linear equation and uses that equation to scale electrical values to physical values.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.PressureUnits]) – Specifies in which unit to return pressure measurements from the channel.

  • bridge_config (Optional[nidaqmx.constants.BridgeConfiguration]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_val (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • nominal_bridge_resistance (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • first_electrical_val (Optional[float]) – Specifies how to scale electrical values from the sensor to physical units.

  • second_electrical_val (Optional[float]) – Specifies how to scale electrical values from the sensor to physical units.

  • electrical_units (Optional[nidaqmx.constants.BridgeElectricalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • first_physical_val (Optional[float]) – Specifies how to scale electrical values from the sensor to physical units.

  • second_physical_val (Optional[float]) – Specifies how to scale electrical values from the sensor to physical units.

  • physical_units (Optional[nidaqmx.constants.BridgePhysicalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_resistance_chan(physical_channel, name_to_assign_to_channel='', min_val=100.0, max_val=1000.0, units=ResistanceUnits.OHMS, resistance_config=ResistanceConfiguration.TWO_WIRE, current_excit_source=ExcitationSource.EXTERNAL, current_excit_val=0.001, custom_scale_name='')[source]

Creates channel(s) to measure resistance.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.ResistanceUnits]) – Specifies the units to use to return resistance measurements.

  • resistance_config (Optional[nidaqmx.constants.ResistanceConfiguration]) – Specifies the number of wires to use for resistive measurements.

  • current_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • current_excit_val (Optional[float]) – Specifies in amperes the amount of excitation to supply to the sensor. Refer to the sensor documentation to determine this value.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_rosette_strain_gage_chan(physical_channel, rosette_type, gage_orientation, rosette_meas_types, name_to_assign_to_channel='', min_val=- 0.001, max_val=0.001, strain_config=StrainGageBridgeType.QUARTER_BRIDGE_I, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, gage_factor=2.0, nominal_gage_resistance=350.0, poisson_ratio=0.3, lead_wire_resistance=0.0)[source]

Creates channels to measure two-dimensional strain using a rosette strain gage.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create the strain gage virtual channels necessary to calculate the rosette measurements channels.

  • rosette_type (nidaqmx.constants.StrainGageRosetteType) – Specifies information about the rosette configuration and measurements.

  • gage_orientation (float) – Specifies information about the rosette configuration and measurements.

  • rosette_meas_types (List[int]) – Specifies information about the rosette configuration and measurements.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx creates a default channel name.

  • min_val (Optional[float]) – Specifies the minimum strain you expect to measure. This value applies to each strain gage in the rosette.

  • max_val (Optional[float]) – Specifies the maximum strain you expect to measure. This value applies to each strain gage in the rosette.

  • strain_config (Optional[nidaqmx.constants.StrainGageBridgeType]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_val (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • gage_factor (Optional[float]) – Contains information about the strain gage and measurement.

  • nominal_gage_resistance (Optional[float]) – Contains information about the strain gage and measurement.

  • poisson_ratio (Optional[float]) – Contains information about the strain gage and measurement.

  • lead_wire_resistance (Optional[float]) – Specifies information about the bridge configuration and measurement.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_rtd_chan(physical_channel, name_to_assign_to_channel='', min_val=0.0, max_val=100.0, units=TemperatureUnits.DEG_C, rtd_type=RTDType.PT_3750, resistance_config=ResistanceConfiguration.TWO_WIRE, current_excit_source=ExcitationSource.EXTERNAL, current_excit_val=0.0025, r_0=100.0)[source]

Creates channel(s) that use an RTD to measure temperature.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TemperatureUnits]) – Specifies the units to use to return temperature measurements.

  • rtd_type (Optional[nidaqmx.constants.RTDType]) – Specifies the type of RTD connected to the channel.

  • resistance_config (Optional[nidaqmx.constants.ResistanceConfiguration]) – Specifies the number of wires to use for resistive measurements.

  • current_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • current_excit_val (Optional[float]) – Specifies in amperes the amount of excitation to supply to the sensor. Refer to the sensor documentation to determine this value.

  • r_0 (Optional[float]) – Is the sensor resistance in ohms at 0 degrees Celsius. The Callendar-Van Dusen equation requires this value. Refer to the sensor documentation to determine this value.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_strain_gage_chan(physical_channel, name_to_assign_to_channel='', min_val=- 0.001, max_val=0.001, units=StrainUnits.STRAIN, strain_config=StrainGageBridgeType.FULL_BRIDGE_I, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, gage_factor=2.0, initial_bridge_voltage=0.0, nominal_gage_resistance=350.0, poisson_ratio=0.3, lead_wire_resistance=0.0, custom_scale_name='')[source]

Creates channel(s) to measure strain.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.StrainUnits]) – Specifies the units to use to return strain measurements.

  • strain_config (Optional[nidaqmx.constants.StrainGageBridgeType]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_val (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • gage_factor (Optional[float]) – Contains information about the strain gage and measurement.

  • initial_bridge_voltage (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • nominal_gage_resistance (Optional[float]) – Contains information about the strain gage and measurement.

  • poisson_ratio (Optional[float]) – Contains information about the strain gage and measurement.

  • lead_wire_resistance (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_temp_built_in_sensor_chan(physical_channel, name_to_assign_to_channel='', units=TemperatureUnits.DEG_C)[source]

Creates channel(s) that use the built-in sensor of a terminal block or device to measure temperature. On SCXI modules, for example, the built-in sensor could be the CJC sensor.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • units (Optional[nidaqmx.constants.TemperatureUnits]) – Specifies the units to use to return temperature measurements.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_thrmcpl_chan(physical_channel, name_to_assign_to_channel='', min_val=0.0, max_val=100.0, units=TemperatureUnits.DEG_C, thermocouple_type=ThermocoupleType.J, cjc_source=CJCSource.CONSTANT_USER_VALUE, cjc_val=25.0, cjc_channel='')[source]

Creates channel(s) that use a thermocouple to measure temperature.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TemperatureUnits]) – Specifies the units to use to return temperature measurements.

  • thermocouple_type (Optional[nidaqmx.constants.ThermocoupleType]) – Specifies the type of thermocouple connected to the channel. Thermocouple types differ in composition and measurement range.

  • cjc_source (Optional[nidaqmx.constants.CJCSource]) – Specifies the source of cold-junction compensation.

  • cjc_val (Optional[float]) – Specifies in units the temperature of the cold junction if you set cjc_source to CONSTANT_VALUE.

  • cjc_channel (Optional[str]) – Specifies the channel that acquires the temperature of the thermocouple cold- junction if you set cjc_source to CHANNEL.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_thrmstr_chan_iex(physical_channel, name_to_assign_to_channel='', min_val=0.0, max_val=100.0, units=TemperatureUnits.DEG_C, resistance_config=ResistanceConfiguration.FOUR_WIRE, current_excit_source=ExcitationSource.EXTERNAL, current_excit_val=0.00015, a=0.001295361, b=0.0002343159, c=1.018703e-07)[source]

Creates channel(s) that use a thermistor to measure temperature. Use this instance when the thermistor requires current excitation.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TemperatureUnits]) – Specifies the units to use to return temperature measurements.

  • resistance_config (Optional[nidaqmx.constants.ResistanceConfiguration]) – Specifies the number of wires to use for resistive measurements.

  • current_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • current_excit_val (Optional[float]) – Specifies in amperes the amount of excitation to supply to the sensor. Refer to the sensor documentation to determine this value.

  • a (Optional[float]) – Contains the constants for the Steinhart-Hart thermistor equation. Refer to the sensor documentation to determine values for these constants.

  • b (Optional[float]) – Contains the constants for the Steinhart-Hart thermistor equation. Refer to the sensor documentation to determine values for these constants.

  • c (Optional[float]) – Contains the constants for the Steinhart-Hart thermistor equation. Refer to the sensor documentation to determine values for these constants.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_thrmstr_chan_vex(physical_channel, name_to_assign_to_channel='', min_val=0.0, max_val=100.0, units=TemperatureUnits.DEG_C, resistance_config=ResistanceConfiguration.FOUR_WIRE, voltage_excit_source=ExcitationSource.EXTERNAL, voltage_excit_val=2.5, a=0.001295361, b=0.0002343159, c=1.018703e-07, r_1=5000.0)[source]

Creates channel(s) that use a thermistor to measure temperature. Use this instance when the thermistor requires voltage excitation.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TemperatureUnits]) – Specifies the units to use to return temperature measurements.

  • resistance_config (Optional[nidaqmx.constants.ResistanceConfiguration]) – Specifies the number of wires to use for resistive measurements.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • voltage_excit_val (Optional[float]) – Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values.

  • a (Optional[float]) – Contains the constants for the Steinhart-Hart thermistor equation. Refer to the sensor documentation to determine values for these constants.

  • b (Optional[float]) – Contains the constants for the Steinhart-Hart thermistor equation. Refer to the sensor documentation to determine values for these constants.

  • c (Optional[float]) – Contains the constants for the Steinhart-Hart thermistor equation. Refer to the sensor documentation to determine values for these constants.

  • r_1 (Optional[float]) – Specifies in ohms the value of the reference resistor.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_torque_bridge_polynomial_chan(physical_channel, name_to_assign_to_channel='', min_val=- 100.0, max_val=100.0, units=TorqueUnits.INCH_POUNDS, bridge_config=BridgeConfiguration.FULL_BRIDGE, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, nominal_bridge_resistance=350.0, forward_coeffs=None, reverse_coeffs=None, electrical_units=BridgeElectricalUnits.MILLIVOLTS_PER_VOLT, physical_units=BridgePhysicalUnits.INCH_POUNDS, custom_scale_name='')[source]

Creates channel(s) that use a Wheatstone bridge to measure torque. Use this instance with sensors whose specifications provide a polynomial to convert electrical values to physical values. When you use this scaling type, NI-DAQmx requires coefficients for a polynomial that converts electrical values to physical values (forward), as well as coefficients for a polynomial that converts physical values to electrical values (reverse). If you only know one set of coefficients, use the DAQmx Compute Reverse Polynomial Coefficients function to generate the other set.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TorqueUnits]) – Specifies in which unit to return torque measurements from the channel.

  • bridge_config (Optional[nidaqmx.constants.BridgeConfiguration]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_val (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • nominal_bridge_resistance (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • forward_coeffs (Optional[List[float]]) – Specifies how to scale electrical values from the sensor to physical units.

  • reverse_coeffs (Optional[List[float]]) – Specifies how to scale electrical values from the sensor to physical units.

  • electrical_units (Optional[nidaqmx.constants.BridgeElectricalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • physical_units (Optional[nidaqmx.constants.BridgePhysicalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_torque_bridge_table_chan(physical_channel, name_to_assign_to_channel='', min_val=- 100.0, max_val=100.0, units=TorqueUnits.INCH_POUNDS, bridge_config=BridgeConfiguration.FULL_BRIDGE, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, nominal_bridge_resistance=350.0, electrical_vals=None, electrical_units=BridgeElectricalUnits.MILLIVOLTS_PER_VOLT, physical_vals=None, physical_units=BridgePhysicalUnits.INCH_POUNDS, custom_scale_name='')[source]

Creates channel(s) that use a Wheatstone bridge to measure torque. Use this instance with sensors whose specifications provide a table of electrical values and the corresponding physical values. When you use this scaling type, NI-DAQmx performs linear scaling between each pair of electrical and physical values. The input limits specified with min_val and max_val must fall within the smallest and largest physical values. For any data outside those endpoints, NI-DAQmx coerces that data to the endpoints.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TorqueUnits]) – Specifies in which unit to return torque measurements from the channel.

  • bridge_config (Optional[nidaqmx.constants.BridgeConfiguration]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_val (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • nominal_bridge_resistance (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • electrical_vals (Optional[List[float]]) – Specifies how to scale electrical values from the sensor to physical units.

  • electrical_units (Optional[nidaqmx.constants.BridgeElectricalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • physical_vals (Optional[List[float]]) – Specifies how to scale electrical values from the sensor to physical units.

  • physical_units (Optional[nidaqmx.constants.BridgePhysicalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_torque_bridge_two_point_lin_chan(physical_channel, name_to_assign_to_channel='', min_val=- 100.0, max_val=100.0, units=TorqueUnits.INCH_POUNDS, bridge_config=BridgeConfiguration.FULL_BRIDGE, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, nominal_bridge_resistance=350.0, first_electrical_val=0.0, second_electrical_val=2.0, electrical_units=BridgeElectricalUnits.MILLIVOLTS_PER_VOLT, first_physical_val=0.0, second_physical_val=100.0, physical_units=BridgePhysicalUnits.INCH_POUNDS, custom_scale_name='')[source]

Creates channel(s) that use a Wheatstone bridge to measure torque. Use this instance with sensors whose specifications do not provide a polynomial for scaling or a table of electrical and physical values. When you use this scaling type, NI-DAQmx uses two points of electrical and physical values to calculate the slope and y-intercept of a linear equation and uses that equation to scale electrical values to physical values.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TorqueUnits]) – Specifies in which unit to return torque measurements from the channel.

  • bridge_config (Optional[nidaqmx.constants.BridgeConfiguration]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_val (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • nominal_bridge_resistance (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • first_electrical_val (Optional[float]) – Specifies how to scale electrical values from the sensor to physical units.

  • second_electrical_val (Optional[float]) – Specifies how to scale electrical values from the sensor to physical units.

  • electrical_units (Optional[nidaqmx.constants.BridgeElectricalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • first_physical_val (Optional[float]) – Specifies how to scale electrical values from the sensor to physical units.

  • second_physical_val (Optional[float]) – Specifies how to scale electrical values from the sensor to physical units.

  • physical_units (Optional[nidaqmx.constants.BridgePhysicalUnits]) – Specifies how to scale electrical values from the sensor to physical units.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_velocity_iepe_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 50.0, max_val=50.0, units=VelocityUnits.INCHES_PER_SECOND, sensitivity=100.0, sensitivity_units=VelocityIEPESensorSensitivityUnits.MILLIVOLTS_PER_INCH_PER_SECOND, current_excit_source=ExcitationSource.INTERNAL, current_excit_val=0.002, custom_scale_name='')[source]

Creates channel(s) that use an IEPE velocity sensor to measure velocity.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.VelocityUnits]) – Specifies in which unit to return velocity measurements from the channel.

  • sensitivity (Optional[float]) – Is the sensitivity of the sensor. This value is in the units you specify with the sensitivity_units input. Refer to the sensor documentation to determine this value.

  • sensitivity_units (Optional[nidaqmx.constants.VelocityIEPESensorSensitivityUnits]) – Specifies the units of the sensitivity input.

  • current_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • current_excit_val (Optional[float]) – Specifies in amperes the amount of excitation to supply to the sensor. Refer to the sensor documentation to determine this value.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_voltage_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 5.0, max_val=5.0, units=VoltageUnits.VOLTS, custom_scale_name='')[source]

Creates channel(s) to measure voltage. If the measurement requires the use of internal excitation or you need excitation to scale the voltage, use the AI Custom Voltage with Excitation instance of this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.VoltageUnits]) – Specifies the units to use to return voltage measurements.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_voltage_chan_with_excit(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 10.0, max_val=10.0, units=VoltageUnits.VOLTS, bridge_config=BridgeConfiguration.NO_BRIDGE, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=0.0, use_excit_for_scaling=False, custom_scale_name='')[source]

Creates channel(s) to measure voltage. Use this instance for custom sensors that require excitation. You can use the excitation to scale the measurement.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.VoltageUnits]) – Specifies the units to use to return voltage measurements.

  • bridge_config (Optional[nidaqmx.constants.BridgeConfiguration]) – Specifies what type of Wheatstone bridge the sensor is.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • voltage_excit_val (Optional[float]) – Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values.

  • use_excit_for_scaling (Optional[bool]) – Specifies if NI- DAQmx divides the measurement by the excitation. You should typically set use_excit_for_scaling to True for ratiometric transducers. If you set use_excit_for_scaling to True, set max_val and min_val to reflect the scaling.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_ai_voltage_rms_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 5.0, max_val=5.0, units=VoltageUnits.VOLTS, custom_scale_name='')[source]

Creates channel(s) to measure voltage RMS, the average (mean) power of the acquired voltage.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.VoltageUnits]) – Specifies the units to use to return voltage measurements.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_accel_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 5.0, max_val=5.0, units=AccelUnits.G, current_excit_source=ExcitationSource.INTERNAL, current_excit_val=0.004, custom_scale_name='')[source]

Creates channel(s) that use an accelerometer to measure acceleration. You must configure the physical channel(s) with TEDS information to use this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.AccelUnits]) – Specifies the units to use to return acceleration measurements from the channel.

  • current_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • current_excit_val (Optional[float]) – Specifies in amperes the amount of excitation to supply to the sensor. Refer to the sensor documentation to determine this value.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_bridge_chan(physical_channel, name_to_assign_to_channel='', min_val=- 0.002, max_val=0.002, units=TEDSUnits.FROM_TEDS, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, custom_scale_name='')[source]

Creates channel(s) that measure a Wheatstone bridge. You must configure the physical channel(s) with TEDS information to use this function. Use this instance with bridge-based sensors that measure phenomena other than strain, force, pressure, or torque, or that scale data to physical units NI-DAQmx does not support.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TEDSUnits]) – Specifies in which unit to return measurements from the channel.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • voltage_excit_val (Optional[float]) – Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_current_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 0.01, max_val=0.01, units=TEDSUnits.FROM_TEDS, shunt_resistor_loc=CurrentShuntResistorLocation.LET_DRIVER_CHOOSE, ext_shunt_resistor_val=249.0, custom_scale_name='')[source]

Creates channel(s) to measure current. You must configure the physical channel(s) with TEDS information to use this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TEDSUnits]) – Specifies the units to use to return measurements.

  • shunt_resistor_loc (Optional[nidaqmx.constants.CurrentShuntResistorLocation]) – Specifies the location of the shunt resistor. For devices with built-in shunt resistors, specify the location as INTERNAL. For devices that do not have built-in shunt resistors, you must attach an external one, set this input to EXTERNAL and use the ext_shunt_resistor_val input to specify the value of the resistor.

  • ext_shunt_resistor_val (Optional[float]) – Specifies in ohms the resistance of an external shunt resistor.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_force_bridge_chan(physical_channel, name_to_assign_to_channel='', min_val=- 100.0, max_val=100.0, units=ForceUnits.POUNDS, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, custom_scale_name='')[source]

Creates channel(s) that use a Wheatstone bridge to measure force or load. You must configure the physical channel(s) with TEDS information to use this function. NI-DAQmx scales electrical values to physical values according to that TEDS information.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.ForceUnits]) – Specifies in which unit to return force measurements from the channel.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • voltage_excit_val (Optional[float]) – Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_force_iepe_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 2000.0, max_val=2000.0, units=ForceUnits.NEWTONS, current_excit_source=ExcitationSource.INTERNAL, current_excit_val=0.001, custom_scale_name='')[source]

Creates channel(s) that use an IEPE force sensor to measure force or load. You must configure the physical channel(s) with TEDS information to use this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.ForceUnits]) – Specifies in which unit to return force measurements from the channel.

  • current_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • current_excit_val (Optional[float]) – Specifies in amperes the amount of excitation to supply to the sensor. Refer to the sensor documentation to determine this value.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_microphone_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, units=SoundPressureUnits.PA, max_snd_press_level=100.0, current_excit_source=ExcitationSource.INTERNAL, current_excit_val=0.004, custom_scale_name='')[source]

Creates channel(s) that use a microphone to measure sound pressure. You must configure the physical channel(s) with TEDS information to use this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. You must use physical channels that you configured with TEDS information. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • units (Optional[nidaqmx.constants.SoundPressureUnits]) – Specifies the units to use to return sound pressure measurements.

  • max_snd_press_level (Optional[float]) – Is the maximum instantaneous sound pressure level you expect to measure. This value is in decibels, referenced to 20 micropascals.

  • current_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • current_excit_val (Optional[float]) – Specifies in amperes the amount of excitation to supply to the sensor. Refer to the sensor documentation to determine this value.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_pos_lvdt_chan(physical_channel, name_to_assign_to_channel='', min_val=- 0.1, max_val=0.1, units=LengthUnits.METERS, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=1.0, voltage_excit_freq=2500.0, ac_excit_wire_mode=ACExcitWireMode.FOUR_WIRE, custom_scale_name='')[source]

Creates channel(s) that use an LVDT to measure linear position. You must configure the physical channel(s) with TEDS information to use this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.LengthUnits]) – Specifies the units to use to return linear position measurements from the channel.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • voltage_excit_val (Optional[float]) – Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values.

  • voltage_excit_freq (Optional[float]) – Specifies in hertz the excitation frequency that the sensor requires. Refer to the sensor documentation to determine this value.

  • ac_excit_wire_mode (Optional[nidaqmx.constants.ACExcitWireMode]) – Is the number of leads on the sensor. Some sensors require you to tie leads together to create a four- or five- wire sensor. Refer to the sensor documentation for more information.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_pos_rvdt_chan(physical_channel, name_to_assign_to_channel='', min_val=- 70.0, max_val=70.0, units=AngleUnits.DEGREES, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=1.0, voltage_excit_freq=2500.0, ac_excit_wire_mode=ACExcitWireMode.FOUR_WIRE, custom_scale_name='')[source]

Creates channel(s) that use an RVDT to measure angular position. You must configure the physical channel(s) with TEDS information to use this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.AngleUnits]) – Specifies the units to use to return angular position measurements from the channel.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • voltage_excit_val (Optional[float]) – Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values.

  • voltage_excit_freq (Optional[float]) – Specifies in hertz the excitation frequency that the sensor requires. Refer to the sensor documentation to determine this value.

  • ac_excit_wire_mode (Optional[nidaqmx.constants.ACExcitWireMode]) – Is the number of leads on the sensor. Some sensors require you to tie leads together to create a four- or five- wire sensor. Refer to the sensor documentation for more information.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_pressure_bridge_chan(physical_channel, name_to_assign_to_channel='', min_val=- 100.0, max_val=100.0, units=PressureUnits.POUNDS_PER_SQ_INCH, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, custom_scale_name='')[source]

Creates channel(s) that use a Wheatstone bridge to measure pressure. You must configure the physical channel(s) with TEDS information to use this function. NI-DAQmx scales electrical values to physical values according to that TEDS information.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.PressureUnits]) – Specifies in which unit to return pressure measurements from the channel.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • voltage_excit_val (Optional[float]) – Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_resistance_chan(physical_channel, name_to_assign_to_channel='', min_val=100.0, max_val=1000.0, units=TEDSUnits.FROM_TEDS, resistance_config=ResistanceConfiguration.TWO_WIRE, current_excit_source=ExcitationSource.EXTERNAL, current_excit_val=0.001, custom_scale_name='')[source]

Creates channel(s) to measure resistance. You must configure the physical channel(s) with TEDS information to use this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TEDSUnits]) – Specifies the units to use to return measurements.

  • resistance_config (Optional[nidaqmx.constants.ResistanceConfiguration]) – Specifies the number of wires to use for resistive measurements.

  • current_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • current_excit_val (Optional[float]) – Specifies in amperes the amount of excitation to supply to the sensor. Refer to the sensor documentation to determine this value.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_rtd_chan(physical_channel, name_to_assign_to_channel='', min_val=0.0, max_val=100.0, units=TemperatureUnits.DEG_C, resistance_config=ResistanceConfiguration.TWO_WIRE, current_excit_source=ExcitationSource.EXTERNAL, current_excit_val=0.0025)[source]

Creates channel(s) that use an RTD to measure temperature. You must configure the physical channel(s) with TEDS information to use this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TemperatureUnits]) – Specifies the units to use to return temperature measurements.

  • resistance_config (Optional[nidaqmx.constants.ResistanceConfiguration]) – Specifies the number of wires to use for resistive measurements.

  • current_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • current_excit_val (Optional[float]) – Specifies in amperes the amount of excitation to supply to the sensor. Refer to the sensor documentation to determine this value.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_strain_gage_chan(physical_channel, name_to_assign_to_channel='', min_val=- 0.001, max_val=0.001, units=StrainUnits.STRAIN, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, initial_bridge_voltage=0.0, lead_wire_resistance=0.0, custom_scale_name='')[source]

Creates channel(s) to measure strain. You must configure the physical channel(s) with TEDS information to use this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.StrainUnits]) – Specifies the units to use to return strain measurements.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies information about the bridge configuration and measurement.

  • voltage_excit_val (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • initial_bridge_voltage (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • lead_wire_resistance (Optional[float]) – Specifies information about the bridge configuration and measurement.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_thrmcpl_chan(physical_channel, name_to_assign_to_channel='', min_val=0.0, max_val=100.0, units=TemperatureUnits.DEG_C, cjc_source=CJCSource.CONSTANT_USER_VALUE, cjc_val=25.0, cjc_channel='')[source]

Creates channel(s) that use a thermocouple to measure temperature. You must configure the physical channel(s) with TEDS information to use this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TemperatureUnits]) – Specifies the units to use to return temperature measurements.

  • cjc_source (Optional[nidaqmx.constants.CJCSource]) – Specifies the source of cold-junction compensation.

  • cjc_val (Optional[float]) – Specifies in units the temperature of the cold junction if you set cjc_source to CONSTANT_VALUE.

  • cjc_channel (Optional[str]) – Specifies the channel that acquires the temperature of the thermocouple cold- junction if you set cjc_source to CHANNEL.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_thrmstr_chan_iex(physical_channel, name_to_assign_to_channel='', min_val=0.0, max_val=100.0, units=TemperatureUnits.DEG_C, resistance_config=ResistanceConfiguration.FOUR_WIRE, current_excit_source=ExcitationSource.EXTERNAL, current_excit_val=0.00015)[source]

Creates channel(s) that use a thermistor to measure temperature. Use this instance when the thermistor requires current excitation. You must configure the physical channel(s) with TEDS information to use this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TemperatureUnits]) – Specifies the units to use to return temperature measurements.

  • resistance_config (Optional[nidaqmx.constants.ResistanceConfiguration]) – Specifies the number of wires to use for resistive measurements.

  • current_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • current_excit_val (Optional[float]) – Specifies in amperes the amount of excitation to supply to the sensor. Refer to the sensor documentation to determine this value.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_thrmstr_chan_vex(physical_channel, name_to_assign_to_channel='', min_val=0.0, max_val=100.0, units=TemperatureUnits.DEG_C, resistance_config=ResistanceConfiguration.FOUR_WIRE, voltage_excit_source=ExcitationSource.EXTERNAL, voltage_excit_val=2.5, r_1=5000.0)[source]

Creates channel(s) that use a thermistor to measure temperature. Use this instance when the thermistor requires voltage excitation. You must configure the physical channel(s) with TEDS information to use this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TemperatureUnits]) – Specifies the units to use to return temperature measurements.

  • resistance_config (Optional[nidaqmx.constants.ResistanceConfiguration]) – Specifies the number of wires to use for resistive measurements.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • voltage_excit_val (Optional[float]) – Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values.

  • r_1 (Optional[float]) – Specifies in ohms the value of the reference resistor.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_torque_bridge_chan(physical_channel, name_to_assign_to_channel='', min_val=- 100.0, max_val=100.0, units=TorqueUnits.INCH_POUNDS, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=2.5, custom_scale_name='')[source]

Creates channel(s) that use a Wheatstone bridge to measure torque. You must configure the physical channel(s) with TEDS information to use this function. NI-DAQmx scales electrical values to physical values according to that TEDS information.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TorqueUnits]) – Specifies in which unit to return torque measurements from the channel.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • voltage_excit_val (Optional[float]) – Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_voltage_chan(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 5.0, max_val=5.0, units=TEDSUnits.FROM_TEDS, custom_scale_name='')[source]

Creates channel(s) to measure voltage. You must configure the physical channel(s) with TEDS information to use this function. If the measurement requires the use of internal excitation or you need excitation to scale the voltage, use the TEDS AI Custom Voltage with Excitation instance of this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TEDSUnits]) – Specifies the units to use to return measurements.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

add_teds_ai_voltage_chan_with_excit(physical_channel, name_to_assign_to_channel='', terminal_config=TerminalConfiguration.DEFAULT, min_val=- 10.0, max_val=10.0, units=TEDSUnits.FROM_TEDS, voltage_excit_source=ExcitationSource.INTERNAL, voltage_excit_val=0.0, custom_scale_name='')[source]

Creates channel(s) to measure voltage. Use this instance for custom sensors that require excitation. You can use the excitation to scale the measurement. You must configure the physical channel(s) with TEDS information to use this function.

Parameters
  • physical_channel (str) – Specifies the names of the physical channels to use to create virtual channels. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system.

  • name_to_assign_to_channel (Optional[str]) – Specifies a name to assign to the virtual channel this function creates. If you do not specify a value for this input, NI-DAQmx uses the physical channel name as the virtual channel name.

  • terminal_config (Optional[nidaqmx.constants.TerminalConfiguration]) – Specifies the input terminal configuration for the channel.

  • min_val (Optional[float]) – Specifies in units the minimum value you expect to measure.

  • max_val (Optional[float]) – Specifies in units the maximum value you expect to measure.

  • units (Optional[nidaqmx.constants.TEDSUnits]) – Specifies the units to use to return measurements.

  • voltage_excit_source (Optional[nidaqmx.constants.ExcitationSource]) – Specifies the source of excitation.

  • voltage_excit_val (Optional[float]) – Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values.

  • custom_scale_name (Optional[str]) – Specifies the name of a custom scale for the channel. If you want the channel to use a custom scale, specify the name of the custom scale to this input and set units to FROM_CUSTOM_SCALE.

Returns

Indicates the newly created channel object.

Return type

nidaqmx._task_modules.channels.ai_channel.AIChannel

property all

nidaqmx._task_modules.channels.channel.Channel: Specifies a channel object that represents the entire list of virtual channels on this channel collection.

property channel_names

Specifies the entire list of virtual channels on this channel collection.

Type

List[str]

count(value) integer -- return number of occurrences of value
index(value[, start[, stop]]) integer -- return first index of value.

Raises ValueError if the value is not present.

Supporting start and stop arguments is optional, but recommended.