Skip to content

NI RFmx SpecAn SEM Attributes

Jump to bottom
Alex Starche edited this page Feb 28, 2022 · 4 revisions

SEM Attributes

RFMXSPECAN_ATTR_SEM_MEASUREMENT_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether to enable the SEM measurement.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXSPECAN_VAL_FALSE.

Get Function: RFmxSpecAn_SEMGetMeasurementEnabled
Set Function: RFmxSpecAn_SEMSetMeasurementEnabled

SEM Carrier

RFMXSPECAN_ATTR_SEM_NUMBER_OF_CARRIERS

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the number of carriers.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.



The default value is 1.

Get Function: RFmxSpecAn_SEMGetNumberOfCarriers
Set Function: RFmxSpecAn_SEMSetNumberOfCarriers

RFMXSPECAN_ATTR_SEM_CARRIER_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether to consider the carrier power as part of the total carrier power measurement.

Use 'carrier(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SEM_ENABLED_TRUE.

Get Function: RFmxSpecAn_SEMGetCarrierEnabled
Set Function: RFmxSpecAn_SEMSetCarrierEnabled
Values:
RFMXSPECAN_VAL_SEM_ENABLED_FALSE (0) The carrier power is not considered as part of the total carrier power.
RFMXSPECAN_VAL_SEM_ENABLED_TRUE (1) The carrier power is considered as part of the total carrier power.

RFMXSPECAN_ATTR_SEM_CARRIER_FREQUENCY

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the center frequency of the carrier, relative to the RF center frequency. This value is expressed in Hz.

Use 'carrier(n)' as the selector string to configure or read this attribute.



The default value is 0.

Get Function: RFmxSpecAn_SEMGetCarrierFrequency
Set Function: RFmxSpecAn_SEMSetCarrierFrequency

RFMXSPECAN_ATTR_SEM_CARRIER_INTEGRATION_BANDWIDTH

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the frequency range over which the measurement integrates the carrier power. This value is expressed in Hz.

Use 'carrier(n)' as the selector string to configure or read this attribute.



The default value is 2 MHz.

Get Function: RFmxSpecAn_SEMGetCarrierIntegrationBandwidth
Set Function: RFmxSpecAn_SEMSetCarrierIntegrationBandwidth

RFMXSPECAN_ATTR_SEM_CARRIER_CHANNEL_BANDWIDTH

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: specifies the channel bandwidth of the carrier. This parameter is used to calculate the values of the RFMXSPECAN_ATTR_SEM_OFFSET_START_FREQUENCY and RFMXSPECAN_ATTR_SEM_OFFSET_STOP_FREQUENCY attributes when you set the RFMXSPECAN_ATTR_SEM_OFFSET_FREQUENCY_DEFINITION attribute to RFMXSPECAN_VAL_SEM_CARRIER_EDGE_TO_MEASUREMENT_BANDWIDTH_CENTER or RFMXSPECAN_VAL_SEM_CARRIER_EDGE_TO_MEASUREMENT_BANDWIDTH_EDGE.

Use 'carrier(n)' as the selector string to configure or read this attribute.



The default value is 2 MHz.

Get Function: RFmxSpecAn_SEMGetCarrierChannelBandwidth
Set Function: RFmxSpecAn_SEMSetCarrierChannelBandwidth

SEM Carrier RBW Filter

RFMXSPECAN_ATTR_SEM_CARRIER_RBW_FILTER_AUTO_BANDWIDTH

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether the measurement computes the resolution bandwidth (RBW) of the carrier.

Use 'carrier(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SEM_CARRIER_RBW_AUTO_TRUE.

Get Function: RFmxSpecAn_SEMGetCarrierRBWFilterAutoBandwidth
Set Function: RFmxSpecAn_SEMSetCarrierRBWFilterAutoBandwidth
Values:
RFMXSPECAN_VAL_SEM_CARRIER_RBW_AUTO_FALSE (0) The measurement uses the RBW that you specify in the RFMXSPECAN_ATTR_SEM_CARRIER_RBW_FILTER_BANDWIDTH attribute.
RFMXSPECAN_VAL_SEM_CARRIER_RBW_AUTO_TRUE (1) The measurement computes the RBW.

RFMXSPECAN_ATTR_SEM_CARRIER_RBW_FILTER_BANDWIDTH

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the bandwidth of the resolution bandwidth (RBW) filter used to sweep the acquired carrier signal, when you set the RFMXSPECAN_ATTR_SEM_CARRIER_RBW_FILTER_AUTO_BANDWIDTH attribute to RFMXSPECAN_VAL_SEM_CARRIER_RBW_AUTO_FALSE. This value is expressed in Hz.

Use 'carrier(n)' as the selector string to configure or read this attribute.



The default value is 10 kHz.

Get Function: RFmxSpecAn_SEMGetCarrierRBWFilterBandwidth
Set Function: RFmxSpecAn_SEMSetCarrierRBWFilterBandwidth

RFMXSPECAN_ATTR_SEM_CARRIER_RBW_FILTER_TYPE

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the shape of the digital resolution bandwidth (RBW) filter.

Use 'carrier(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SEM_CARRIER_RBW_FILTER_TYPE_GAUSSIAN.

Get Function: RFmxSpecAn_SEMGetCarrierRBWFilterType
Set Function: RFmxSpecAn_SEMSetCarrierRBWFilterType
Values:
RFMXSPECAN_VAL_SEM_CARRIER_RBW_FILTER_TYPE_FFT_BASED (0) No RBW filtering is performed.
RFMXSPECAN_VAL_SEM_CARRIER_RBW_FILTER_TYPE_GAUSSIAN (1) The RBW filter has a Gaussian response.
RFMXSPECAN_VAL_SEM_CARRIER_RBW_FILTER_TYPE_FLAT (2) The RBW filter has a flat response.

RFMXSPECAN_ATTR_SEM_CARRIER_RBW_FILTER_BANDWIDTH_DEFINITION

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the bandwidth definition that you use to specify the value of the RFMXSPECAN_ATTR_SEM_CARRIER_RBW_FILTER_BANDWIDTH attribute.

Use 'carrier(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SEM_CARRIER_RBW_FILTER_BANDWIDTH_DEFINITION_3DB.

