RFmx LTE DotNET

Table of Contents

RFmxLteMXPvtResults.FetchMeasurement Method

  • Updated2024-07-17
  • 2 minute(s) read
RFmxLteMXPvtResults.FetchMeasurement Method

RFmxLteMXPvtResultsFetchMeasurement Method

Returns the measurement.
Use "carrier(k)" or "subblock(n)/carrier(k)" as the selector string to read this result.

Namespace:  NationalInstruments.RFmx.LteMX
Assembly:  NationalInstruments.RFmx.LteMX.Fx40 (in NationalInstruments.RFmx.LteMX.Fx40.dll) Version: 24.5.0.49283 (24.5.0.49283)

Syntax

public int FetchMeasurement(
	string selectorString,
	double timeout,
	out RFmxLteMXPvtMeasurementStatus measurementStatus,
	out double meanAbsoluteOffPowerBefore,
	out double meanAbsoluteOffPowerAfter,
	out double meanAbsoluteOnPower,
	out double burstWidth
)
Public Function FetchMeasurement ( 
	selectorString As String,
	timeout As Double,
	<OutAttribute> ByRef measurementStatus As RFmxLteMXPvtMeasurementStatus,
	<OutAttribute> ByRef meanAbsoluteOffPowerBefore As Double,
	<OutAttribute> ByRef meanAbsoluteOffPowerAfter As Double,
	<OutAttribute> ByRef meanAbsoluteOnPower As Double,
	<OutAttribute> ByRef burstWidth As Double
) As Integer

Parameters

selectorString
Type: SystemString
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, Int32) method to build the selector string.
timeout
Type: SystemDouble
Specifies the timeout for fetching the specified measurement. This value is expressed in seconds. 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.
measurementStatus
Type: NationalInstruments.RFmx.LteMXRFmxLteMXPvtMeasurementStatus
Upon return, contains the measurement status indicating whether the power before and after the burst is within the standard defined limit.
meanAbsoluteOffPowerBefore
Type: SystemDouble
Upon return, contains the mean power in the segment before the captured burst. The segment is defined as one subframe prior to the burst for the FDD mode and 10 SCFDMA symbols prior to the burst for the TDD mode. This value is expressed in dBm.
meanAbsoluteOffPowerAfter
Type: SystemDouble
Upon return, contains the mean power in the segment after the captured burst. This value is expressed in dBm.
The segment is defined as one subframe long excluding a transient period of 20 μs at the beginning. This value is expressed in dBm.
meanAbsoluteOnPower
Type: SystemDouble
Upon return, contains the average power of the subframes within the captured burst, excluding a transient period of 20 μs at the beginning. This value is expressed in dBm.
burstWidth
Type: SystemDouble
Upon return, contains the width of the captured burst.

Return Value

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

See Also

Log in to get a better experience