Skip to content

NI RFmx SpecAn ACP Attributes

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

ACP Attributes

RFMXSPECAN_ATTR_ACP_MEASUREMENT_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether to enable the ACP 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_ACPGetMeasurementEnabled
Set Function: RFmxSpecAn_ACPSetMeasurementEnabled

Carrier

RFMXSPECAN_ATTR_ACP_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_ACPGetNumberOfCarriers
Set Function: RFmxSpecAn_ACPSetNumberOfCarriers

RFMXSPECAN_ATTR_ACP_CARRIER_MODE

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_ACP_CARRIER_MODE_ACTIVE.

Get Function: RFmxSpecAn_ACPGetCarrierMode
Set Function: RFmxSpecAn_ACPSetCarrierMode
Values:
RFMXSPECAN_VAL_ACP_CARRIER_MODE_PASSIVE (0) The carrier power is not considered as part of the total carrier power.
RFMXSPECAN_VAL_ACP_CARRIER_MODE_ACTIVE (1) The carrier power is considered as part of the total carrier power.

RFMXSPECAN_ATTR_ACP_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_ACPGetCarrierFrequency
Set Function: RFmxSpecAn_ACPSetCarrierFrequency

RFMXSPECAN_ATTR_ACP_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 1 MHz.

Get Function: RFmxSpecAn_ACPGetCarrierIntegrationBandwidth
Set Function: RFmxSpecAn_ACPSetCarrierIntegrationBandwidth

ACP RRC Filter

RFMXSPECAN_ATTR_ACP_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_ACP_CARRIER_RRC_FILTER_ENABLED_FALSE.

Get Function: RFmxSpecAn_ACPGetCarrierRRCFilterEnabled
Set Function: RFmxSpecAn_ACPSetCarrierRRCFilterEnabled
Values:
RFMXSPECAN_VAL_ACP_CARRIER_RRC_FILTER_ENABLED_FALSE (0) The channel power of the acquired carrier channel is measured directly.
RFMXSPECAN_VAL_ACP_CARRIER_RRC_FILTER_ENABLED_TRUE (1) The measurement applies the RRC filter on the acquired carrier channel before measuring the carrier channel power.

RFMXSPECAN_ATTR_ACP_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.

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



The default value is 0.1.

Get Function: RFmxSpecAn_ACPGetCarrierRRCFilterAlpha
Set Function: RFmxSpecAn_ACPSetCarrierRRCFilterAlpha

ACP Offset

RFMXSPECAN_ATTR_ACP_NUMBER_OF_OFFSETS

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

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_ACPGetNumberOfOffsets
Set Function: RFmxSpecAn_ACPSetNumberOfOffsets

RFMXSPECAN_ATTR_ACP_OFFSET_ENABLED

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

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



The default value is RFMXSPECAN_VAL_ACP_OFFSET_FREQUENCY_ENABLED_TRUE.

Get Function: RFmxSpecAn_ACPGetOffsetEnabled
Set Function: RFmxSpecAn_ACPSetOffsetEnabled
Values:
RFMXSPECAN_VAL_ACP_OFFSET_FREQUENCY_ENABLED_FALSE (0) Disables the offset channel for ACP measurement.
RFMXSPECAN_VAL_ACP_OFFSET_FREQUENCY_ENABLED_TRUE (1) Enables the offset channel for ACP measurement.

RFMXSPECAN_ATTR_ACP_OFFSET_FREQUENCY

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the center or edge frequency of the offset channel, relative to the center frequency of the closest carrier as determined by the RFMXSPECAN_ATTR_ACP_OFFSET_FREQUENCY_DEFINITION attribute. This value is expressed in Hz. The sign of offset frequency is ignored and the RFMXSPECAN_ATTR_ACP_OFFSET_SIDEBAND attribute determines whether the upper, lower, or both offsets are measured.

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



The default value is 1 MHz.

Get Function: RFmxSpecAn_ACPGetOffsetFrequency
Set Function: RFmxSpecAn_ACPSetOffsetFrequency

RFMXSPECAN_ATTR_ACP_OFFSET_SIDEBAND

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether the offset channel 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_ACP_OFFSET_SIDEBAND_BOTH.

Get Function: RFmxSpecAn_ACPGetOffsetSideband
Set Function: RFmxSpecAn_ACPSetOffsetSideband
Values:
RFMXSPECAN_VAL_ACP_OFFSET_SIDEBAND_NEGATIVE (0) Configures a lower offset segment to the left of the leftmost carrier.
RFMXSPECAN_VAL_ACP_OFFSET_SIDEBAND_POSITIVE (1) Configures an upper offset segment to the right of the rightmost carrier.
RFMXSPECAN_VAL_ACP_OFFSET_SIDEBAND_BOTH (2) Configures both negative and positive offset segments.

ACP Offset Power Reference

RFMXSPECAN_ATTR_ACP_OFFSET_POWER_REFERENCE_CARRIER

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the carrier to be used as power reference to measure the offset channel relative power. The offset channel power is measured only if you set the RFMXSPECAN_ATTR_ACP_CARRIER_MODE attribute of the reference carrier to RFMXSPECAN_VAL_ACP_CARRIER_MODE_ACTIVE.

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