Get Function: RFmxSpecAn_SEMGetCarrierRBWFilterBandwidthDefinition
Set Function: RFmxSpecAn_SEMSetCarrierRBWFilterBandwidthDefinition
Values:
RFMXSPECAN_VAL_SEM_CARRIER_RBW_FILTER_BANDWIDTH_DEFINITION_3DB (0) Defines the RBW in terms of the 3 dB bandwidth of the RBW filter. When you set the RFMXSPECAN_ATTR_SEM_CARRIER_RBW_FILTER_TYPE attribute to RFMXSPECAN_VAL_SEM_CARRIER_RBW_FILTER_TYPE_FFT_BASED, RBW is the 3 dB bandwidth of the window specified by the RFMXSPECAN_ATTR_SEM_FFT_WINDOW attribute.
RFMXSPECAN_VAL_SEM_CARRIER_RBW_FILTER_BANDWIDTH_DEFINITION_BIN_WIDTH (2) Defines the RBW in terms of the spectrum bin width computed using an FFT when you set the RFMXSPECAN_ATTR_SEM_CARRIER_RBW_FILTER_TYPE attribute to FFT Based.

SEM Carrier RRC Filter

RFMXSPECAN_ATTR_SEM_CARRIER_RRC_FILTER_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether to apply the root-raised-cosine (RRC) filter on the acquired carrier channel before measuring the carrier channel power.

Use 'carrier(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SEM_RRC_FILTER_ENABLED_FALSE.

Get Function: RFmxSpecAn_SEMGetCarrierRRCFilterEnabled
Set Function: RFmxSpecAn_SEMSetCarrierRRCFilterEnabled
Values:
RFMXSPECAN_VAL_SEM_RRC_FILTER_ENABLED_FALSE (0) The channel power of the acquired carrier channel is measured directly.
RFMXSPECAN_VAL_SEM_RRC_FILTER_ENABLED_TRUE (1) The measurement applies the RRC filter on the acquired carrier channel before measuring the carrier channel power.

RFMXSPECAN_ATTR_SEM_CARRIER_RRC_FILTER_ALPHA

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the roll-off factor for the root-raised-cosine (RRC) filter to apply on the acquired carrier channel before measuring the carrier channel power.

Use 'carrier(n)' as the selector string to configure or read this attribute.



The default value is 0.1.

Get Function: RFmxSpecAn_SEMGetCarrierRRCFilterAlpha
Set Function: RFmxSpecAn_SEMSetCarrierRRCFilterAlpha

SEM Offset

RFMXSPECAN_ATTR_SEM_NUMBER_OF_OFFSETS

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the number of offset segments.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.



The default value is 1.

Get Function: RFmxSpecAn_SEMGetNumberOfOffsets
Set Function: RFmxSpecAn_SEMSetNumberOfOffsets

RFMXSPECAN_ATTR_SEM_OFFSET_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether to enable the offset segment for SEM measurement.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SEM_OFFSET_ENABLED_TRUE.

Get Function: RFmxSpecAn_SEMGetOffsetEnabled
Set Function: RFmxSpecAn_SEMSetOffsetEnabled
Values:
RFMXSPECAN_VAL_SEM_OFFSET_ENABLED_FALSE (0) Disables the offset segment for the SEM measurement.
RFMXSPECAN_VAL_SEM_OFFSET_ENABLED_TRUE (1) Enables the offset segment for the SEM measurement.

RFMXSPECAN_ATTR_SEM_OFFSET_START_FREQUENCY

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the start frequency of the offset segment relative to the closest configured carrier channel bandwidth center or carrier channel bandwidth edge based on the value of the RFMXSPECAN_ATTR_SEM_OFFSET_FREQUENCY_DEFINITION attribute. This value is expressed in Hz.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is 1 MHz.

Get Function: RFmxSpecAn_SEMGetOffsetStartFrequency
Set Function: RFmxSpecAn_SEMSetOffsetStartFrequency

RFMXSPECAN_ATTR_SEM_OFFSET_STOP_FREQUENCY

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the stop frequency of the offset segment relative to the closest configured carrier channel bandwidth center or carrier channel bandwidth edge based on the value of the RFMXSPECAN_ATTR_SEM_OFFSET_FREQUENCY_DEFINITION attribute. This value is expressed in Hz.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is 2 MHz.

Get Function: RFmxSpecAn_SEMGetOffsetStopFrequency
Set Function: RFmxSpecAn_SEMSetOffsetStopFrequency

RFMXSPECAN_ATTR_SEM_OFFSET_SIDEBAND

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether the offset segment is present on one side, or on both sides of the carrier.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SEM_OFFSET_SIDEBAND_BOTH.

Get Function: RFmxSpecAn_SEMGetOffsetSideband
Set Function: RFmxSpecAn_SEMSetOffsetSideband
Values:
RFMXSPECAN_VAL_SEM_OFFSET_SIDEBAND_NEGATIVE (0) Configures a lower offset segment to the left of the leftmost carrier.
RFMXSPECAN_VAL_SEM_OFFSET_SIDEBAND_POSITIVE (1) Configures an upper offset segment to the right of the rightmost carrier.
RFMXSPECAN_VAL_SEM_OFFSET_SIDEBAND_BOTH (2) Configures both negative and positive offset segments.

SEM Offset RBW Filter

RFMXSPECAN_ATTR_SEM_OFFSET_RBW_FILTER_AUTO_BANDWIDTH

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether the measurement computes the resolution bandwidth (RBW).

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SEM_RBW_AUTO_TRUE.

Get Function: RFmxSpecAn_SEMGetOffsetRBWFilterAutoBandwidth
Set Function: RFmxSpecAn_SEMSetOffsetRBWFilterAutoBandwidth
Values:
RFMXSPECAN_VAL_SEM_RBW_AUTO_FALSE (0) The measurement uses the RBW that you specify in the RFMXSPECAN_ATTR_SEM_OFFSET_RBW_FILTER_BANDWIDTH attribute.
RFMXSPECAN_VAL_SEM_RBW_AUTO_TRUE (1) The measurement computes the RBW.

