Fetches PVT ON and OFF powers along with measurement status and burst width.
Use "carrier(k)" or "subblock(n)/carrier(k)" as the selector string to read from this method.

Syntax

Namespace: NationalInstruments.RFmx.NRMX

public int FetchMeasurement(string selectorString, double timeout, out RFmxNRMXPvtMeasurementStatus measurementStatus, out double absoluteOffPowerBefore, out double absoluteOffPowerAfter, out double absoluteONPower, out double burstWidth)

Parameters

NameTypeDescription
selectorStringstring

Specifies a selector string comprising of the result name, subblock number, and carrier number. If you do not specify the result name, the default result instance is used. Example:
"subblock0/carrier0"
"result::r1/subblock0/carrier0"
You can use the BuildCarrierString(string, int) method to build the selector string.

timeoutdouble

Specifies the timeout for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete.

measurementStatusout RFmxNRMXPvtMeasurementStatus

Upon return, contains the measurement status indicating whether the off power before and after is within the standard defined limit.

absoluteOffPowerBeforeout double

Upon return, contains the OFF power in the segment before the captured burst. The segment is defined as one slot prior to a short transient segment and the burst. This value is expressed in dBm.

absoluteOffPowerAfterout double

Upon return, contains the OFF power in the segment after the captured burst. The segment is defined as one slot after the burst and a short transient segment. This value is expressed in dBm.

absoluteONPowerout double

Upon return, contains the power of the subframes within the captured burst. This value is expressed in dBm.

burstWidthout double

Upon return, contains the width of the captured burst. This value is expressed in seconds.

Returns

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