FetchUpperOffsetPower(string, double, out double, out double, out double, out double, out double)
- Updated2025-04-08
- 3 minute(s) read
Returns the total absolute and relative powers, peak, absolute, and relative powers, and frequency at peak absolute power of upper offset segment. The relative power is relative to total aggregated power.
Use "offset(n)" or "subblock(n)/offset(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.
Syntax
Namespace: NationalInstruments.RFmx.LteMX
public int FetchUpperOffsetPower(string selectorString, double timeout, out double absoluteIntegratedPower, out double relativeIntegratedPower, out double absolutePeakPower, out double peakFrequency, out double relativePeakPower)
Parameters
| Name | Type | Description |
|---|---|---|
| selectorString | string | Specifies a selector string comprising of the result name, subblock number, and offset number. If you do not specify the result name, the default result instance is used. Example: |
| timeout | double | 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 | out double | Upon return, contains the upper offset segment power. 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 | out double | Upon return, contains the power in the upper offset segment relative to the value returned by the GetTotalAggregatedPower(string, out 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 | out double | Upon return, contains the peak power 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 | out double | Upon return, contains the 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 | out double | Upon return, contains the 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. |
Returns
Returns the status code of this method. The status code either indicates success or describes a warning condition.