RFMXSPECAN_ATTR_SEM_OFFSET_RBW_FILTER_BANDWIDTH

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the bandwidth of the resolution bandwidth (RBW) filter used to sweep the acquired offset segment, when you set the RFMXSPECAN_ATTR_SEM_OFFSET_RBW_FILTER_AUTO_BANDWIDTH attribute to RFMXSPECAN_VAL_SEM_RBW_AUTO_FALSE. This value is expressed in Hz.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is 10 kHz.

Get Function: RFmxSpecAn_SEMGetOffsetRBWFilterBandwidth
Set Function: RFmxSpecAn_SEMSetOffsetRBWFilterBandwidth

RFMXSPECAN_ATTR_SEM_OFFSET_RBW_FILTER_TYPE

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the shape of the digital resolution bandwidth (RBW) filter.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SEM_RBW_FILTER_TYPE_GAUSSIAN.

Get Function: RFmxSpecAn_SEMGetOffsetRBWFilterType
Set Function: RFmxSpecAn_SEMSetOffsetRBWFilterType
Values:
RFMXSPECAN_VAL_SEM_RBW_FILTER_TYPE_FFT_BASED (0) No RBW filtering is performed.
RFMXSPECAN_VAL_SEM_RBW_FILTER_TYPE_GAUSSIAN (1) The RBW filter has a Gaussian response.
RFMXSPECAN_VAL_SEM_RBW_FILTER_TYPE_FLAT (2) The RBW filter has a flat response.

RFMXSPECAN_ATTR_SEM_OFFSET_RBW_FILTER_BANDWIDTH_DEFINITION

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the bandwidth definition which you use to specify the value of the RFMXSPECAN_ATTR_SEM_OFFSET_RBW_FILTER_BANDWIDTH attribute.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SEM_OFFSET_RBW_FILTER_BANDWIDTH_DEFINITION_3DB.

Get Function: RFmxSpecAn_SEMGetOffsetRBWFilterBandwidthDefinition
Set Function: RFmxSpecAn_SEMSetOffsetRBWFilterBandwidthDefinition
Values:
RFMXSPECAN_VAL_SEM_OFFSET_RBW_FILTER_BANDWIDTH_DEFINITION_3DB (0) Defines the RBW in terms of the 3dB bandwidth of the RBW filter. When you set the RFMXSPECAN_ATTR_SEM_OFFSET_RBW_FILTER_TYPE attribute to RFMXSPECAN_VAL_SEM_RBW_FILTER_TYPE_FFT_BASED, RBW is the 3dB bandwidth of the window specified by the RFMXSPECAN_ATTR_SEM_FFT_WINDOW attribute.
RFMXSPECAN_VAL_SEM_OFFSET_RBW_FILTER_BANDWIDTH_DEFINITION_BIN_WIDTH (2) Defines the RBW in terms of the spectrum bin width computed using FFT when you set the RFMXSPECAN_ATTR_SEM_OFFSET_RBW_FILTER_TYPE attribute to FFT Based.

RFMXSPECAN_ATTR_SEM_OFFSET_BANDWIDTH_INTEGRAL

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the resolution of the spectrum to compare with spectral mask limits as an integer multiple of the resolution bandwidth (RBW).

If you set this attribute to a value greater than 1, the measurement acquires the spectrum with a narrow resolution and then processes it digitally to get a wider resolution that is equal to the product of the bandwidth integral and the RBW.

Use 'offset(n)' as the selector string to configure or read this attribute.

The default value is 1.

Get Function: RFmxSpecAn_SEMGetOffsetBandwidthIntegral
Set Function: RFmxSpecAn_SEMSetOffsetBandwidthIntegral

RFMXSPECAN_ATTR_SEM_OFFSET_RELATIVE_ATTENUATION

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the attenuation relative to the external attenuation specified by the RFMXSPECAN_ATTR_EXTERNAL_ATTENUATION attribute. This value is expressed in dB. Use the SEM Offset Rel Attn attribute to compensate for the variations in external attenuation when offset segments are spread wide in frequency.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is 0.

Get Function: RFmxSpecAn_SEMGetOffsetRelativeAttenuation
Set Function: RFmxSpecAn_SEMSetOffsetRelativeAttenuation

RFMXSPECAN_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the criteria to determine the measurement fail status.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SEM_OFFSET_LIMIT_FAIL_MASK_ABSOLUTE_AND_RELATIVE.

Get Function: RFmxSpecAn_SEMGetOffsetLimitFailMask
Set Function: RFmxSpecAn_SEMSetOffsetLimitFailMask
Values:
RFMXSPECAN_VAL_SEM_OFFSET_LIMIT_FAIL_MASK_ABSOLUTE_AND_RELATIVE (0) The measurement fails if the power in the segment exceeds both the absolute and relative masks.
RFMXSPECAN_VAL_SEM_OFFSET_LIMIT_FAIL_MASK_ABSOLUTE_OR_RELATIVE (1) The measurement fails if the power in the segment exceeds either the absolute or relative mask.
RFMXSPECAN_VAL_SEM_OFFSET_LIMIT_FAIL_MASK_ABSOLUTE (2) The measurement fails if the power in the segment exceeds the absolute mask.
RFMXSPECAN_VAL_SEM_OFFSET_LIMIT_FAIL_MASK_RELATIVE (3) The measurement fails if the power in the segment exceeds the relative mask.

SEM Offset Absolute Limit

RFMXSPECAN_ATTR_SEM_OFFSET_ABSOLUTE_LIMIT_MODE

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether the absolute limit mask is a flat line or a line with a slope.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SEM_OFFSET_ABSOLUTE_LIMIT_MODE_COUPLE.

Get Function: RFmxSpecAn_SEMGetOffsetAbsoluteLimitMode
Set Function: RFmxSpecAn_SEMSetOffsetAbsoluteLimitMode
Values:
RFMXSPECAN_VAL_SEM_OFFSET_ABSOLUTE_LIMIT_MODE_MANUAL (0) The line specified by the RFMXSPECAN_ATTR_SEM_OFFSET_ABSOLUTE_LIMIT_START and RFMXSPECAN_ATTR_SEM_OFFSET_ABSOLUTE_LIMIT_STOP attribute values as the two ends is considered as the mask.
RFMXSPECAN_VAL_SEM_OFFSET_ABSOLUTE_LIMIT_MODE_COUPLE (1) The two ends of the line are coupled to the value of the RFMXSPECAN_ATTR_SEM_OFFSET_ABSOLUTE_LIMIT_START attribute.

