NI RFmx SpecAn Spur Attributes - ni/grpc-device GitHub Wiki

Spur Attributes

RFMXSPECAN_ATTR_SPUR_MEASUREMENT_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether to enable the spurious emission (Spur) measurement.

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.

The default value is RFMXSPECAN_VAL_FALSE.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetMeasurementEnabled
Set Function: RFmxSpecAn_SpurSetMeasurementEnabled

Spur Range

RFMXSPECAN_ATTR_SPUR_NUMBER_OF_RANGES

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

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.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetNumberOfRanges
Set Function: RFmxSpecAn_SpurSetNumberOfRanges

RFMXSPECAN_ATTR_SPUR_RANGE_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether to measure the spurious emissions (Spur) in the frequency range.

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



The default value is RFMXSPECAN_VAL_SPUR_RANGE_ENABLED_TRUE.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangeEnabled
Set Function: RFmxSpecAn_SpurSetRangeEnabled
Values:
RFMXSPECAN_VAL_SPUR_RANGE_ENABLED_FALSE (0) Disables the acquisition of the frequency range.
RFMXSPECAN_VAL_SPUR_RANGE_ENABLED_TRUE (1) Enables measurement of Spurs in the frequency range.

RFMXSPECAN_ATTR_SPUR_RANGE_START_FREQUENCY

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the start of the frequency range for the measurement. This value is expressed in Hz.

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



The default value is 500 MHz.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangeStartFrequency
Set Function: RFmxSpecAn_SpurSetRangeStartFrequency

RFMXSPECAN_ATTR_SPUR_RANGE_STOP_FREQUENCY

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the stop of the frequency range for the measurement. This value is expressed in Hz.

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



The default value is 1.5 GHz.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangeStopFrequency
Set Function: RFmxSpecAn_SpurSetRangeStopFrequency

Spur RBW Filter

RFMXSPECAN_ATTR_SPUR_RANGE_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 'range(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SPUR_RBW_AUTO_TRUE.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangeRBWFilterAutoBandwidth
Set Function: RFmxSpecAn_SpurSetRangeRBWFilterAutoBandwidth
Values:
RFMXSPECAN_VAL_SPUR_RBW_AUTO_FALSE (0) The measurement uses the RBW that you specify in the RFMXSPECAN_ATTR_SPUR_RANGE_RBW_FILTER_BANDWIDTH attribute.
RFMXSPECAN_VAL_SPUR_RBW_AUTO_TRUE (1) The measurement computes the RBW.

RFMXSPECAN_ATTR_SPUR_RANGE_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 signal, when you set the RFMXSPECAN_ATTR_SPUR_RANGE_RBW_FILTER_AUTO_BANDWIDTH attribute to False.

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



The default value is 10 kHz.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangeRBWFilterBandwidth
Set Function: RFmxSpecAn_SpurSetRangeRBWFilterBandwidth

RFMXSPECAN_ATTR_SPUR_RANGE_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 'range(n)' as the selector string to configure or read this attribute.



The default value is RFMXSPECAN_VAL_SPUR_RBW_FILTER_TYPE_GAUSSIAN.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangeRBWFilterType
Set Function: RFmxSpecAn_SpurSetRangeRBWFilterType
Values:
RFMXSPECAN_VAL_SPUR_RBW_FILTER_TYPE_FFT_BASED (0) No RBW filtering is performed.
RFMXSPECAN_VAL_SPUR_RBW_FILTER_TYPE_GAUSSIAN (1) An RBW filter with a Gaussian response is applied.
RFMXSPECAN_VAL_SPUR_RBW_FILTER_TYPE_FLAT (2) An RBW filter with a flat response is applied.

RFMXSPECAN_ATTR_SPUR_RANGE_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_SPUR_RANGE_RBW_FILTER_BANDWIDTH attribute.

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



The default value is RFMXSPECAN_VAL_SPUR_RANGE_RBW_FILTER_BANDWIDTH_DEFINITION_3DB.

Get Function: RFmxSpecAn_SpurGetRangeRBWFilterBandwidthDefinition
Set Function: RFmxSpecAn_SpurSetRangeRBWFilterBandwidthDefinition
Values:
RFMXSPECAN_VAL_SPUR_RANGE_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_SPUR_RANGE_RBW_FILTER_TYPE attribute to RFMXSPECAN_VAL_SPUR_RBW_FILTER_TYPE_FFT_BASED, RBW is the 3dB bandwidth of the window specified by the RFMXSPECAN_ATTR_SPUR_FFT_WINDOW attribute.
RFMXSPECAN_VAL_SPUR_RANGE_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_SPUR_RANGE_RBW_FILTER_TYPE attribute to FFT Based.
RFMXSPECAN_VAL_SPUR_RANGE_RBW_FILTER_BANDWIDTH_DEFINITION_ENBW (3) Defines the RBW in terms of the ENBW bandwidth of the RBW filter. When you set the Spur RBW Filter Type attribute to FFT Based, RBW is the ENBW bandwidth of the window specified by the RFMXSPECAN_ATTR_SPUR_FFT_WINDOW attribute.