The default value is RFMXSPECAN_VAL_ACP_OFFSET_POWER_REFERENCE_CARRIER_CLOSEST.

Get Function: RFmxSpecAn_ACPGetOffsetPowerReferenceCarrier
Set Function: RFmxSpecAn_ACPSetOffsetPowerReferenceCarrier
Values:
RFMXSPECAN_VAL_ACP_OFFSET_POWER_REFERENCE_CARRIER_CLOSEST (0) The measurement uses the power measured in the carrier closest to the offset channel center frequency, as the power reference.
RFMXSPECAN_VAL_ACP_OFFSET_POWER_REFERENCE_CARRIER_HIGHEST (1) The measurement uses the highest power measured among all the active carriers as the power reference.
RFMXSPECAN_VAL_ACP_OFFSET_POWER_REFERENCE_CARRIER_COMPOSITE (2) The measurement uses the sum of powers measured in all the active carriers as the power reference.
RFMXSPECAN_VAL_ACP_OFFSET_POWER_REFERENCE_CARRIER_SPECIFIC (3) The measurement uses the power measured in the carrier that has an index specified by the RFMXSPECAN_ATTR_ACP_OFFSET_POWER_REFERENCE_SPECIFIC attribute, as the power reference.

RFMXSPECAN_ATTR_ACP_OFFSET_POWER_REFERENCE_SPECIFIC

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the index of the carrier to be used as the reference carrier. The power measured in this carrier is used as the power reference for measuring the offset channel relative power, when you set the RFMXSPECAN_ATTR_ACP_OFFSET_POWER_REFERENCE_CARRIER attribute to RFMXSPECAN_VAL_ACP_OFFSET_POWER_REFERENCE_CARRIER_SPECIFIC.

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



The default value is 0.

Get Function: RFmxSpecAn_ACPGetOffsetPowerReferenceSpecific
Set Function: RFmxSpecAn_ACPSetOffsetPowerReferenceSpecific

RFMXSPECAN_ATTR_ACP_OFFSET_INTEGRATION_BANDWIDTH

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the frequency range, over which the measurement integrates the offset channel power. 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_ACPGetOffsetIntegrationBandwidth
Set Function: RFmxSpecAn_ACPSetOffsetIntegrationBandwidth

RFMXSPECAN_ATTR_ACP_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 ACP Offset Rel Attn attribute to compensate for variations in external attenuation when the offset channels 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_ACPGetOffsetRelativeAttenuation
Set Function: RFmxSpecAn_ACPSetOffsetRelativeAttenuation

ACP Offset RRC Filter

RFMXSPECAN_ATTR_ACP_OFFSET_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 offset channel before measuring the offset channel power.

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



The default value is RFMXSPECAN_VAL_ACP_OFFSET_RRC_FILTER_ENABLED_FALSE.

Get Function: RFmxSpecAn_ACPGetOffsetRRCFilterEnabled
Set Function: RFmxSpecAn_ACPSetOffsetRRCFilterEnabled
Values:
RFMXSPECAN_VAL_ACP_OFFSET_RRC_FILTER_ENABLED_FALSE (0) The channel power of the acquired offset channel is measured directly.
RFMXSPECAN_VAL_ACP_OFFSET_RRC_FILTER_ENABLED_TRUE (1) The measurement applies the RRC filter on the acquired offset channel before measuring the offset channel power.

RFMXSPECAN_ATTR_ACP_OFFSET_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.

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



The default value is 0.1.

Get Function: RFmxSpecAn_ACPGetOffsetRRCFilterAlpha
Set Function: RFmxSpecAn_ACPSetOffsetRRCFilterAlpha

RFMXSPECAN_ATTR_ACP_OFFSET_FREQUENCY_DEFINITION

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the offset frequency definition used to specify the RFMXSPECAN_ATTR_ACP_OFFSET_FREQUENCY attribute.

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



The default value is RFMXSPECAN_VAL_ACP_CARRIER_CENTER_TO_OFFSET_CENTER.

Get Function: RFmxSpecAn_ACPGetOffsetFrequencyDefinition
Set Function: RFmxSpecAn_ACPSetOffsetFrequencyDefinition
Values:
RFMXSPECAN_VAL_ACP_CARRIER_CENTER_TO_OFFSET_CENTER (0) The offset frequency is defined from the center of the closest carrier to the center of the offset channel.
RFMXSPECAN_VAL_ACP_CARRIER_CENTER_TO_OFFSET_EDGE (1) The offset frequency is defined from the center of the closest carrier to the nearest edge of the offset channel.

ACP RBW Filter

RFMXSPECAN_ATTR_ACP_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).

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_ACP_RBW_AUTO_TRUE.

