Returns an array of measurement statuses, margins, frequencies at margins, and absolute and relative powers at margins for lower offset segments. The relative power is relative to the 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.

Syntax

Namespace: NationalInstruments.RFmx.LteMX

public int FetchLowerOffsetMarginArray(string selectorString, double timeout, ref RFmxLteMXSemLowerOffsetMeasurementStatus[] measurementStatus, ref double[] margin, ref double[] marginFrequency, ref double[] marginAbsolutePower, ref double[] marginRelativePower)

Parameters

NameTypeDescription
selectorStringstring

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, int) method to build the selector string.

timeoutdouble

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.

measurementStatusref RFmxLteMXSemLowerOffsetMeasurementStatus[]

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

marginref double[]

Upon return, contains the array of margins from the standard-defined absolute limit mask for the lower (negative) offset. Margin is defined as the minimum difference between the spectrum and the limit mask. 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 SEM results lower offset start frequency and SEM results lower offset stop frequency are updated, and the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.

marginFrequencyref double[]

Upon return, contains the array of frequency at which the margin occurs in the lower (negative) offset. 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 SEM results lower offset start frequency and SEM results lower offset stop frequency are updated, and the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.

marginAbsolutePowerref double[]

Upon return, contains the array of power at which the margin 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 SEM results lower offset start frequency and SEM results lower offset stop frequency are updated, and the measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.

marginRelativePowerref double[]

Upon return, contains the array of powers at which the margin occurs in the upper (positive) 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.

Returns

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