RFMXSPECAN_ATTR_SEM_OFFSET_ABSOLUTE_LIMIT_START

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the absolute power limit corresponding to the beginning of the offset segment. This value is expressed in dBm. This power limit is also set as the stop limit for the offset segment when you set the RFMXSPECAN_ATTR_SEM_OFFSET_ABSOLUTE_LIMIT_MODE attribute to RFMXSPECAN_VAL_SEM_OFFSET_ABSOLUTE_LIMIT_MODE_COUPLE.

Use 'offset(n)' as the selector string to configure or read this attribute.

The default value is -10.

Get Function: RFmxSpecAn_SEMGetOffsetAbsoluteLimitStart
Set Function: RFmxSpecAn_SEMSetOffsetAbsoluteLimitStart

RFMXSPECAN_ATTR_SEM_OFFSET_ABSOLUTE_LIMIT_STOP

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the absolute power limit corresponding to the end of the offset segment. This value is expressed in dBm. The measurement ignores this attribute when you set the RFMXSPECAN_ATTR_SEM_OFFSET_ABSOLUTE_LIMIT_MODE attribute to RFMXSPECAN_VAL_SEM_OFFSET_ABSOLUTE_LIMIT_MODE_COUPLE.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is -10.

Get Function: RFmxSpecAn_SEMGetOffsetAbsoluteLimitStop
Set Function: RFmxSpecAn_SEMSetOffsetAbsoluteLimitStop

SEM Offset Relative Limit

RFMXSPECAN_ATTR_SEM_OFFSET_RELATIVE_LIMIT_MODE

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether the relative limit mask is a flat line or a line with a slope.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SEM_OFFSET_RELATIVE_LIMIT_MODE_MANUAL.

Get Function: RFmxSpecAn_SEMGetOffsetRelativeLimitMode
Set Function: RFmxSpecAn_SEMSetOffsetRelativeLimitMode
Values:
RFMXSPECAN_VAL_SEM_OFFSET_RELATIVE_LIMIT_MODE_MANUAL (0) The line specified by the RFMXSPECAN_ATTR_SEM_OFFSET_RELATIVE_LIMIT_START and RFMXSPECAN_ATTR_SEM_OFFSET_RELATIVE_LIMIT_STOP attribute values as the two ends is considered as the mask.
RFMXSPECAN_VAL_SEM_OFFSET_RELATIVE_LIMIT_MODE_COUPLE (1) The two ends of the line are coupled to the value of the RFMXSPECAN_ATTR_SEM_OFFSET_RELATIVE_LIMIT_START attribute.

RFMXSPECAN_ATTR_SEM_OFFSET_RELATIVE_LIMIT_START

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the relative power limit corresponding to the beginning of the offset segment. This value is expressed in dB. This power limit is also set as the stop limit for the offset segment when you set the RFMXSPECAN_ATTR_SEM_OFFSET_RELATIVE_LIMIT_MODE attribute to RFMXSPECAN_VAL_SEM_OFFSET_RELATIVE_LIMIT_MODE_COUPLE.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is -20.

Get Function: RFmxSpecAn_SEMGetOffsetRelativeLimitStart
Set Function: RFmxSpecAn_SEMSetOffsetRelativeLimitStart

RFMXSPECAN_ATTR_SEM_OFFSET_RELATIVE_LIMIT_STOP

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the relative power limit corresponding to the end of the offset segment. This value is expressed in dB. The measurement ignores this attribute when you set the RFMXSPECAN_ATTR_SEM_OFFSET_RELATIVE_LIMIT_MODE attribute to RFMXSPECAN_VAL_SEM_OFFSET_RELATIVE_LIMIT_MODE_COUPLE.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is -30.

Get Function: RFmxSpecAn_SEMGetOffsetRelativeLimitStop
Set Function: RFmxSpecAn_SEMSetOffsetRelativeLimitStop

RFMXSPECAN_ATTR_SEM_OFFSET_FREQUENCY_DEFINITION

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the definition of the start frequency and stop frequency of the offset segments from the nearest carrier channels.

Use 'offset(n)' as the selector string to configure or read this attribute.



The default value is Carrier Center to Meas BW Center.

Get Function: RFmxSpecAn_SEMGetOffsetFrequencyDefinition
Set Function: RFmxSpecAn_SEMSetOffsetFrequencyDefinition
Values:
RFMXSPECAN_VAL_SEM_CARRIER_CENTER_TO_MEASUREMENT_BANDWIDTH_CENTER (0) The start frequency and stop frequency are defined from the center of the closest carrier channel bandwidth to the center of the offset segment measurement bandwidth. Measurement Bandwidth = Resolution Bandwidth * Bandwidth Integral.
RFMXSPECAN_VAL_SEM_CARRIER_CENTER_TO_MEASUREMENT_BANDWIDTH_EDGE (1) The start frequency and stop frequency are defined from the center of the closest carrier channel bandwidth to the nearest edge of the offset segment measurement bandwidth.
RFMXSPECAN_VAL_SEM_CARRIER_EDGE_TO_MEASUREMENT_BANDWIDTH_CENTER (2) The start frequency and stop frequency are defined from the nearest edge of the closest carrier channel bandwidth to the center of the nearest offset segment measurement bandwidth.
RFMXSPECAN_VAL_SEM_CARRIER_EDGE_TO_MEASUREMENT_BANDWIDTH_EDGE (3) The start frequency and stop frequency are defined from the nearest edge of the closest carrier channel bandwidth to the edge of the nearest offset segment measurement bandwidth.

RFMXSPECAN_ATTR_SEM_POWER_UNITS

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the units for the absolute power.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM_PER_HZ.

Get Function: RFmxSpecAn_SEMGetPowerUnits
Set Function: RFmxSpecAn_SEMSetPowerUnits
Values:
RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM (0) The absolute powers are reported in dBm.
RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM_PER_HZ (1) The absolute powers are reported in dBm/Hz.

