RFmx LTE DotNET

Table of Contents

RFmxLteMXSemResults.FetchUpperOffsetPowerArray Method

  • Updated2024-07-17
  • 3 minute(s) read
RFmxLteMXSemResults.FetchUpperOffsetPowerArray Method

RFmxLteMXSemResultsFetchUpperOffsetPowerArray Method

Returns an array of total absolute and relative powers, peak, absolute, and relative powers, and frequencies at peak absolute powers of upper offset segments. The relative power is relative to total aggregated power.
Use "subblock(n)" as the selector string to read results from this method.
Refer to the LTE Uplink Spectral Emission Mask and LTE Downlink Spectral Emission Mask topics for more information.

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 FetchUpperOffsetPowerArray(
	string selectorString,
	double timeout,
	ref double[] absoluteIntegratedPower,
	ref double[] relativeIntegratedPower,
	ref double[] absolutePeakPower,
	ref double[] peakFrequency,
	ref double[] relativePeakPower
)
Public Function FetchUpperOffsetPowerArray ( 
	selectorString As String,
	timeout As Double,
	ByRef absoluteIntegratedPower As Double(),
	ByRef relativeIntegratedPower As Double(),
	ByRef absolutePeakPower As Double(),
	ByRef peakFrequency As Double(),
	ByRef relativePeakPower As Double()
) As Integer

Parameters

selectorString
Type: SystemString
Specifies a selector string comprising of the result name, and subblock number. If you do not specify the result name, the default result instance is used. Example:
"subblock0"
"result::r1/subblock0"
You can use the BuildSubblockString(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.
absoluteIntegratedPower
Type: SystemDouble
Upon return, contains the array of upper offset segment powers. For the intra-band non-contiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
relativeIntegratedPower
Type: SystemDouble
Upon return, contains the array of powers in the upper offset segment relative to the value returned by the GetTotalAggregatedPower(String, Double) method. For the intra-band non-contiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
absolutePeakPower
Type: SystemDouble
Upon return, contains the array of peak powers in the upper offset segment. For the intra-band non-contiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
peakFrequency
Type: SystemDouble
Upon return, contains the array of frequency at which the peak power occurs in the upper (positive) offset segment. For the intra-band non-contiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.
relativePeakPower
Type: SystemDouble
Upon return, contains the array of peak power in the upper (positive) offset segment relative to the value returned by the SEM Results Total Aggregated Pwr method. For the intra-band non-contiguous type of carrier aggregation, the offset segment may be truncated or discarded based on offset overlap rules as defined in the 3GPP TS 36.521 specification. If the offset segment is truncated the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.

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