Get Function: RFmxSpecAn_ACPGetRBWFilterAutoBandwidth
Set Function: RFmxSpecAn_ACPSetRBWFilterAutoBandwidth
Values:
RFMXSPECAN_VAL_ACP_RBW_AUTO_FALSE (0) The measurement uses the RBW that you specify in the RFMXSPECAN_ATTR_ACP_RBW_FILTER_BANDWIDTH attribute.
RFMXSPECAN_VAL_ACP_RBW_AUTO_TRUE (1) The measurement computes the RBW.

RFMXSPECAN_ATTR_ACP_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_ACP_RBW_FILTER_AUTO_BANDWIDTH attribute to RFMXSPECAN_VAL_ACP_RBW_AUTO_FALSE. This value is expressed in Hz.

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 kHz.

Get Function: RFmxSpecAn_ACPGetRBWFilterBandwidth
Set Function: RFmxSpecAn_ACPSetRBWFilterBandwidth

RFMXSPECAN_ATTR_ACP_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.

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_ACP_RBW_FILTER_TYPE_GAUSSIAN.

Get Function: RFmxSpecAn_ACPGetRBWFilterType
Set Function: RFmxSpecAn_ACPSetRBWFilterType
Values:
RFMXSPECAN_VAL_ACP_RBW_FILTER_TYPE_FFT_BASED (0) No RBW filtering is performed.
RFMXSPECAN_VAL_ACP_RBW_FILTER_TYPE_GAUSSIAN (1) An RBW filter with a Gaussian response is applied.
RFMXSPECAN_VAL_ACP_RBW_FILTER_TYPE_FLAT (2) An RBW filter with a flat response is applied.

RFMXSPECAN_ATTR_ACP_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_ACP_RBW_FILTER_BANDWIDTH attribute.

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_ACP_RBW_FILTER_BANDWIDTH_DEFINITION_3DB.

Get Function: RFmxSpecAn_ACPGetRBWFilterBandwidthDefinition
Set Function: RFmxSpecAn_ACPSetRBWFilterBandwidthDefinition
Values:
RFMXSPECAN_VAL_ACP_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_ACP_RBW_FILTER_TYPE attribute to RFMXSPECAN_VAL_ACP_RBW_FILTER_TYPE_FFT_BASED, RBW is the 3dB bandwidth of the window specified by the RFMXSPECAN_ATTR_ACP_FFT_WINDOW attribute.
RFMXSPECAN_VAL_ACP_RBW_FILTER_BANDWIDTH_DEFINITION_BIN_WIDTH (2) Defines the RBW in terms of the bin width of the spectrum computed using FFT when you set the RFMXSPECAN_ATTR_ACP_RBW_FILTER_TYPE attribute to FFT Based.

ACP Sweep Time

RFMXSPECAN_ATTR_ACP_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_ACP_SWEEP_TIME_AUTO_TRUE.

Get Function: RFmxSpecAn_ACPGetSweepTimeAuto
Set Function: RFmxSpecAn_ACPSetSweepTimeAuto
Values:
RFMXSPECAN_VAL_ACP_SWEEP_TIME_AUTO_FALSE (0) The measurement uses the sweep time that you specify in the RFMXSPECAN_ATTR_ACP_SWEEP_TIME_INTERVAL attribute.
RFMXSPECAN_VAL_ACP_SWEEP_TIME_AUTO_TRUE (1) The measurement calculates the sweep time based on the value of the RFMXSPECAN_ATTR_ACP_RBW_FILTER_BANDWIDTH attribute.

RFMXSPECAN_ATTR_ACP_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_ACP_SWEEP_TIME_AUTO attribute to RFMXSPECAN_VAL_ACP_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_ACPGetSweepTimeInterval
Set Function: RFmxSpecAn_ACPSetSweepTimeInterval

RFMXSPECAN_ATTR_ACP_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_ACP_POWER_UNITS_DBM_PER_HZ.

Get Function: RFmxSpecAn_ACPGetPowerUnits
Set Function: RFmxSpecAn_ACPSetPowerUnits
Values:
RFMXSPECAN_VAL_ACP_POWER_UNITS_DBM (0) The absolute powers are reported in dBm.
RFMXSPECAN_VAL_ACP_POWER_UNITS_DBM_PER_HZ (1) The absolute powers are reported in dBm/Hz.

RFMXSPECAN_ATTR_ACP_MEASUREMENT_METHOD

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the method for performing the ACP 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_ACP_MEASUREMENT_METHOD_NORMAL.