Spur VBW Filter

RFMXSPECAN_ATTR_SPUR_RANGE_VBW_FILTER_AUTO_BANDWIDTH

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether the video bandwidth (VBW) is expressed directly or computed based on the VBW to RBW ratio.

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

The default value is RFMXSPECAN_VAL_SPUR_RANGE_VBW_FILTER_AUTO_BANDWIDTH_TRUE.

Get Function: RFmxSpecAn_SpurGetRangeVBWFilterAutoBandwidth
Set Function: RFmxSpecAn_SpurSetRangeVBWFilterAutoBandwidth
Values:
RFMXSPECAN_VAL_SPUR_RANGE_VBW_FILTER_AUTO_BANDWIDTH_FALSE (0) Specify the video bandwidth in the RFMXSPECAN_ATTR_SPUR_RANGE_VBW_FILTER_BANDWIDTH attribute. The Spur VBW to RBW Ratio attribute is disregarded in this mode.
RFMXSPECAN_VAL_SPUR_RANGE_VBW_FILTER_AUTO_BANDWIDTH_TRUE (1) Specify video bandwidth in terms of the VBW to RBW ratio. The value of the video bandwidth is then computed by using the RFMXSPECAN_ATTR_SPUR_RANGE_VBW_FILTER_VBW_TO_RBW_RATIO attribute and the RFMXSPECAN_ATTR_SPUR_RANGE_RBW_FILTER_BANDWIDTH attribute. The value of the RFMXSPECAN_ATTR_SPUR_RANGE_VBW_FILTER_BANDWIDTH attribute is disregarded in this mode.

RFMXSPECAN_ATTR_SPUR_RANGE_VBW_FILTER_BANDWIDTH

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the video bandwidth (VBW) in Hz when you set the RFMXSPECAN_ATTR_SPUR_RANGE_VBW_FILTER_AUTO_BANDWIDTH attribute to RFMXSPECAN_VAL_SPUR_RANGE_VBW_FILTER_AUTO_BANDWIDTH_FALSE.

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

The default value is 30000.

Get Function: RFmxSpecAn_SpurGetRangeVBWFilterBandwidth
Set Function: RFmxSpecAn_SpurSetRangeVBWFilterBandwidth

RFMXSPECAN_ATTR_SPUR_RANGE_VBW_FILTER_VBW_TO_RBW_RATIO

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the VBW to RBW Ratio when you set the RFMXSPECAN_ATTR_SPUR_RANGE_VBW_FILTER_AUTO_BANDWIDTH attribute to RFMXSPECAN_VAL_SPUR_RANGE_VBW_FILTER_AUTO_BANDWIDTH_TRUE.

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

The default value is 3.

Get Function: RFmxSpecAn_SpurGetRangeVBWFilterVBWToRBWRatio
Set Function: RFmxSpecAn_SpurSetRangeVBWFilterVBWToRBWRatio

Spur Sweep Time

RFMXSPECAN_ATTR_SPUR_RANGE_SWEEP_TIME_AUTO

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

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



The default value is RFMXSPECAN_VAL_SPUR_SWEEP_TIME_AUTO_TRUE.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangeSweepTimeAuto
Set Function: RFmxSpecAn_SpurSetRangeSweepTimeAuto
Values:
RFMXSPECAN_VAL_SPUR_SWEEP_TIME_AUTO_FALSE (0) The measurement uses the sweep time that you specify in the RFMXSPECAN_ATTR_SPUR_RANGE_SWEEP_TIME_INTERVAL attribute.
RFMXSPECAN_VAL_SPUR_SWEEP_TIME_AUTO_TRUE (1) The measurement calculates the sweep time based on the value of the RFMXSPECAN_ATTR_SPUR_RANGE_RBW_FILTER_BANDWIDTH attribute.

RFMXSPECAN_ATTR_SPUR_RANGE_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_SPUR_RANGE_SWEEP_TIME_AUTO attribute to RFMXSPECAN_VAL_SPUR_SWEEP_TIME_AUTO_FALSE. This value is expressed in seconds.

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



