RFmxLteMXSemResults.FetchUpperOffsetMargin Method

public int FetchUpperOffsetMargin(
	string selectorString,
	double timeout,
	out RFmxLteMXSemUpperOffsetMeasurementStatus measurementStatus,
	out double margin,
	out double marginFrequency,
	out double marginAbsolutePower,
	out double marginRelativePower
)

Public Function FetchUpperOffsetMargin ( 
	selectorString As String,
	timeout As Double,
	<OutAttribute> ByRef measurementStatus As RFmxLteMXSemUpperOffsetMeasurementStatus,
	<OutAttribute> ByRef margin As Double,
	<OutAttribute> ByRef marginFrequency As Double,
	<OutAttribute> ByRef marginAbsolutePower As Double,
	<OutAttribute> ByRef marginRelativePower As Double
) As Integer

Parameters

selectorString

Type: SystemString
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:
"subblock0/offset0"
"result::r1/subblock0/offset0"
You can use the BuildOffsetString(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.LteMXRFmxLteMXSemUpperOffsetMeasurementStatus
Upon return, contains the measurement status indicating whether the power before and after the burst is within the standard defined limit.

margin

Type: SystemDouble
Upon return, contains the margin from the standard defined absolute limit mask for upper 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 measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.

marginFrequency

Type: SystemDouble
Upon return, contains the frequency at which the margin occurs in the upper 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 measurement is performed on the updated offset segment. If the offset segment is discarded, a NaN is returned.

marginAbsolutePower

Type: SystemDouble
Upon return, contains the 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.

marginRelativePower

Type: SystemDouble
Upon return, contains the power at which the margin occurs in the upper (positive) 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.

Return Value

Reference