Get Function: RFmxSpecAn_ACPGetMeasurementMethod
Set Function: RFmxSpecAn_ACPSetMeasurementMethod
Values:
RFMXSPECAN_VAL_ACP_MEASUREMENT_METHOD_NORMAL (0) The ACP measurement acquires the spectrum using the same signal analyzer setting across frequency bands. Use this method when measurement speed is desirable over higher dynamic range.
RFMXSPECAN_VAL_ACP_MEASUREMENT_METHOD_DYNAMIC_RANGE (1) The ACP measurement acquires the spectrum using the hardware-specific optimizations for different frequency bands. Use this method to get the best dynamic range. Supported devices: PXIe-5665/5668
RFMXSPECAN_VAL_ACP_MEASUREMENT_METHOD_SEQUENTIAL_FFT (2) The ACP measurement acquires I/Q samples for a duration specified by the RFMXSPECAN_ATTR_ACP_SWEEP_TIME_INTERVAL attribute. These samples are divided into smaller chunks. The size of each chunk is defined by the RFMXSPECAN_ATTR_ACP_SEQUENTIAL_FFT_SIZE attribute. The overlap between the chunks is defined by the RFMXSPECAN_ATTR_ACP_FFT_OVERLAP_MODE attribute. FFT is computed on each of these chunks. The resultant FFTs are averaged to get the spectrum and is used to compute ACP. If the total acquired samples is not an integer multiple of the FFT size, the remaining samples at the end of acquisition are not used for the measurement. Use this method to optimize ACP measurement speed. Accuracy of the results may be reduced when using this measurement method.

ACP Noise Calibration

RFMXSPECAN_ATTR_ACP_NOISE_CALIBRATION_MODE

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether the noise calibration and measurement is performed manually by the user or automatically by RFmx. Refer to the measurement guidelines section in the Noise Compensation Algorithm topic for more information.

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_ACP_NOISE_CALIBRATION_MODE_AUTO.

Get Function: RFmxSpecAn_ACPGetNoiseCalibrationMode
Set Function: RFmxSpecAn_ACPSetNoiseCalibrationMode
Values:
RFMXSPECAN_VAL_ACP_NOISE_CALIBRATION_MODE_MANUAL (0) When you set the RFMXSPECAN_ATTR_ACP_MEASUREMENT_MODE attribute to RFMXSPECAN_VAL_ACP_MEASUREMENT_MODE_CALIBRATE_NOISE_FLOOR, you can initiate instrument noise calibration for the ACP measurement manually. When you set the RFMXSPECAN_ATTR_ACP_MEASUREMENT_MODE attribute to RFMXSPECAN_VAL_ACP_MEASUREMENT_MODE_MEASURE, you can initiate the ACP measurement manually.
RFMXSPECAN_VAL_ACP_NOISE_CALIBRATION_MODE_AUTO (1) When you set the RFMXSPECAN_ATTR_ACP_NOISE_COMPENSATION_ENABLED to RFMXSPECAN_VAL_ACP_NOISE_COMPENSATION_ENABLED_TRUE, RFmx sets the Input Isolation Enabled attribute to Enabled and calibrates the instrument noise in the current state of the instrument. RFmx then resets the Input Isolation Enabled attribute and performs the ACP measurement, including compensation for noise of the instrument. RFmx skips noise calibration in this mode if valid noise calibration data is already cached. When you set the RFMXSPECAN_ATTR_ACP_NOISE_COMPENSATION_ENABLED attribute to RFMXSPECAN_VAL_ACP_NOISE_COMPENSATION_ENABLED_FALSE, RFmx does not calibrate instrument noise and only performs the ACP measurement without compensating for noise of the instrument.

RFMXSPECAN_ATTR_ACP_NOISE_CALIBRATION_AVERAGING_AUTO

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether RFmx automatically computes the averaging count used for instrument noise calibration.

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_ACP_NOISE_CALIBRATION_AVERAGING_AUTO_TRUE.

Get Function: RFmxSpecAn_ACPGetNoiseCalibrationAveragingAuto
Set Function: RFmxSpecAn_ACPSetNoiseCalibrationAveragingAuto
Values:
RFMXSPECAN_VAL_ACP_NOISE_CALIBRATION_AVERAGING_AUTO_FALSE (0) RFmx uses the averages that you set for the RFMXSPECAN_ATTR_ACP_NOISE_CALIBRATION_AVERAGING_COUNT attribute.
RFMXSPECAN_VAL_ACP_NOISE_CALIBRATION_AVERAGING_AUTO_TRUE (1) When you set the RFMXSPECAN_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXSPECAN_VAL_ACP_MEASUREMENT_METHOD_NORMAL, RFmx uses a noise calibration averaging count of 32. When you set the RFMXSPECAN_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXSPECAN_VAL_ACP_MEASUREMENT_METHOD_DYNAMIC_RANGE and the sweep time is less than 5 ms, RFmx uses a noise calibration averaging count of 15. When you set the RFMXSPECAN_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXSPECAN_VAL_ACP_MEASUREMENT_METHOD_DYNAMIC_RANGE and the sweep time is greater than or equal to 5 ms, RFmx uses a noise calibration averaging count of 5.

RFMXSPECAN_ATTR_ACP_NOISE_CALIBRATION_AVERAGING_COUNT

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the averaging count used for noise calibration when you set the RFMXSPECAN_ATTR_ACP_NOISE_CALIBRATION_AVERAGING_AUTO attribute to RFMXSPECAN_VAL_ACP_NOISE_CALIBRATION_AVERAGING_AUTO_FALSE.

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 32.

Get Function: RFmxSpecAn_ACPGetNoiseCalibrationAveragingCount
Set Function: RFmxSpecAn_ACPSetNoiseCalibrationAveragingCount