RFMXSPECAN_ATTR_SEM_REFERENCE_TYPE

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether the power reference is the integrated power or the peak power in the closest carrier channel. The leftmost carrier is the carrier closest to all the lower (negative) offset segments. The rightmost carrier is the carrier closest to all the upper (positive) offset segments.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXSPECAN_VAL_SEM_REFERENCE_TYPE_INTEGRATION.

Get Function: RFmxSpecAn_SEMGetReferenceType
Set Function: RFmxSpecAn_SEMSetReferenceType
Values:
RFMXSPECAN_VAL_SEM_REFERENCE_TYPE_INTEGRATION (0) The power reference is the integrated power of the closest carrier.
RFMXSPECAN_VAL_SEM_REFERENCE_TYPE_PEAK (1) The power reference is the peak power of the closest carrier.

SEM Sweep Time

RFMXSPECAN_ATTR_SEM_SWEEP_TIME_AUTO

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether the measurement computes the sweep time.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXSPECAN_VAL_SEM_SWEEP_TIME_AUTO_TRUE.

Get Function: RFmxSpecAn_SEMGetSweepTimeAuto
Set Function: RFmxSpecAn_SEMSetSweepTimeAuto
Values:
RFMXSPECAN_VAL_SEM_SWEEP_TIME_AUTO_FALSE (0) The measurement uses the sweep time that you specify in the RFMXSPECAN_ATTR_SEM_SWEEP_TIME_INTERVAL attribute.
RFMXSPECAN_VAL_SEM_SWEEP_TIME_AUTO_TRUE (1) The measurement calculates the sweep time based on the value of the RFMXSPECAN_ATTR_SEM_OFFSET_RBW_FILTER_BANDWIDTH and RFMXSPECAN_ATTR_SEM_CARRIER_RBW_FILTER_BANDWIDTH attributes.

RFMXSPECAN_ATTR_SEM_SWEEP_TIME_INTERVAL

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the sweep time when you set the RFMXSPECAN_ATTR_SEM_SWEEP_TIME_AUTO attribute to RFMXSPECAN_VAL_SEM_SWEEP_TIME_AUTO_FALSE. This value is expressed in seconds.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is 0.001.

Get Function: RFmxSpecAn_SEMGetSweepTimeInterval
Set Function: RFmxSpecAn_SEMSetSweepTimeInterval

SEM Averaging

RFMXSPECAN_ATTR_SEM_AVERAGING_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether to enable averaging for the SEM measurement.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXSPECAN_VAL_SEM_AVERAGING_ENABLED_FALSE.

Get Function: RFmxSpecAn_SEMGetAveragingEnabled
Set Function: RFmxSpecAn_SEMSetAveragingEnabled
Values:
RFMXSPECAN_VAL_SEM_AVERAGING_ENABLED_FALSE (0) The measurement is performed on a single acquisition.
RFMXSPECAN_VAL_SEM_AVERAGING_ENABLED_TRUE (1) The SEM measurement uses the RFMXSPECAN_ATTR_SEM_AVERAGING_COUNT attribute as the number of acquisitions over which the SEM measurement is averaged.

RFMXSPECAN_ATTR_SEM_AVERAGING_COUNT

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the number of acquisitions used for averaging when you set the RFMXSPECAN_ATTR_SEM_AVERAGING_ENABLED attribute to RFMXSPECAN_VAL_SEM_AVERAGING_ENABLED_TRUE.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is 10.

Get Function: RFmxSpecAn_SEMGetAveragingCount
Set Function: RFmxSpecAn_SEMSetAveragingCount

RFMXSPECAN_ATTR_SEM_AVERAGING_TYPE

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the averaging type for averaging multiple spectrum acquisitions. The averaged spectrum is used for SEM measurement.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXSPECAN_VAL_SEM_AVERAGING_TYPE_RMS.

Get Function: RFmxSpecAn_SEMGetAveragingType
Set Function: RFmxSpecAn_SEMSetAveragingType
Values:
RFMXSPECAN_VAL_SEM_AVERAGING_TYPE_RMS (0) The power spectrum is linearly averaged. RMS averaging reduces signal fluctuations but not the noise floor.
RFMXSPECAN_VAL_SEM_AVERAGING_TYPE_LOG (1) The power spectrum is averaged in a logarithmic scale.
RFMXSPECAN_VAL_SEM_AVERAGING_TYPE_SCALAR (2) The square root of the power spectrum is averaged.
RFMXSPECAN_VAL_SEM_AVERAGING_TYPE_MAXIMUM (3) The peak power in the spectrum at each frequency bin is retained from one acquisition to the next.
RFMXSPECAN_VAL_SEM_AVERAGING_TYPE_MINIMUM (4) The least power in the spectrum at each frequency bin is retained from one acquisition to the next.

SEM FFT

RFMXSPECAN_ATTR_SEM_FFT_WINDOW

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the FFT window type to use to reduce spectral leakage.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXSPECAN_VAL_SEM_FFT_WINDOW_FLAT_TOP.

Get Function: RFmxSpecAn_SEMGetFFTWindow
Set Function: RFmxSpecAn_SEMSetFFTWindow
Values:
RFMXSPECAN_VAL_SEM_FFT_WINDOW_NONE (0) Analyzes transients for which duration is shorter than the window length. You can also use this window type to separate two tones with frequencies close to each other but with almost equal amplitudes.
RFMXSPECAN_VAL_SEM_FFT_WINDOW_FLAT_TOP (1) Measures single-tone amplitudes accurately.
RFMXSPECAN_VAL_SEM_FFT_WINDOW_HANNING (2) Analyzes transients for which duration is longer than the window length. You can also use this window type to provide better frequency resolution for noise measurements.
RFMXSPECAN_VAL_SEM_FFT_WINDOW_HAMMING (3) Analyzes closely-spaced sine waves.
RFMXSPECAN_VAL_SEM_FFT_WINDOW_GAUSSIAN (4) Provides a good balance of spectral leakage, frequency resolution, and amplitude attenuation. Hence, this windowing is useful for time-frequency analysis.
RFMXSPECAN_VAL_SEM_FFT_WINDOW_BLACKMAN (5) Analyzes single tone because it has a low maximum side lobe level and a high side lobe roll-off rate.
RFMXSPECAN_VAL_SEM_FFT_WINDOW_BLACKMAN_HARRIS (6) Useful as a good general purpose window, having side lobe rejection greater than 90 dB and having a moderately wide main lobe.
RFMXSPECAN_VAL_SEM_FFT_WINDOW_KAISER_BESSEL (7) Separates two tones with frequencies close to each other but with widely-differing amplitudes.

