niDCPower_MeasureMultipleLCR

Download PDF

Updated2025-10-06
2 minute(s) read

Measures and returns an array of LCR data on the specified channel(s).

Syntax

ViStatus _VI_FUNC niDCPower_MeasureMultipleLCR(ViSession vi, ViConstString channelName, NILCRMeasurement measurements[])

Remarks

To use this function:

Set NIDCPOWER_ATTR_INSTRUMENT_MODE to NIDCPOWER_VAL_LCR;
Set NIDCPOWER_ATTR_MEASURE_WHEN to NIDCPOWER_VAL_ON_DEMAND; and
Put the channel(s) in the Running state (call niDCPower_InitiateWithChannels).

Note

This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Parameters

Name

Direction

Type

Description

[in]

ViSession

Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.

channelName

[in]

ViConstString

Specifies the channel(s) to use. Specify the channel(s) using the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3 or PXI1Slot3/0,PXI1Slot3/2:3,PXI1Slot4/2:3, where PXI1Slot3 and PXI1Slot4 are instrument resource names and 0, 2, and 3 are channels.

If you pass "" for this control, all channels in the session are used.

measurements

[out]

NILCRMeasurement[]

Returns an array of LCR measurement data.

NILCRMeasurement:


Name	Type	Description
Vdc	ViReal64	The measured DC voltage, in volts.
Idc	ViReal64	The measured DC current, in amps.
stimulusFrequency	ViReal64	The frequency of the LCR test signal, in Hz.
ACVoltage	NIComplexNumber	The measured AC voltage, in volts RMS.
ACCurrent	NIComplexNumber	The measured AC current, in amps RMS.
Z	NIComplexNumber	The complex impedance.
ZMagnitude	ViReal64	The magnitude of the complex impedance, in ohms.
ZPhase	ViReal64	The impedance phase angle, in degrees.
Y	NIComplexNumber	The complex admittance.
YMagnitude	ViReal64	The magnitude of the complex admittance, in siemens.
YPhase	ViReal64	The admittance phase angle, in degrees.
Ls	ViReal64	The inductance, in henrys, as measured using a series circuit model.
Cs	ViReal64	The capacitance, in farads, as measured using a series circuit model.
Rs	ViReal64	The resistance, in ohms, as measured using a series circuit model.
Lp	ViReal64	The inductance, in henrys, as measured using a parallel circuit model.
Cp	ViReal64	The capacitance, in farads, as measured using a parallel circuit model.
Rp	ViReal64	The resistance, in ohms, as measured using a parallel circuit model.
D	ViReal64	The dissipation factor of the circuit. The dimensionless dissipation factor is directly proportional to how quickly an oscillating system loses energy. D is the reciprocal of Q, the quality factor.
Q	ViReal64	The quality factor of the circuit. The dimensionless quality factor is inversely proportional to the degree of damping in a system. Q is the reciprocal of D, the dissipation factor.
measurementMode	ViUInt16	Returns the measurement mode.
dcInCompliance	ViBoolean	Indicates whether the output was in DC compliance at the time the measurement was taken.
acInCompliance	ViBoolean	Indicates whether the output was in AC compliance at the time the measurement was taken.
unbalanced	ViBoolean	Indicates whether the bridge was unbalanced at the time the measurement was taken.

measurementMode Defined Values:


Name	Value	Description
NIDCPOWER_VAL_SMU_PS	1061 (0x425)	The channel(s) are operating as a power supply/SMU.
NIDCPOWER_VAL_LCR	1062 (0x426)	The channel(s) are operating as an LCR meter.

Returns

Reports the status of this operation. To obtain a text description of the status code, call niDCPower_error_message. To obtain additional information concerning the error condition, call niDCPower_GetError. The general meaning of the status code is as follows:


Value	Meaning
0	Success
Positive Values	Warnings
Negative Values	Errors

NI-DCPower C API Reference Manual

Table of Contents

niDCPower_MeasureMultipleLCR

Syntax

Remarks

Parameters

Returns

Log in to get a better experience