ACP Noise Compensation

RFMXSPECAN_ATTR_ACP_NOISE_COMPENSATION_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether RFmx compensates for the instrument noise while performing the measurement when you set the RFMXSPECAN_ATTR_ACP_NOISE_CALIBRATION_MODE attribute to RFMXSPECAN_VAL_ACP_NOISE_CALIBRATION_MODE_AUTO, or when you set the RFMXSPECAN_ATTR_ACP_NOISE_CALIBRATION_MODE attribute to RFMXSPECAN_VAL_ACP_NOISE_CALIBRATION_MODE_MANUAL and RFMXSPECAN_ATTR_ACP_MEASUREMENT_MODE to RFMXSPECAN_VAL_ACP_MEASUREMENT_MODE_MEASURE. Refer to the Noise Compensation Algorithm topic for more information.

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_ACP_NOISE_COMPENSATION_ENABLED_FALSE.

Get Function: RFmxSpecAn_ACPGetNoiseCompensationEnabled
Set Function: RFmxSpecAn_ACPSetNoiseCompensationEnabled
Values:
RFMXSPECAN_VAL_ACP_NOISE_COMPENSATION_ENABLED_FALSE (0) Disables noise compensation.
RFMXSPECAN_VAL_ACP_NOISE_COMPENSATION_ENABLED_TRUE (1) Enables noise compensation.

RFMXSPECAN_ATTR_ACP_NOISE_COMPENSATION_TYPE

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the noise compensation type. Refer to the Noise Compensation Algorithm topic for more information.

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_ACP_NOISE_COMPENSATION_TYPE_ANALYZER_AND_TERMINATION.

Get Function: RFmxSpecAn_ACPGetNoiseCompensationType
Set Function: RFmxSpecAn_ACPSetNoiseCompensationType
Values:
RFMXSPECAN_VAL_ACP_NOISE_COMPENSATION_TYPE_ANALYZER_AND_TERMINATION (0) Compensates for noise from the analyzer and the 50-ohm termination. The measured power values are in excess of the thermal noise floor.
RFMXSPECAN_VAL_ACP_NOISE_COMPENSATION_TYPE_ANALYZER_ONLY (1) Compensates for the analyzer noise only.

ACP Averaging

RFMXSPECAN_ATTR_ACP_AVERAGING_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether to enable averaging for the ACP 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_ACP_AVERAGING_ENABLED_FALSE.

Get Function: RFmxSpecAn_ACPGetAveragingEnabled
Set Function: RFmxSpecAn_ACPSetAveragingEnabled
Values:
RFMXSPECAN_VAL_ACP_AVERAGING_ENABLED_FALSE (0) The measurement is performed on a single acquisition.
RFMXSPECAN_VAL_ACP_AVERAGING_ENABLED_TRUE (1) The ACP measurement uses the RFMXSPECAN_ATTR_ACP_AVERAGING_COUNT attribute as the number of acquisitions over which the ACP measurement is averaged.

RFMXSPECAN_ATTR_ACP_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_ACP_AVERAGING_ENABLED attribute to RFMXSPECAN_VAL_ACP_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_ACPGetAveragingCount
Set Function: RFmxSpecAn_ACPSetAveragingCount

RFMXSPECAN_ATTR_ACP_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 ACP 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_ACP_AVERAGING_TYPE_RMS.

Get Function: RFmxSpecAn_ACPGetAveragingType
Set Function: RFmxSpecAn_ACPSetAveragingType
Values:
RFMXSPECAN_VAL_ACP_AVERAGING_TYPE_RMS (0) The power spectrum is linearly averaged. RMS averaging reduces signal fluctuations but not the noise floor.
RFMXSPECAN_VAL_ACP_AVERAGING_TYPE_LOG (1) The power spectrum is averaged in a logarithmic scale.
RFMXSPECAN_VAL_ACP_AVERAGING_TYPE_SCALAR (2) The square root of the power spectrum is averaged.
RFMXSPECAN_VAL_ACP_AVERAGING_TYPE_MAXIMUM (3) The peak power in the spectrum at each frequency bin is retained from one acquisition to the next.
RFMXSPECAN_VAL_ACP_AVERAGING_TYPE_MINIMUM (4) The least power in the spectrum at each frequency bin is retained from one acquisition to the next.

ACP FFT

RFMXSPECAN_ATTR_ACP_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_ACP_FFT_WINDOW_FLAT_TOP.

Get Function: RFmxSpecAn_ACPGetFFTWindow
Set Function: RFmxSpecAn_ACPSetFFTWindow
Values:
RFMXSPECAN_VAL_ACP_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_ACP_FFT_WINDOW_FLAT_TOP (1) Measures single-tone amplitudes accurately.
RFMXSPECAN_VAL_ACP_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_ACP_FFT_WINDOW_HAMMING (3) Analyzes closely-spaced sine waves.
RFMXSPECAN_VAL_ACP_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_ACP_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_ACP_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_ACP_FFT_WINDOW_KAISER_BESSEL (7) Separates two tones with frequencies close to each other but with widely-differing amplitudes.

