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