AIChannelCollection.CreatePressureBridgeTwoPointLinearChannel Method (String, String, Double, Double, String, AIBridgeConfiguration, AIExcitationSource, Double, Double, Double, Double, AIBridgeElectricalUnits, Double, Double, AIBridgePhysicalUnits)
- Updated2023-02-21
- 3 minute(s) read
AIChannelCollectionCreatePressureBridgeTwoPointLinearChannel Method (String, String, Double, Double, String, AIBridgeConfiguration, AIExcitationSource, Double, Double, Double, Double, AIBridgeElectricalUnits, Double, Double, AIBridgePhysicalUnits)
Namespace: NationalInstruments.DAQmx
Assembly: NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.40.49302
Syntax
public AIChannel CreatePressureBridgeTwoPointLinearChannel( string physicalChannelName, string nameToAssignChannel, double minimumValue, double maximumValue, string customScaleName, AIBridgeConfiguration bridgeConfiguration, AIExcitationSource voltageExcitationSource, double voltageExcitationValue, double nominalBridgeResistance, double firstElectricalValue, double secondElectricalValue, AIBridgeElectricalUnits electricalUnits, double firstPhysicalValue, double secondPhysicalValue, AIBridgePhysicalUnits physicalUnits )
Public Function CreatePressureBridgeTwoPointLinearChannel ( physicalChannelName As String, nameToAssignChannel As String, minimumValue As Double, maximumValue As Double, customScaleName As String, bridgeConfiguration As AIBridgeConfiguration, voltageExcitationSource As AIExcitationSource, voltageExcitationValue As Double, nominalBridgeResistance As Double, firstElectricalValue As Double, secondElectricalValue As Double, electricalUnits As AIBridgeElectricalUnits, firstPhysicalValue As Double, secondPhysicalValue As Double, physicalUnits As AIBridgePhysicalUnits ) 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 you expect to measure, in custom scaled units. - maximumValue
- Type: SystemDouble
The maximum value you expect to measure, in custom scaled units. - customScaleName
- Type: SystemString
The name of the custom scale to apply to the local virtual channel. - bridgeConfiguration
- Type: NationalInstruments.DAQmxAIBridgeConfiguration
The type of Wheatstone bridge configuration connected to the channel. - voltageExcitationSource
- Type: NationalInstruments.DAQmxAIExcitationSource
The source of excitation. - voltageExcitationValue
- Type: SystemDouble
The amount of excitation, in volts, that the sensor requires. - nominalBridgeResistance
- Type: SystemDouble
The resistance, in ohms, of the bridge while not under load. - firstElectricalValue
- Type: SystemDouble
The first electrical value, corresponding to firstPhysicalValue. Specify this value in the units specified with electricalUnits. - secondElectricalValue
- Type: SystemDouble
The second electrical value, corresponding to secondPhysicalValue. Specify this value in the units specified with electricalUnits. - electricalUnits
- Type: NationalInstruments.DAQmxAIBridgeElectricalUnits
Specifies from which electrical units to scale data. Use the units that correspond to the units used for electrical values provided by the sensor data sheet or calibration certificate. - firstPhysicalValue
- Type: SystemDouble
The first physical value, corresponding to firstElectricalValue. Specify this value in the units specified with physicalUnits. - secondPhysicalValue
- Type: SystemDouble
The second physical value, corresponding to secondElectricalValue. Specify this value in the units specified with physicalUnits. - physicalUnits
- Type: NationalInstruments.DAQmxAIBridgePhysicalUnits
Specifies to which physical units to scale electrical data.
Return Value
Type: AIChannelThe newly created AIChannel.
Exceptions
| Exception | Condition |
|---|---|
| DaqException | The NI-DAQmx driver returned an error. |
Remarks
Specify different values for physical units if the sensor specifications provide physical values in one unit, but you want NI-DAQmx to scale data to a different unit.
This method creates a local virtual channel for every physical channel name you specify. If you create multiple local virtual channels with one call to this method, you can specify a comma-delimited list of names for nameToAssignChannel. If you provide fewer local virtual channel names in nameToAssignChannel than you create, NI-DAQmx automatically assigns names to the local virtual channels.
If you do not provide a value for nameToAssignChannel, NI-DAQmx uses the physicalChannelName as the local virtual channel name. If you use nameToAssignChannel to create a name for the local virtual channel, you must use this name in other properties and methods.
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.