RFMXSPECAN_ATTR_ACP_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 fast Fourier transform (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_ACPGetFFTPadding
Set Function: RFmxSpecAn_ACPSetFFTPadding

RFMXSPECAN_ATTR_ACP_FFT_OVERLAP_MODE

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the overlap mode when you set the RFMXSPECAN_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXSPECAN_VAL_ACP_MEASUREMENT_METHOD_SEQUENTIAL_FFT.

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_ACP_FFT_OVERLAP_MODE_DISABLED.

Get Function: RFmxSpecAn_ACPGetFFTOverlapMode
Set Function: RFmxSpecAn_ACPSetFFTOverlapMode
Values:
RFMXSPECAN_VAL_ACP_FFT_OVERLAP_MODE_DISABLED (0) Disables the overlap between the chunks.
RFMXSPECAN_VAL_ACP_FFT_OVERLAP_MODE_AUTOMATIC (1) Measurement sets the overlap based on the value you have set for the RFMXSPECAN_ATTR_ACP_FFT_WINDOW attribute. When you set the RFMXSPECAN_ATTR_ACP_FFT_WINDOW attribute to any value other than RFMXSPECAN_VAL_ACP_FFT_WINDOW_NONE, the number of overlapped samples between consecutive chunks is set to 50% of the value of the RFMXSPECAN_ATTR_ACP_SEQUENTIAL_FFT_SIZE attribute. When you set the RFMXSPECAN_ATTR_ACP_FFT_WINDOW attribute to RFMXSPECAN_VAL_ACP_FFT_WINDOW_NONE, the chunks are not overlapped and the overlap is set to 0%.
RFMXSPECAN_VAL_ACP_FFT_OVERLAP_MODE_USER_DEFINED (2) Measurement uses the overlap that you specify in the RFMXSPECAN_ATTR_ACP_FFT_OVERLAP attribute.

RFMXSPECAN_ATTR_ACP_FFT_OVERLAP

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the samples to overlap between the consecutive chunks as a percentage of the RFMXSPECAN_ATTR_ACP_SEQUENTIAL_FFT_SIZE attribute when you set the RFMXSPECAN_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXSPECAN_VAL_ACP_MEASUREMENT_METHOD_SEQUENTIAL_FFT and the RFMXSPECAN_ATTR_ACP_FFT_OVERLAP_MODE attribute to RFMXSPECAN_VAL_ACP_FFT_OVERLAP_MODE_USER_DEFINED. This value is expressed as a percentage.

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.

Get Function: RFmxSpecAn_ACPGetFFTOverlap
Set Function: RFmxSpecAn_ACPSetFFTOverlap

RFMXSPECAN_ATTR_ACP_MEASUREMENT_MODE

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether the measurement calibrates the noise floor of analyzer or performs the ACP measurement. Refer to the measurement guidelines section in the Noise Compensation Algorithm topic for more information.

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_ACP_MEASUREMENT_MODE_MEASURE.

Get Function: RFmxSpecAn_ACPGetMeasurementMode
Set Function: RFmxSpecAn_ACPSetMeasurementMode
Values:
RFMXSPECAN_VAL_ACP_MEASUREMENT_MODE_MEASURE (0) ACP measurement is performed on the acquired signal.
RFMXSPECAN_VAL_ACP_MEASUREMENT_MODE_CALIBRATE_NOISE_FLOOR (1) Manual noise calibration of the signal analyzer is performed for the ACP measurement.

ACP Advanced

RFMXSPECAN_ATTR_ACP_IF_OUTPUT_POWER_OFFSET_AUTO

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies whether the measurement computes an IF output power level offset for the offset channels to improve the dynamic range of the ACP measurement. This attribute is used only if you set the RFMXSPECAN_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXSPECAN_VAL_ACP_MEASUREMENT_METHOD_DYNAMIC_RANGE.

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_ACP_IF_OUTPUT_POWER_OFFSET_AUTO_TRUE.

Get Function: RFmxSpecAn_ACPGetIFOutputPowerOffsetAuto
Set Function: RFmxSpecAn_ACPSetIFOutputPowerOffsetAuto
Values:
RFMXSPECAN_VAL_ACP_IF_OUTPUT_POWER_OFFSET_AUTO_FALSE (0) The measurement sets the IF output power level offset using the values of the RFMXSPECAN_ATTR_ACP_NEAR_IF_OUTPUT_POWER_OFFSET and RFMXSPECAN_ATTR_ACP_FAR_IF_OUTPUT_POWER_OFFSET attributes.
RFMXSPECAN_VAL_ACP_IF_OUTPUT_POWER_OFFSET_AUTO_TRUE (1) The measurement automatically computes an IF output power level offset for the offset channels to improve the dynamic range of the ACP measurement.

RFMXSPECAN_ATTR_ACP_NEAR_IF_OUTPUT_POWER_OFFSET

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the offset by which to adjust the IF output power level for offset channels that are near to the carrier channel to improve the dynamic range. This value is expressed in dB. This attribute is used only if you set the RFMXSPECAN_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXSPECAN_VAL_ACP_MEASUREMENT_METHOD_DYNAMIC_RANGE and set the RFMXSPECAN_ATTR_ACP_IF_OUTPUT_POWER_OFFSET_AUTO attribute to RFMXSPECAN_VAL_ACP_IF_OUTPUT_POWER_OFFSET_AUTO_FALSE.

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 dB.

Get Function: RFmxSpecAn_ACPGetNearIFOutputPowerOffset
Set Function: RFmxSpecAn_ACPSetNearIFOutputPowerOffset

RFMXSPECAN_ATTR_ACP_FAR_IF_OUTPUT_POWER_OFFSET

Data Type: float64
Access: read/write
Functions: RFmxSpecAn_SetAttributeF64
RFmxSpecAn_GetAttributeF64
Description: Specifies the offset by which to adjust the IF output power level for offset channels that are far from the carrier channel to improve the dynamic range. This value is expressed in dB. This attribute is used only if you set the RFMXSPECAN_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXSPECAN_VAL_ACP_MEASUREMENT_METHOD_DYNAMIC_RANGE and set the RFMXSPECAN_ATTR_ACP_IF_OUTPUT_POWER_OFFSET_AUTO attribute to RFMXSPECAN_VAL_ACP_IF_OUTPUT_POWER_OFFSET_AUTO_FALSE.

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 20 dB.

Get Function: RFmxSpecAn_ACPGetFarIFOutputPowerOffset
Set Function: RFmxSpecAn_ACPSetFarIFOutputPowerOffset

RFMXSPECAN_ATTR_ACP_SEQUENTIAL_FFT_SIZE

Data Type: int32
Access: read/write
Functions: RFmxSpecAn_SetAttributeI32
RFmxSpecAn_GetAttributeI32
Description: Specifies the FFT size when you set the RFMXSPECAN_ATTR_ACP_MEASUREMENT_METHOD attribute to RFMXSPECAN_VAL_ACP_MEASUREMENT_METHOD_SEQUENTIAL_FFT.



The default value is 512.

Get Function: RFmxSpecAn_ACPGetSequentialFFTSize
Set Function: RFmxSpecAn_ACPSetSequentialFFTSize

RFMXSPECAN_ATTR_ACP_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_ACP_AMPLITUDE_CORRECTION_TYPE_RF_CENTER_FREQUENCY.

Get Function: RFmxSpecAn_ACPGetAmplitudeCorrectionType
Set Function: RFmxSpecAn_ACPSetAmplitudeCorrectionType
Values:
RFMXSPECAN_VAL_ACP_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_ACP_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_ACP_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 ACP 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_ACPGetAllTracesEnabled
Set Function: RFmxSpecAn_ACPSetAllTracesEnabled

RFMXSPECAN_ATTR_ACP_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 adjacent channel power (ACP) 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_ACPGetNumberOfAnalysisThreads
Set Function: RFmxSpecAn_ACPSetNumberOfAnalysisThreads

ACP Results

RFMXSPECAN_ATTR_ACP_RESULTS_TOTAL_CARRIER_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the total integrated power, in dBm, of all the active carriers measured when you set the RFMXSPECAN_ATTR_ACP_POWER_UNITS attribute to RFMXSPECAN_VAL_ACP_POWER_UNITS_DBM.

Returns the power spectral density, in dBm/Hz, based on the power in all the active carriers measured when you set the RFMXSPECAN_ATTR_ACP_POWER_UNITS attribute to RFMXSPECAN_VAL_ACP_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_ACPGetResultsTotalCarrierPower

RFMXSPECAN_ATTR_ACP_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_ACPGetResultsFrequencyResolution

ACP Results Carrier

RFMXSPECAN_ATTR_ACP_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_ACPGetResultsCarrierFrequency

RFMXSPECAN_ATTR_ACP_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_ACPGetResultsCarrierIntegrationBandwidth

RFMXSPECAN_ATTR_ACP_RESULTS_CARRIER_ABSOLUTE_POWER

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

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

The carrier power is reported in dBm when you set the RFMXSPECAN_ATTR_ACP_POWER_UNITS attribute to RFMXSPECAN_VAL_ACP_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXSPECAN_ATTR_ACP_POWER_UNITS attribute to RFMXSPECAN_VAL_ACP_POWER_UNITS_DBM_PER_HZ.

Get Function: RFmxSpecAn_ACPGetResultsCarrierAbsolutePower

RFMXSPECAN_ATTR_ACP_RESULTS_CARRIER_TOTAL_RELATIVE_POWER

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

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



Get Function: RFmxSpecAn_ACPGetResultsCarrierTotalRelativePower

ACP Results Lower Offset

RFMXSPECAN_ATTR_ACP_RESULTS_LOWER_OFFSET_FREQUENCY_REFERENCE_CARRIER

Data Type: int32
Access: read only
Functions: RFmxSpecAn_GetAttributeI32
Description: Returns the index of the carrier used as a reference to define the center frequency of the lower (negative) offset channel. Lower offset channels are channels that are to the left of the carrier.

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



Get Function: RFmxSpecAn_ACPGetResultsLowerOffsetFrequencyReferenceCarrier

RFMXSPECAN_ATTR_ACP_RESULTS_LOWER_OFFSET_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the center frequency of the lower offset channel relative to the center frequency of the closest carrier. The offset frequency has a negative value.

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



Get Function: RFmxSpecAn_ACPGetResultsLowerOffsetFrequency

RFMXSPECAN_ATTR_ACP_RESULTS_LOWER_OFFSET_INTEGRATION_BANDWIDTH

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the integration bandwidth used to measure the power in the lower offset channel.

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



Get Function: RFmxSpecAn_ACPGetResultsLowerOffsetIntegrationBandwidth

RFMXSPECAN_ATTR_ACP_RESULTS_LOWER_OFFSET_POWER_REFERENCE_CARRIER

Data Type: int32
Access: read only
Functions: RFmxSpecAn_GetAttributeI32
Description: Returns the index of the carrier used as the power reference to measure the lower (negative) offset channel relative power.

A value of -1 indicates that the total power of all active carriers is used as the reference power. The measurement uses the RFMXSPECAN_ATTR_ACP_OFFSET_POWER_REFERENCE_CARRIER attribute to set the power reference.

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

Get Function: RFmxSpecAn_ACPGetResultsLowerOffsetPowerReferenceCarrier

RFMXSPECAN_ATTR_ACP_RESULTS_LOWER_OFFSET_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the lower offset channel power.

The offset channel power is reported in dBm when you set the RFMXSPECAN_ATTR_ACP_POWER_UNITS attribute to RFMXSPECAN_VAL_ACP_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXSPECAN_ATTR_ACP_POWER_UNITS attribute to RFMXSPECAN_VAL_ACP_POWER_UNITS_DBM_PER_HZ.

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

Get Function: RFmxSpecAn_ACPGetResultsLowerOffsetAbsolutePower

RFMXSPECAN_ATTR_ACP_RESULTS_LOWER_OFFSET_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the lower offset channel power measured relative to the integrated power of the power reference carrier. This value is expressed in dB.

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



Get Function: RFmxSpecAn_ACPGetResultsLowerOffsetRelativePower

ACP Results Upper Offset

RFMXSPECAN_ATTR_ACP_RESULTS_UPPER_OFFSET_FREQUENCY_REFERENCE_CARRIER

Data Type: int32
Access: read only
Functions: RFmxSpecAn_GetAttributeI32
Description: Returns the index of the carrier used as a reference to define the center frequency of the upper (positive) offset channel. Upper offset channels are channels that are to the right of the carrier.

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



Get Function: RFmxSpecAn_ACPGetResultsUpperOffsetFrequencyReferenceCarrier

RFMXSPECAN_ATTR_ACP_RESULTS_UPPER_OFFSET_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the center frequency of the upper offset channel relative to the center frequency of the closest carrier. The offset frequency has a positive value.

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



Get Function: RFmxSpecAn_ACPGetResultsUpperOffsetFrequency

RFMXSPECAN_ATTR_ACP_RESULTS_UPPER_OFFSET_INTEGRATION_BANDWIDTH

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the integration bandwidth used to measure the power in the upper offset channel.

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



Get Function: RFmxSpecAn_ACPGetResultsUpperOffsetIntegrationBandwidth

RFMXSPECAN_ATTR_ACP_RESULTS_UPPER_OFFSET_POWER_REFERENCE_CARRIER

Data Type: int32
Access: read only
Functions: RFmxSpecAn_GetAttributeI32
Description: Returns the index of the carrier used as the power reference to measure the upper (positive) offset channel relative power.

A value of -1 indicates that the total power of all active carriers is used as the reference power. The measurement uses the RFMXSPECAN_ATTR_ACP_OFFSET_POWER_REFERENCE_CARRIER attribute to set the power reference.

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

Get Function: RFmxSpecAn_ACPGetResultsUpperOffsetPowerReferenceCarrier

RFMXSPECAN_ATTR_ACP_RESULTS_UPPER_OFFSET_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the upper offset channel power.

The offset channel power is reported in dBm when you set the RFMXSPECAN_ATTR_ACP_POWER_UNITS attribute to RFMXSPECAN_VAL_ACP_POWER_UNITS_DBM, and in dBm/Hz when you set the RFMXSPECAN_ATTR_ACP_POWER_UNITS attribute to RFMXSPECAN_VAL_ACP_POWER_UNITS_DBM_PER_HZ.

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

Get Function: RFmxSpecAn_ACPGetResultsUpperOffsetAbsolutePower

RFMXSPECAN_ATTR_ACP_RESULTS_UPPER_OFFSET_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxSpecAn_GetAttributeF64
Description: Returns the upper offset channel power measured relative to the integrated power of the power reference carrier. This value is expressed in dB.

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



Get Function: RFmxSpecAn_ACPGetResultsUpperOffsetRelativePower

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