niDCPower_PerformLCRShortCompensation
- Updated2023-04-15
- 2 minute(s) read
niDCPower_PerformLCRShortCompensation( ViSession vi, ViConstString channelName, ViInt32 numFrequencies, const ViReal64 additionalFrequencies[]);
Purpose
Generates short compensation data for LCR measurements based on a default set of test frequencies and, optionally, additional frequencies you can specify.
You must physically configure your LCR circuit with a short to use this function to generate valid short compensation data.
 |
Note When you call this function:
|
To apply the short compensation data you generate with this function to your LCR measurements, set NIDCPOWER_ATTR_LCR_SHORT_COMPENSATION_ENABLED to VI_TRUE.
Corrections for frequencies other than the default frequencies or any additional frequencies you specify are interpolated.
|
Note This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices. |
Default Short Compensation Frequencies
By default, NI-DCPower uses the following frequencies for LCR short compensation:
- 10 logarithmic steps at 1 kHz frequency decade
- 10 logarithmic steps at 10 kHz frequency decade
- 100 logarithmic steps at 100 kHz frequency decade
- 100 logarithmic steps at 1 MHz frequency decade
|
Note The actual frequencies used depend on the bandwidth of your instrument. |
Parameters
| Input | ||
| Name | Type | Description |
| vi | ViSession | Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function. |
| channelName | 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. |
| numFrequencies | ViInt32 | Specifies the number of elements in additionalFrequencies. |
| additionalFrequencies | ViReal64[] | Defines a further set of frequencies, in addition to the default frequencies, to perform the compensation for. You can specify <=200 additional frequencies. |
Return Value
| Name | Type | Description |
| Status | ViStatus | Reports the status of this operation. To obtain a text description of the status code, call the niDCPower_error_message function. To obtain additional information concerning the error condition, call the niDCPower_GetError function. |