RFmx NR DotNET

RFmxNRMXSemResults.FetchLowerOffsetMargin Method

  • Updated2024-07-17
  • 2 minute(s) read
RFmxNRMXSemResults.FetchLowerOffsetMargin Method

RFmxNRMXSemResultsFetchLowerOffsetMargin Method

Returns the measurement status, margin, frequency at margin, absolute, and relative powers at the margin for lower offset segments. The relative power is relative to the total aggregated power.
Use "offset(n)" or "subblock(n)/offset(n)" as the selector string to read results from this method.

Namespace:  NationalInstruments.RFmx.NRMX
Assembly:  NationalInstruments.RFmx.NRMX.Fx40 (in NationalInstruments.RFmx.NRMX.Fx40.dll) Version: 24.5.0.49283 (24.5.0.49283)

Syntax

public int FetchLowerOffsetMargin(
	string selectorString,
	double timeout,
	out RFmxNRMXSemLowerOffsetMeasurementStatus measurementStatus,
	out double margin,
	out double marginFrequency,
	out double marginAbsolutePower,
	out double marginRelativePower
)
Public Function FetchLowerOffsetMargin ( 
	selectorString As String,
	timeout As Double,
	<OutAttribute> ByRef measurementStatus As RFmxNRMXSemLowerOffsetMeasurementStatus,
	<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, carrier 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.NRMXRFmxNRMXSemLowerOffsetMeasurementStatus
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 absolute limit mask for lower (negative) offset. Margin is defined as the minimum difference between the spectrum and the limit mask. This value is expressed in dB.
marginFrequency
Type: SystemDouble
Upon return, contains the frequency at which the margin occurs in the lower offset. This value is expressed in Hz.
marginAbsolutePower
Type: SystemDouble
Upon return, contains the power at which the margin occurs in the lower offset segment. This value is expressed in dBm.
marginRelativePower
Type: SystemDouble
Upon return, contains the power at which the margin occurs in the lower offset segment. This value is expressed in dB.

Return Value

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

See Also

Log in to get a better experience