NI-DAQmx .NET Framework 4.0 API Reference

AIChannelCollection.CreateRosetteStrainGageChannel Method

Download PDF

Updated2023-02-21
4 minute(s) read

Creates an AIChannel to measure two-dimensional strain using a rosette strain gage. 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 CreateRosetteStrainGageChannel(
	string physicalChannelName,
	string nameToAssignChannel,
	double minimumValue,
	double maximumValue,
	AIStrainGageConfiguration strainGageConfiguration,
	double leadWireResistance,
	AIExcitationSource excitationSource,
	double excitationValue,
	double gageFactor,
	double nominalGageResistance,
	double poissonRatio,
	AIRosetteType rosetteType,
	double rosetteStrainGageOrientation,
	AIRosetteMeasurementType[] rosetteMeasurementTypes
)

Public Function CreateRosetteStrainGageChannel ( 
	physicalChannelName As String,
	nameToAssignChannel As String,
	minimumValue As Double,
	maximumValue As Double,
	strainGageConfiguration As AIStrainGageConfiguration,
	leadWireResistance As Double,
	excitationSource As AIExcitationSource,
	excitationValue As Double,
	gageFactor As Double,
	nominalGageResistance As Double,
	poissonRatio As Double,
	rosetteType As AIRosetteType,
	rosetteStrainGageOrientation As Double,
	rosetteMeasurementTypes As AIRosetteMeasurementType()
) As AIChannel

Parameters

physicalChannelName: Type: SystemString
The names of one or more physical channels to use to create one or more virtual strain gage channels.
nameToAssignChannel: Type: SystemString
One or more names to assign to the created local virtual channels.
minimumValue: Type: SystemDouble
The minimum strain you expect to measure. This value applies to each strain gage in the rosette.
maximumValue: Type: SystemDouble
The maximum strain you expect to measure. This value applies to each strain gage in the rosette
strainGageConfiguration: Type: NationalInstruments.DAQmxAIStrainGageConfiguration
The bridge configuration for the strain gages. The possible values for this parameter are listed in AIStrainGageConfiguration.
leadWireResistance: Type: SystemDouble
The amount of resistance in ohms in the lead wires. Ideally, this value is the same for all leads.
excitationSource: Type: NationalInstruments.DAQmxAIExcitationSource
The source of excitation. The possible values for this parameter are listed in AIExcitationSource.
excitationValue: Type: SystemDouble
The amount of excitation in volts supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values.
gageFactor: Type: SystemDouble
The sensitivity of the strain gages and relates the change in electrical resistance to the change in strain. Each gage in the bridge must have the same gage factor. Refer to the sensor documentation to determine this value.
nominalGageResistance: Type: SystemDouble
The resistance in ohms of the gages in an unstrained position. Each gage in the bridge must have the same nominal gage resistance. The resistance across arms of the bridge that do not have strain gages must also be the same as the nominal gage resistance. Refer to the sensor documentation to determine this value.
poissonRatio: Type: SystemDouble
The ratio of lateral strain to axial strain in the material you are measuring.
rosetteType: Type: NationalInstruments.DAQmxAIRosetteType
The type of the rosette. The possible values for this parameter are listed in AIRosetteType.
rosetteStrainGageOrientation: Type: SystemDouble
The orientation, in degrees, of the gage with respect to the preferred X axis.
rosetteMeasurementTypes: Type: NationalInstruments.DAQmxAIRosetteMeasurementType
An array of AIRosetteMeasurementType that specifies the virtual channels to create for the rosette measurements. For each rosette sensor, this method creates one strain virtual channel for each strain gage in the rosette, and one rosette virtual channel for each measurement specified in the rosette measurements array. .

Return Value

Type: AIChannel
The newly created AIChannel.

Exceptions

Exception	Condition
DaqException	The NI-DAQmx driver returned an error.

Remarks

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 use this input to provide your own names for the virtual channels, you must use the names when you refer to these channels in other methods.

physicalChannelName Considerations

For each rosette sensor, this method creates one strain virtual channel for each strain gage in the rosette, and one rosette virtual channel for each measurement specified in the rosette measurements array. For the Tee type, at least 2 physical channels are required. For the Rectangular and Delta types, at least 3 physical channels are required. You are also able to specify a multiple of the required number of physical channels to create the virtual channels necessary for multiple rosette sensors. The order of these channels is critical for proper rosette measurements and should be in the order of the gages in the rosette. The gages in the rosette are typically labeled as A, B, and C or 1, 2, and 3 which is the order required by DAQmx. The DAQmx physical channel constant lists all physical channels on devices and modules installed in the system. You also can wire a string that contains a list or range of physical channels to this input.

nameToAssignChannel Considerations

If you do not define a value for this input, NI-DAQmx creates a default channel name. The format of this name is rosette#_TYPE, where # is an index number incremented to the first unique value, and TYPE is the channel type.

Name Format	Type
rosette#_strainGage1	Strain gage 1.
rosette#_strainGage2	Strain gage 2.
rosette#_strainGage3	Strain gage 3.
rosette#_principalStrain1	Principal strain 1.
rosette#_principalStrain2	Principal strain 2.
rosette#_principalStrainAngle	Principal strain angle.
rosette#_cartesianStrainX	Cartesian strain X.
rosette#_cartesianStrainY	Cartesian strain Y.
rosette#_cartesianShearStrainXY	Cartesian shear strain XY.
rosette#_maximumShearStrain	Maximum shear strain.
rosette#_maximumShearStrainAngle	Minimum shear strain.

NI-DAQmx .NET Framework 4.0 API Reference

Table of Contents

AIChannelCollection.CreateRosetteStrainGageChannel Method

Syntax

Parameters

Return Value

Exceptions

Remarks

See Also

Reference

Log in to get a better experience