NI-DAQmx .NET Framework 4.5 API Reference

Content Type
Programming Language
Current manual
Table of Contents
Product DocumentationNI-DAQmx .NET Framework 4.5 API Reference...CreateForceBridgeTableChannel Method AIChannelCollection.CreateForceBridgeTableChannel Method (String, String, Double, Double, AIForceUnits, AIBridgeConfiguration, AIExcitationSource, Double, Double, Double[], AIBridgeElectricalUnits, Double[], AIBridgePhysicalUnits)Current page
Table of Contents

AIChannelCollection.CreateForceBridgeTableChannel Method (String, String, Double, Double, AIForceUnits, AIBridgeConfiguration, AIExcitationSource, Double, Double, Double[], AIBridgeElectricalUnits, Double[], AIBridgePhysicalUnits)

AIChannelCollection.CreateForceBridgeTableChannel Method (String, String, Double, Double, AIForceUnits, AIBridgeConfiguration, AIExcitationSource, Double, Double, Double[], AIBridgeElectricalUnits, Double[], AIBridgePhysicalUnits)

AIChannelCollectionCreateForceBridgeTableChannel Method (String, String, Double, Double, AIForceUnits, AIBridgeConfiguration, AIExcitationSource, Double, Double, Double, AIBridgeElectricalUnits, Double, AIBridgePhysicalUnits)

Creates an AIChannel that uses 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 the minimum value and maximum value parameters must fall within the smallest and largest physical values. For any data outside those endpoints, NI-DAQmx coerces that data to the endpoints. This method adds one or more physical channels to the AIChannelCollection.

Namespace:  NationalInstruments.DAQmx
Assembly:  NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.45.49302

Syntax

public AIChannel CreateForceBridgeTableChannel(
	string physicalChannelName,
	string nameToAssignChannel,
	double minimumValue,
	double maximumValue,
	AIForceUnits units,
	AIBridgeConfiguration bridgeConfiguration,
	AIExcitationSource voltageExcitationSource,
	double voltageExcitationValue,
	double nominalBridgeResistance,
	double[] electricalValues,
	AIBridgeElectricalUnits electricalUnits,
	double[] physicalValues,
	AIBridgePhysicalUnits physicalUnits
)
Public Function CreateForceBridgeTableChannel ( 
	physicalChannelName As String,
	nameToAssignChannel As String,
	minimumValue As Double,
	maximumValue As Double,
	units As AIForceUnits,
	bridgeConfiguration As AIBridgeConfiguration,
	voltageExcitationSource As AIExcitationSource,
	voltageExcitationValue As Double,
	nominalBridgeResistance As Double,
	electricalValues As Double(),
	electricalUnits As AIBridgeElectricalUnits,
	physicalValues 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 units.
maximumValue
Type: SystemDouble
The maximum value you expect to measure, in units.
units
Type: NationalInstruments.DAQmxAIForceUnits
The units to use to return the measurement.
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.
electricalValues
Type: SystemDouble
The array of electrical values that map to the values in physicalValues. 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.
physicalValues
Type: SystemDouble
The array of physical values that map to the values in electricalValues. 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: AIChannel
The newly created AIChannel.

Exceptions

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

See Also

Was this information helpful?