RFmxLteMXSemResults.FetchUpperOffsetMarginArray Method

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

Public Function FetchUpperOffsetMarginArray ( 
	selectorString As String,
	timeout As Double,
	ByRef measurementStatus As RFmxLteMXSemUpperOffsetMeasurementStatus(),
	ByRef margin As Double(),
	ByRef marginFrequency As Double(),
	ByRef marginAbsolutePower As Double(),
	ByRef marginRelativePower 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.

measurementStatus

Type: NationalInstruments.RFmx.LteMXRFmxLteMXSemUpperOffsetMeasurementStatus
Upon return, contains the array of 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 array of margins from the standard defined absolute limit mask for upper offset. The 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 array of 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 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.

marginRelativePower

Type: SystemDouble
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, 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