The default value is 0.001.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangeSweepTimeInterval
Set Function: RFmxSpecAn_SpurSetRangeSweepTimeInterval

Spur Detector

RFMXSPECAN_ATTR_SPUR_RANGE_DETECTOR_TYPE

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the type of detector to be used.

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

Refer to Spectral Measurements topic for more information on detector types.

The default value is RFMXSPECAN_VAL_SPUR_RANGE_DETECTOR_TYPE_NONE.

Get Function: RFmxSpecAn_SpurGetRangeDetectorType
Set Function: RFmxSpecAn_SpurSetRangeDetectorType
Values:
RFMXSPECAN_VAL_SPUR_RANGE_DETECTOR_TYPE_NONE (0) The detector is disabled.
RFMXSPECAN_VAL_SPUR_RANGE_DETECTOR_TYPE_SAMPLE (1) The middle sample in the bucket is detected.
RFMXSPECAN_VAL_SPUR_RANGE_DETECTOR_TYPE_NORMAL (2) The maximum value of the samples within the bucket is detected if the signal only rises or if the signal only falls. If the signal, within a bucket, both rises and falls, then the maximum and minimum values of the samples are detected in alternate buckets.
RFMXSPECAN_VAL_SPUR_RANGE_DETECTOR_TYPE_PEAK (3) The maximum value of the samples in the bucket is detected.
RFMXSPECAN_VAL_SPUR_RANGE_DETECTOR_TYPE_NEGATIVE_PEAK (4) The minimum value of the samples in the bucket is detected.
RFMXSPECAN_VAL_SPUR_RANGE_DETECTOR_TYPE_AVERAGE_RMS (5) The average RMS of all the samples in the bucket is detected.
RFMXSPECAN_VAL_SPUR_RANGE_DETECTOR_TYPE_AVERAGE_VOLTAGE (6) The average voltage of all the samples in the bucket is detected.
RFMXSPECAN_VAL_SPUR_RANGE_DETECTOR_TYPE_AVERAGE_LOG (7) The average log of all the samples in the bucket is detected.

RFMXSPECAN_ATTR_SPUR_RANGE_DETECTOR_POINTS

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the number of range points after the detector is applied.

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



The default value is 1001.

Get Function: RFmxSpecAn_SpurGetRangeDetectorPoints
Set Function: RFmxSpecAn_SpurSetRangeDetectorPoints

Spur Absolute Limit

RFMXSPECAN_ATTR_SPUR_RANGE_ABSOLUTE_LIMIT_MODE

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

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



The default value is RFMXSPECAN_VAL_SPUR_ABSOLUTE_LIMIT_MODE_COUPLE.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangeAbsoluteLimitMode
Set Function: RFmxSpecAn_SpurSetRangeAbsoluteLimitMode
Values:
RFMXSPECAN_VAL_SPUR_ABSOLUTE_LIMIT_MODE_MANUAL (0) The line specified by the RFMXSPECAN_ATTR_SPUR_RANGE_ABSOLUTE_LIMIT_START and RFMXSPECAN_ATTR_SPUR_RANGE_ABSOLUTE_LIMIT_STOP attribute values as the two ends is considered as the threshold.
RFMXSPECAN_VAL_SPUR_ABSOLUTE_LIMIT_MODE_COUPLE (1) The two ends of the line are coupled to the value of the RFMXSPECAN_ATTR_SPUR_RANGE_ABSOLUTE_LIMIT_START attribute.

RFMXSPECAN_ATTR_SPUR_RANGE_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 frequency range. This value is expressed in dBm. This power limit is also set as the absolute power limit for the range when you set the RFMXSPECAN_ATTR_SPUR_RANGE_ABSOLUTE_LIMIT_MODE attribute to RFMXSPECAN_VAL_SPUR_ABSOLUTE_LIMIT_MODE_COUPLE.

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



The default value is -10.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangeAbsoluteLimitStart
Set Function: RFmxSpecAn_SpurSetRangeAbsoluteLimitStart

RFMXSPECAN_ATTR_SPUR_RANGE_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 frequency range. This value is expressed in dBm. The measurement ignores this attribute when you set the RFMXSPECAN_ATTR_SPUR_RANGE_ABSOLUTE_LIMIT_MODE attribute to RFMXSPECAN_VAL_SPUR_ABSOLUTE_LIMIT_MODE_COUPLE.

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



The default value is -10.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangeAbsoluteLimitStop
Set Function: RFmxSpecAn_SpurSetRangeAbsoluteLimitStop