RFMXSPECAN_ATTR_SEM_FFT_PADDING

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the factor by which the time-domain waveform is zero-padded before FFT. The FFT size is given by the following formula:

waveform size * padding

This attribute is used only when the acquisition span is less than the device instantaneous bandwidth of the device.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is -1.

Get Function: RFmxSpecAn_SEMGetFFTPadding
Set Function: RFmxSpecAn_SEMSetFFTPadding

RFMXSPECAN_ATTR_SEM_AMPLITUDE_CORRECTION_TYPE

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether the amplitude of the frequency bins, used in the measurement, is corrected for external attenuation at the RF center frequency, or at the individual frequency bins. Use the RFmxInstr_CfgExternalAttenuationTable function to configure the external attenuation table.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXSPECAN_VAL_SEM_AMPLITUDE_CORRECTION_TYPE_RF_CENTER_FREQUENCY.

Get Function: RFmxSpecAn_SEMGetAmplitudeCorrectionType
Set Function: RFmxSpecAn_SEMSetAmplitudeCorrectionType
Values:
RFMXSPECAN_VAL_SEM_AMPLITUDE_CORRECTION_TYPE_RF_CENTER_FREQUENCY (0) All the frequency bins in the spectrum are compensated with a single external attenuation value that corresponds to the RF center frequency.
RFMXSPECAN_VAL_SEM_AMPLITUDE_CORRECTION_TYPE_SPECTRUM_FREQUENCY_BIN (1) An individual frequency bin in the spectrum is compensated with the external attenuation value corresponding to that frequency.

RFMXSPECAN_ATTR_SEM_ALL_TRACES_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether to enable the traces to be stored and retrieved after performing the SEM measurement.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXSPECAN_VAL_FALSE.

Get Function: RFmxSpecAn_SEMGetAllTracesEnabled
Set Function: RFmxSpecAn_SEMSetAllTracesEnabled

RFMXSPECAN_ATTR_SEM_NUMBER_OF_ANALYSIS_THREADS

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the maximum number of threads used for parallelism for SEM measurement.

The number of threads can range from 1 to the number of physical cores. The number of threads you set may not be used in calculations. The actual number of threads used depends on the problem size, system resources, data availability, and other considerations.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is 1.

Get Function: RFmxSpecAn_SEMGetNumberOfAnalysisThreads
Set Function: RFmxSpecAn_SEMSetNumberOfAnalysisThreads

SEM Results

RFMXSPECAN_ATTR_SEM_RESULTS_TOTAL_CARRIER_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the total integrated power, in dBm, of all the enabled carriers measured when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM. Returns the power spectral density, in dBm/Hz, when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM_PER_HZ.

You do not need to use a selector string to read this result for default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results.

Get Function: RFmxSpecAn_SEMGetResultsTotalCarrierPower

RFMXSPECAN_ATTR_SEM_RESULTS_COMPOSITE_MEASUREMENT_STATUS

Data Type: int32
Access: read only
Functions: RFmxSpecAn_GetAttributeI32
Description: Indicates the overall measurement status based on the measurement limits and the fail criteria that you set in the RFMXSPECAN_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK attribute for each offset segment.

You do not need to use a selector string to read this result for default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results.

Get Function: RFmxSpecAn_SEMGetResultsCompositeMeasurementStatus
Values:
RFMXSPECAN_VAL_SEM_COMPOSITE_MEASUREMENT_STATUS_FAIL (0) Indicates that the measurement has failed.
RFMXSPECAN_VAL_SEM_COMPOSITE_MEASUREMENT_STATUS_PASS (1) Indicates that the measurement has passed.

RFMXSPECAN_ATTR_SEM_RESULTS_FREQUENCY_RESOLUTION

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the frequency bin spacing of the spectrum acquired by the measurement. This value is expressed in Hz.

You do not need to use a selector string to read this result for default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results.

Get Function: RFmxSpecAn_SEMGetResultsFrequencyResolution

SEM Results Carrier

RFMXSPECAN_ATTR_SEM_RESULTS_CARRIER_TOTAL_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the carrier power relative to the total carrier power of all enabled carriers. This value is expressed in dB.

Use 'carrier(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsCarrierTotalRelativePower

RFMXSPECAN_ATTR_SEM_RESULTS_CARRIER_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the carrier power.

The carrier power is reported in dBm when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM_PER_HZ.

Use 'carrier(n)' as the selector string to read this result.

Get Function: RFmxSpecAn_SEMGetResultsCarrierAbsolutePower

RFMXSPECAN_ATTR_SEM_RESULTS_CARRIER_PEAK_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the peak power in the carrier channel.

The power is reported in dBm when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM_PER_HZ.

Use 'carrier(n)' as the selector string to read this result.

Get Function: RFmxSpecAn_SEMGetResultsCarrierPeakAbsolutePower

RFMXSPECAN_ATTR_SEM_RESULTS_CARRIER_PEAK_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the frequency at which the peak power occurs in the carrier channel. This value is expressed in Hz.

Use 'carrier(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsCarrierPeakFrequency

RFMXSPECAN_ATTR_SEM_RESULTS_CARRIER_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the center frequency of the carrier relative to the Center Frequency attribute. This value is expressed in Hz.

Use 'carrier(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsCarrierFrequency

RFMXSPECAN_ATTR_SEM_RESULTS_CARRIER_INTEGRATION_BANDWIDTH

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the frequency range, over which the measurement integrates the carrier power. This value is expressed in Hz.

Use 'carrier(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsCarrierIntegrationBandwidth

SEM Results Lower Offset

RFMXSPECAN_ATTR_SEM_RESULTS_LOWER_OFFSET_MEASUREMENT_STATUS

Data Type: int32
Access: read only
Functions: RFmxSpecAn_GetAttributeI32
Description: Indicates the lower offset segment measurement status based on measurement limits and the fail criteria that you specify in the RFMXSPECAN_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK attribute.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsLowerOffsetMeasurementStatus
Values:
RFMXSPECAN_VAL_SEM_LOWER_OFFSET_MEASUREMENT_STATUS_FAIL (0) Indicates that the measurement has failed.
RFMXSPECAN_VAL_SEM_LOWER_OFFSET_MEASUREMENT_STATUS_PASS (1) Indicates that the measurement has passed.

