Fetches the mean linear gain, 1 dB compression point, and mean RMS EVM of the device under test.

Syntax

Namespace: NationalInstruments.RFmx.SpecAnMX

public int FetchDutCharacteristics(string selectorString, double timeout, out double meanLinearGain, out double onedBCompressionPoint, out double meanRmsEvm)

Remarks

This method maps to the RFmxSpecAn_AMPMFetchDUTCharacteristics() function in C.

Parameters

NameTypeDescription
selectorStringstring

Specifies the result name. Example: "", "result::r1". You can use the BuildResultString(string) method to build the selectorString.

timeoutdouble

Specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete.

meanLinearGainout double

Upon return, contains the average linear gain, in dB, of the device under test, computed by rejecting signal samples suffering gain compression.

onedBCompressionPointout double

Upon return, contains the theoretical output power, in dBm, at which gain of the device under test drops by 1 dB from a gain reference computed based on the value that you specify for the AmpmCompressionPointGainReference attribute. This parameter returns NaN when the AM-to-AM characteristics of the device under test are flat.

meanRmsEvmout double

Upon return, contains the ratio, as a percentage, of l2 norm of difference between the normalized reference and acquired waveforms, to the l2 norm of the normalized reference waveform.

Returns

Returns the status code of this method. The status code either indicates success or describes an error or warning condition.