RFmxLteMXSemResults.FetchUpperOffsetPowerArray Method
- Updated2024-07-17
- 3 minute(s) read
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.
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: Int32Returns the status code of this method. The status code either indicates success or describes a warning condition.