RFMXSPECAN_ATTR_SEM_RESULTS_LOWER_OFFSET_TOTAL_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the power measured in the lower (negative) offset segment.

The power is reported in dBm when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM_PER_HZ.

Use 'offset(n)' as the selector string to read this result.

Get Function: RFmxSpecAn_SEMGetResultsLowerOffsetTotalAbsolutePower

RFMXSPECAN_ATTR_SEM_RESULTS_LOWER_OFFSET_TOTAL_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the power measured in the lower (negative) offset segment relative to either the integrated or peak power of the reference carrier.

When you set the RFMXSPECAN_ATTR_SEM_REFERENCE_TYPE attribute to RFMXSPECAN_VAL_SEM_REFERENCE_TYPE_INTEGRATION, the reference carrier power is the total power in the reference carrier. When you set the RFMXSPECAN_ATTR_SEM_REFERENCE_TYPE attribute to RFMXSPECAN_VAL_SEM_REFERENCE_TYPE_PEAK, the reference carrier power is the peak power in the reference carrier.

Use 'offset(n)' as the selector string to read this result.

Get Function: RFmxSpecAn_SEMGetResultsLowerOffsetTotalRelativePower

RFMXSPECAN_ATTR_SEM_RESULTS_LOWER_OFFSET_PEAK_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the peak power measured in the lower (negative) offset segment.

The power is reported in dBm when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM_PER_HZ.

Use 'offset(n)' as the selector string to read this result.

Get Function: RFmxSpecAn_SEMGetResultsLowerOffsetPeakAbsolutePower

RFMXSPECAN_ATTR_SEM_RESULTS_LOWER_OFFSET_PEAK_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the peak power measured in the lower (negative) offset segment relative to the integrated or peak power of the reference carrier.

When you set the RFMXSPECAN_ATTR_SEM_REFERENCE_TYPE attribute to RFMXSPECAN_VAL_SEM_REFERENCE_TYPE_INTEGRATION, the reference carrier power is the total power in the reference carrier. When you set the RFMXSPECAN_ATTR_SEM_REFERENCE_TYPE attribute to RFMXSPECAN_VAL_SEM_REFERENCE_TYPE_PEAK, the reference carrier power is the peak power in the reference carrier.

Use 'offset(n)' as the selector string to read this result.

Get Function: RFmxSpecAn_SEMGetResultsLowerOffsetPeakRelativePower

RFMXSPECAN_ATTR_SEM_RESULTS_LOWER_OFFSET_PEAK_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the frequency at which the peak power occurred in the lower offset segment. This value is expressed in Hz.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsLowerOffsetPeakFrequency

RFMXSPECAN_ATTR_SEM_RESULTS_LOWER_OFFSET_MARGIN

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the margin from the limit mask value that you set in the RFMXSPECAN_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK attribute. This value is expressed in dB. Margin is defined as the maximum difference between the spectrum and the limit mask.

When you set the RFMXSPECAN_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK attribute to Absolute, the margin is with reference to the absolute limit mask.

When you set the RFMXSPECAN_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK attribute to Relative, the margin is with reference to the relative limit mask.

When you set the RFMXSPECAN_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK attribute to Abs AND Rel, the margin is the maximum of the margins referenced to the absolute and relative limit masks.

When you set the RFMXSPECAN_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK attribute to Abs OR Rel, the margin is the minimum of the margins referenced to the absolute and relative limit masks.

Use 'offset(n)' as the selector string to read this result.

Get Function: RFmxSpecAn_SEMGetResultsLowerOffsetMargin

RFMXSPECAN_ATTR_SEM_RESULTS_LOWER_OFFSET_MARGIN_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the power, at which the margin occurred in the lower (negative) offset segment.

The power is reported in dBm when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM_PER_HZ.

Use 'offset(n)' as the selector string to read this result.

Get Function: RFmxSpecAn_SEMGetResultsLowerOffsetMarginAbsolutePower

RFMXSPECAN_ATTR_SEM_RESULTS_LOWER_OFFSET_MARGIN_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the power at which the margin occurred in the lower (negative) offset segment relative to the integrated or peak power of the reference carrier. This value is expressed in dB.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsLowerOffsetMarginRelativePower

RFMXSPECAN_ATTR_SEM_RESULTS_LOWER_OFFSET_MARGIN_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the frequency at which the margin occurred in the lower (negative) offset segment. This value is expressed in Hz.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsLowerOffsetMarginFrequency

RFMXSPECAN_ATTR_SEM_RESULTS_LOWER_OFFSET_START_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the start frequency of the lower (negative) offset segment. This value is expressed in Hz.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsLowerOffsetStartFrequency

RFMXSPECAN_ATTR_SEM_RESULTS_LOWER_OFFSET_STOP_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the stop frequency of the lower (negative) offset segment. This value is expressed in Hz.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsLowerOffsetStopFrequency

RFMXSPECAN_ATTR_SEM_RESULTS_LOWER_OFFSET_POWER_REFERENCE_CARRIER

Data Type: int32
Access: read only
Functions: RFmxSpecAn_GetAttributeI32
Description: Returns the index of the carrier that was used as the power reference to define the lower (negative) offset segment relative power. The reference carrier is the carrier that has an offset closest to the offset segment.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsLowerOffsetPowerReferenceCarrier

SEM Results Upper Offset

RFMXSPECAN_ATTR_SEM_RESULTS_UPPER_OFFSET_MEASUREMENT_STATUS

Data Type: int32
Access: read only
Functions: RFmxSpecAn_GetAttributeI32
Description: Indicates the upper offset measurement status based on measurement limits and the fail criteria that you specify in the RFMXSPECAN_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK attribute.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsUpperOffsetMeasurementStatus
Values:
RFMXSPECAN_VAL_SEM_UPPER_OFFSET_MEASUREMENT_STATUS_FAIL (0) Indicates that the measurement has failed.
RFMXSPECAN_VAL_SEM_UPPER_OFFSET_MEASUREMENT_STATUS_PASS (1) Indicates that the measurement has passed.