RFMXSPECAN_ATTR_SPUR_RANGE_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 Spur Range Rel Attn attribute to compensate for the variations in external attenuation when offset segments are spread wide in frequency.

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



The default value is 0.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangeRelativeAttenuation
Set Function: RFmxSpecAn_SpurSetRangeRelativeAttenuation

RFMXSPECAN_ATTR_SPUR_RANGE_PEAK_THRESHOLD

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the threshold level above which the measurement detects spurs in the range that you specify using the RFMXSPECAN_ATTR_SPUR_RANGE_START_FREQUENCY and RFMXSPECAN_ATTR_SPUR_RANGE_STOP_FREQUENCY attributes. This value is expressed in dBm.

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



The default value is -200.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangePeakThreshold
Set Function: RFmxSpecAn_SpurSetRangePeakThreshold

RFMXSPECAN_ATTR_SPUR_RANGE_PEAK_EXCURSION

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the peak excursion value used to find the spurs in the spectrum. This value is expressed in dB. The signal should rise and fall by at least the peak excursion value, above the threshold, to be considered a spur.

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



The default value is 0.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangePeakExcursion
Set Function: RFmxSpecAn_SpurSetRangePeakExcursion

RFMXSPECAN_ATTR_SPUR_RANGE_NUMBER_OF_SPURS_TO_REPORT

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the number of spurious emissions (Spur) that the measurement should report in the frequency range.

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



The default value is 10.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetRangeNumberOfSpursToReport
Set Function: RFmxSpecAn_SpurSetRangeNumberOfSpursToReport

Spur Averaging

RFMXSPECAN_ATTR_SPUR_AVERAGING_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether to enable averaging for the spurious emission (Spur) 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_SPUR_AVERAGING_ENABLED_FALSE.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetAveragingEnabled
Set Function: RFmxSpecAn_SpurSetAveragingEnabled
Values:
RFMXSPECAN_VAL_SPUR_AVERAGING_ENABLED_FALSE (0) The measurement is performed on a single acquisition.
RFMXSPECAN_VAL_SPUR_AVERAGING_ENABLED_TRUE (1) The Spur measurement uses the RFMXSPECAN_ATTR_SPUR_AVERAGING_COUNT attribute as the number of acquisitions over which the Spur measurement is averaged.

RFMXSPECAN_ATTR_SPUR_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_SPUR_AVERAGING_ENABLED attribute to RFMXSPECAN_VAL_SPUR_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.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetAveragingCount
Set Function: RFmxSpecAn_SpurSetAveragingCount

RFMXSPECAN_ATTR_SPUR_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 spurious emission (Spur) 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_SPUR_AVERAGING_TYPE_RMS.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetAveragingType
Set Function: RFmxSpecAn_SpurSetAveragingType
Values:
RFMXSPECAN_VAL_SPUR_AVERAGING_TYPE_RMS (0) The power spectrum is linearly averaged. RMS averaging reduces signal fluctuations but not the noise floor.
RFMXSPECAN_VAL_SPUR_AVERAGING_TYPE_LOG (1) The power spectrum is averaged in a logarithmic scale.
RFMXSPECAN_VAL_SPUR_AVERAGING_TYPE_SCALAR (2) The square root of the power spectrum is averaged.
RFMXSPECAN_VAL_SPUR_AVERAGING_TYPE_MAXIMUM (3) The peak power in the spectrum at each frequency bin is retained from one acquisition to the next.
RFMXSPECAN_VAL_SPUR_AVERAGING_TYPE_MINIMUM (4) The least power in the spectrum at each frequency bin is retained from one acquisition to the next.

Spur FFT

RFMXSPECAN_ATTR_SPUR_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_SPUR_FFT_WINDOW_FLAT_TOP.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetFFTWindow
Set Function: RFmxSpecAn_SpurSetFFTWindow
Values:
RFMXSPECAN_VAL_SPUR_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_SPUR_FFT_WINDOW_FLAT_TOP (1) Measures single-tone amplitudes accurately.
RFMXSPECAN_VAL_SPUR_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_SPUR_FFT_WINDOW_HAMMING (3) Analyzes closely-spaced sine waves.
RFMXSPECAN_VAL_SPUR_FFT_WINDOW_GAUSSIAN (4) Provides a balance of spectral leakage, frequency resolution, and amplitude attenuation. This windowing is useful for time-frequency analysis.
RFMXSPECAN_VAL_SPUR_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_SPUR_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_SPUR_FFT_WINDOW_KAISER_BESSEL (7) Separates two tones with frequencies close to each other but with widely-differing amplitudes.

