AIChannelCollection.CreateTedsStrainGageChannel Method (String, String, Double, Double, AIExcitationSource, Double, Double, Double, AIStrainUnits)
- Updated2023-02-21
- 2 minute(s) read
Creates an AIChannel to measure strain. This method adds one or more physical channels to the AIChannelCollection.
Namespace: NationalInstruments.DAQmx
Assembly: NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.40.49302
Syntax
public AIChannel CreateTedsStrainGageChannel( string physicalChannelName, string nameToAssignChannel, double minimumValue, double maximumValue, AIExcitationSource voltageExcitationSource, double voltageExcitationValue, double initialBridgeVoltage, double leadWireResistance, AIStrainUnits units )
Public Function CreateTedsStrainGageChannel ( physicalChannelName As String, nameToAssignChannel As String, minimumValue As Double, maximumValue As Double, voltageExcitationSource As AIExcitationSource, voltageExcitationValue As Double, initialBridgeVoltage As Double, leadWireResistance As Double, units As AIStrainUnits ) As AIChannel
Parameters
- physicalChannelName
- Type: SystemString
The names of one or more physical channels to use to create one or more local virtual channels. - nameToAssignChannel
- Type: SystemString
One or more names to assign to the created local virtual channels. To use the physical channel name as the local virtual channel name, set this value to Empty. - minimumValue
- Type: SystemDouble
The minimum value expected from the measurement, in units. - maximumValue
- Type: SystemDouble
The maximum value expected from the measurement, in units. - voltageExcitationSource
- Type: NationalInstruments.DAQmxAIExcitationSource
The source of excitation. - voltageExcitationValue
- Type: SystemDouble
The amount of excitation in volts that the sensor requires. Refer to the sensor documentation to determine this value. - initialBridgeVoltage
- Type: SystemDouble
The output voltage of the bridge in the unloaded condition. NI-DAQmx subtracts this value from any measurements before applying scaling equations. Perform a voltage measurement on the bridge with no strain applied to determine this value. - leadWireResistance
- Type: SystemDouble
The amount of resistance in ohms in the lead wires. Ideally, this value is the same for all leads. - units
- Type: NationalInstruments.DAQmxAIStrainUnits
The units to use to return the strain measurement.
Return Value
Type: AIChannelThe newly created AIChannel.
Exceptions
| Exception | Condition |
|---|---|
| DaqException | The NI-DAQmx driver returned an error. |
Remarks
You must configure the physical channel(s) with TEDS information to use this method.
The NI-DAQmx driver does not determine if the requested settings are possible until the task is verified. This method does not throw an exception for parameter values that are not compatible with your hardware or other settings in your task. To determine if all of the settings for a Task are valid, you must verify the task by starting the task, either with Start or by reading from or writing to the task, or by calling Control(TaskAction) with Verify.