RFMXSPECAN_ATTR_SEM_RESULTS_UPPER_OFFSET_TOTAL_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the offset segment power measured in the upper (positive) offset segment.

The power is reported in dBm when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM_PER_HZ.

Use 'offset(n)' as the selector string to read this result.

Get Function: RFmxSpecAn_SEMGetResultsUpperOffsetTotalAbsolutePower

RFMXSPECAN_ATTR_SEM_RESULTS_UPPER_OFFSET_TOTAL_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the power measured in the upper (positive) offset segment relative to the integrated or peak power of the reference carrier.

When you set the RFMXSPECAN_ATTR_SEM_REFERENCE_TYPE attribute to RFMXSPECAN_VAL_SEM_REFERENCE_TYPE_INTEGRATION, the reference carrier power is the total power in the reference carrier. When you set the RFMXSPECAN_ATTR_SEM_REFERENCE_TYPE attribute to RFMXSPECAN_VAL_SEM_REFERENCE_TYPE_PEAK, the reference carrier power is the peak power in the reference.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsUpperOffsetTotalRelativePower

RFMXSPECAN_ATTR_SEM_RESULTS_UPPER_OFFSET_PEAK_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the peak power measured in the upper (positive) offset segment.

The power is reported in dBm when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM_PER_HZ.

Use 'offset(n)' as the selector string to read this result.

Get Function: RFmxSpecAn_SEMGetResultsUpperOffsetPeakAbsolutePower

RFMXSPECAN_ATTR_SEM_RESULTS_UPPER_OFFSET_PEAK_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the peak power measured in the upper (positive) offset segment relative to the integrated or peak power of the reference carrier.

When you set the RFMXSPECAN_ATTR_SEM_REFERENCE_TYPE attribute to RFMXSPECAN_VAL_SEM_REFERENCE_TYPE_INTEGRATION, the reference carrier power is the total power in the reference carrier. When you set the RFMXSPECAN_ATTR_SEM_REFERENCE_TYPE attribute to RFMXSPECAN_VAL_SEM_REFERENCE_TYPE_PEAK, the reference carrier power is the peak power in the reference carrier.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsUpperOffsetPeakRelativePower

RFMXSPECAN_ATTR_SEM_RESULTS_UPPER_OFFSET_PEAK_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the frequency at which the peak power occurred in the upper offset segment. This value is expressed in Hz.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsUpperOffsetPeakFrequency

RFMXSPECAN_ATTR_SEM_RESULTS_UPPER_OFFSET_MARGIN

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the margin from the limit mask value that you set in the RFMXSPECAN_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK attribute. This value is expressed in dB. Margin is defined as the maximum difference between the spectrum and the limit mask.

When you set the RFMXSPECAN_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK attribute to Absolute, the margin is with reference to the absolute limit mask.

When you set the RFMXSPECAN_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK attribute to Relative, the margin is with reference to the relative limit mask.

When you set the RFMXSPECAN_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK attribute to Abs AND Rel, the margin is the maximum of the margin referenced to the absolute and relative limit masks.

When you set the RFMXSPECAN_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK attribute to Abs OR Rel, the margin is the minimum of the margin referenced to the absolute and relative limit masks.

Use 'offset(n)' as the selector string to read this result.

Get Function: RFmxSpecAn_SEMGetResultsUpperOffsetMargin

RFMXSPECAN_ATTR_SEM_RESULTS_UPPER_OFFSET_MARGIN_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the power, at which the margin occurred in the upper (positive) offset segment.

The power is reported in dBm when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXSPECAN_ATTR_SEM_POWER_UNITS attribute to RFMXSPECAN_VAL_SEM_POWER_UNITS_DBM_PER_HZ.

Use 'offset(n)' as the selector string to read this result.

Get Function: RFmxSpecAn_SEMGetResultsUpperOffsetMarginAbsolutePower

RFMXSPECAN_ATTR_SEM_RESULTS_UPPER_OFFSET_MARGIN_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the power at which the margin occurred in the upper (positive) offset segment relative to the integrated or peak power of the reference carrier. This value is expressed in dB.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsUpperOffsetMarginRelativePower

RFMXSPECAN_ATTR_SEM_RESULTS_UPPER_OFFSET_MARGIN_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the frequency at which the margin occurred in the upper (positive) offset. This value is expressed in Hz.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsUpperOffsetMarginFrequency

RFMXSPECAN_ATTR_SEM_RESULTS_UPPER_OFFSET_START_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the start frequency of the upper (positive) offset segment. This value is expressed in Hz.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsUpperOffsetStartFrequency

RFMXSPECAN_ATTR_SEM_RESULTS_UPPER_OFFSET_STOP_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the stop frequency of the upper (positive) offset segment. This value is expressed in Hz.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsUpperOffsetStopFrequency

RFMXSPECAN_ATTR_SEM_RESULTS_UPPER_OFFSET_POWER_REFERENCE_CARRIER

Data Type: int32
Access: read only
Functions: RFmxSpecAn_GetAttributeI32
Description: Returns the index of the carrier that was used as the power reference to define the upper (positive) offset segment relative power. The reference carrier is the carrier that has an offset closest to the offset segment.

Use 'offset(n)' as the selector string to read this result.



Get Function: RFmxSpecAn_SEMGetResultsUpperOffsetPowerReferenceCarrier

Table of Contents

Home

Internal Development

Creating and Setting Up a gRPC Server

Server Security Support

Creating a gRPC Client

gRPC Client Examples

Session Utilities API Reference

Driver Documentation

gRPC API Differences From C API

Sharing Driver Sessions Between Clients

C API Docs
NI-DAQmx
NI-DCPOWER
NI-DIGITAL PATTERN DRIVER
NI-DMM
NI-FGEN
NI-FPGA
NI-RFmx Bluetooth
NI-RFmx NR
NI-RFmx WCDMA
NI-RFmx GSM
NI-RFmx CDMA2k
NI-RFmx Instr
NI-RFmx LTE
NI-RFmx SpecAn
NI-RFmx TD-SCDMA
NI-RFmx WLAN
NI-RFSA
NI-RFSG
NI-SCOPE
NI-SWITCH
NI-TCLK
NI-XNET
Clone this wiki locally