Calibrates the current measurements returned by the niDCPower_Measure function for the specified channel. This function calculates new calibration coefficients for the specified current measurement range based on the reportedOutputs and measuredOutputs. Refer to the calibration procedure for the device you are calibrating for detailed instructions about the appropriate use of this function. This function can only be called in an external calibration session.

Syntax

ViStatus _VI_FUNC niDCPower_CalAdjustCurrentMeasurement(ViSession vi, ViConstString channelName, ViReal64 range, ViUInt32 numberOfMeasurements, const ViReal64 reportedOutputs[], const ViReal64 measuredOutputs[])

Remarks

Note

NI-DCPower uses the terms "source" and "output". However, while sinking with electronic loads and SMUs these correspond to "sinking" and "input", respectively.

Parameters

NameDirectionTypeDescription
vi[in]ViSession

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

channelName[in]ViConstString

Specifies the channel name to which these calibration settings apply.

range[in]ViReal64

Specifies the range to calibrate with these settings. Only one channel at a time may be calibrated.

numberOfMeasurements[in]ViUInt32

Specifies the number of elements in reportedOutputs and measuredOutputs.

reportedOutputs[in]const ViReal64[]

Specifies an array of the output values that were returned by the niDCPower_Measure function.

measuredOutputs[in]const ViReal64[]

Specifies an array of the output values measured by an external precision digital multimeter.

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