RFMXSPECAN_ATTR_SPUR_TRACE_RANGE_INDEX

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the index of the range used to store and retrieve spurious emission (Spur) traces. This attribute is not used if you set the Spur All Traces Enabled Attribute to FALSE. When you set this attribute to -1, the measurement stores and retrieves traces for all enabled ranges.

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.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetTraceRangeIndex
Set Function: RFmxSpecAn_SpurSetTraceRangeIndex

RFMXSPECAN_ATTR_SPUR_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_SPUR_AMPLITUDE_CORRECTION_TYPE_RF_CENTER_FREQUENCY.

Get Function: RFmxSpecAn_SpurGetAmplitudeCorrectionType
Set Function: RFmxSpecAn_SpurSetAmplitudeCorrectionType
Values:
RFMXSPECAN_VAL_SPUR_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_SPUR_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_SPUR_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 spurious emissions (Spur) 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.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetAllTracesEnabled
Set Function: RFmxSpecAn_SpurSetAllTracesEnabled

RFMXSPECAN_ATTR_SPUR_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 spurious emission (Spur) 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.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetNumberOfAnalysisThreads
Set Function: RFmxSpecAn_SpurSetNumberOfAnalysisThreads

Spur Results

RFMXSPECAN_ATTR_SPUR_RESULTS_MEASUREMENT_STATUS

Data Type: int32
Access: read only
Functions: RFmxSpecAn_GetAttributeI32
Description: Indicates the overall measurement status.

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.

Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetResultsMeasurementStatus
Values:
RFMXSPECAN_VAL_SPUR_MEASUREMENT_STATUS_FAIL (0) A detected spur in the range is greater than the value of the Spur Results Spur Abs Limits attribute.
RFMXSPECAN_VAL_SPUR_MEASUREMENT_STATUS_PASS (1) All detected spurs in the range are lower than the value of the Spur Results Spur Abs Limit attribute.

Spur Results Range

RFMXSPECAN_ATTR_SPUR_RESULTS_RANGE_MEASUREMENT_STATUS

Data Type: int32
Access: read only
Functions: RFmxSpecAn_GetAttributeI32
Description: Indicates the measurement status for the frequency range.

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



Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetResultsRangeMeasurementStatus
Values:
RFMXSPECAN_VAL_SPUR_RANGE_STATUS_FAIL (0) The amplitude of the detected spurs is greater than the value of the RFMXSPECAN_ATTR_SPUR_RESULTS_RANGE_ABSOLUTE_LIMIT attribute.
RFMXSPECAN_VAL_SPUR_RANGE_STATUS_PASS (1) The amplitude of the detected spurs is lower than the value of the RFMXSPECAN_ATTR_SPUR_RESULTS_RANGE_ABSOLUTE_LIMIT attribute.

Spur Results Range Spur

RFMXSPECAN_ATTR_SPUR_RESULTS_RANGE_NUMBER_OF_DETECTED_SPURS

Data Type: int32
Access: read only
Functions: RFmxSpecAn_GetAttributeI32
Description: Returns the number of detected spurious emissions (Spur) in the specified frequency range.

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



Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetResultsRangeNumberOfDetectedSpurs

RFMXSPECAN_ATTR_SPUR_RESULTS_RANGE_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the frequency of the detected spurious emissions (Spur). This value is expressed in Hz.

Use 'range(n)/spur(k)' as the selector string to read this result.



Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetResultsRangeFrequency

RFMXSPECAN_ATTR_SPUR_RESULTS_RANGE_MARGIN

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the difference between the amplitude and the absolute limit of the detected spurious emissions (Spur) at the Spur frequency.

Use 'range(n)/spur(k)' as the selector string to read this result.



Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetResultsRangeMargin

RFMXSPECAN_ATTR_SPUR_RESULTS_RANGE_AMPLITUDE

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the amplitude of the detected spurious emissions (Spur). This value is expressed in dBm.

Use 'range(n)/spur(k)' as the selector string to read this result.



Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetResultsRangeAmplitude

RFMXSPECAN_ATTR_SPUR_RESULTS_RANGE_ABSOLUTE_LIMIT

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the threshold used to calculate the margin of the detected spurious emissions (Spur). This value is expressed in dBm. The measurement calculates the threshold using the absolute limit line specified by the RFMXSPECAN_ATTR_SPUR_RANGE_ABSOLUTE_LIMIT_MODE attribute.

Use 'range(n)/spur(k)' as the selector string to read this result.



Supported devices: PXIe-5665/5668

Get Function: RFmxSpecAn_SpurGetResultsRangeAbsoluteLimit
⚠️ **GitHub.com Fallback** ⚠️