Fetches the arrays of upper offset segment power measurements.

Syntax

Namespace: NationalInstruments.RFmx.SpecAnMX

public int FetchUpperOffsetPowerArray(string selectorString, double timeout, ref double[] totalAbsolutePower, ref double[] totalRelativePower, ref double[] peakAbsolutePower, ref double[] peakFrequency, ref double[] peakRelativePower)

Remarks

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

Parameters

NameTypeDescription
selectorStringstring

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

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.

totalAbsolutePowerref double[]

Upon return, contains the array of upper (positive) offset segment powers measured.

totalRelativePowerref double[]

Upon return, contains the array of powers measured in each upper (positive) offset segment relative to the integrated or peak power of the reference carrier.

peakAbsolutePowerref double[]

Upon return, contains the array of peak powers measured in each upper (positive) offset segment. The power is measured in dBm when you set the SetPowerUnits(string, RFmxSpecAnMXSemPowerUnits) method to dBm, and in dBm/Hz when you set the SetPowerUnits(string, RFmxSpecAnMXSemPowerUnits) method to dBmPerHertz.

peakFrequencyref double[]

Upon return, contains the array of frequencies, in hertz (Hz), at which the peak power occurred in each offset segment.

peakRelativePowerref double[]

Upon return, contains the array of peak powers measured in each upper (positive) offset segment relative to the integrated or peak power of the reference carrier.

Returns

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