RFmxSpecAnMXAcpConfiguration Class
- Updated2025-10-13
- 10 minute(s) read
Provides methods to configure the ACP measurement.
Derives from
Syntax
Namespace: NationalInstruments.RFmx.SpecAnMX
public class RFmxSpecAnMXAcpConfiguration : RFmxSpecAnMXSubObject
Remarks
For more information about RFmx SpecAn, refer to the RFmx SpecAn Help.
Thread Safety
Any public static members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Methods
| Name | Description |
|---|---|
| ConfigureAveraging(string, RFmxSpecAnMXAcpAveragingEnabled, int, RFmxSpecAnMXAcpAveragingType) | Configures averaging for the adjacent channel power (ACP) measurement. |
| ConfigureCarrierAndOffsets(string, double, int, double) | Configures a carrier channel with offset channels on both sides of the carrier as specified by the number of offsets. The offset channels are separated by +/- (n*channel) spacing from the center of the carrier. Power is measured over the integration bandwidth for each channel. |
| ConfigureCarrierFrequency(string, double) | Configures the center frequency, in hertz (Hz), of the carrier, relative to the value of the GetCenterFrequency(string, out double) method. |
| ConfigureCarrierIntegrationBandwidth(string, double) | Configures the frequency range, in hertz (Hz), over which the measurement integrates the carrier power. |
| ConfigureCarrierMode(string, RFmxSpecAnMXAcpCarrierMode) | Configures whether to consider the carrier power as part of total carrier power measurement. |
| ConfigureCarrierRrcFilter(string, RFmxSpecAnMXAcpCarrierRrcFilterEnabled, double) | Configures the root-raised-cosine (RRC) filter to apply on the carrier channel before measuring the carrier channel power. |
| ConfigureDetector(string, RFmxSpecAnMXAcpDetectorType, int) | Configures the detector settings, including detector type and the number of points to be detected. |
| ConfigureFft(string, RFmxSpecAnMXAcpFftWindow, double) | Configures window and FFT to obtain a spectrum for the adjacent channel power (ACP) measurement. |
| ConfigureMeasurementMethod(string, RFmxSpecAnMXAcpMeasurementMethod) | Configures the method for performing the adjacent channel power (ACP) measurement. |
| ConfigureNoiseCompensationEnabled(string, RFmxSpecAnMXAcpNoiseCompensationEnabled) | Configures compensation of the channel powers for the inherent noise floor of the signal analyzer. |
| ConfigureNumberOfCarriers(string, int) | Configures the number of carriers for the adjacent channel power (ACP) measurement. |
| ConfigureNumberOfOffsets(string, int) | Configures the number of offsets for the adjacent channel power (ACP) measurement. |
| ConfigureOffset(string, double, RFmxSpecAnMXAcpOffsetSideband, RFmxSpecAnMXAcpOffsetEnabled) | Configures an offset channel on one or both sides of carrier with center-to-center spacing as specified by the offset frequency and offset frequency definition. In case of multiple carriers, offset frequency is relative to the closest carrier. |
| ConfigureOffsetArray(string, double[], RFmxSpecAnMXAcpOffsetSideband[], RFmxSpecAnMXAcpOffsetEnabled[]) | Configures an offset channel on one or both sides of carrier with center-to-center spacing as specified by the offset frequency and offset frequency definition. In case of multiple carriers, offset frequency is relative to the closest carrier. |
| ConfigureOffsetFrequencyDefinition(string, RFmxSpecAnMXAcpOffsetFrequencyDefinition) | Configures the offset frequency definition for the ACP measurement. |
| ConfigureOffsetIntegrationBandwidth(string, double) | Configures the frequency range, in hertz (Hz), over which the adjacent channel power (ACP) measurement integrates the offset channel power. |
| ConfigureOffsetIntegrationBandwidthArray(string, double[]) | Configures the frequency range, in hertz (Hz), over which the measurement integrates the offset channel power. |
| ConfigureOffsetPowerReference(string, RFmxSpecAnMXAcpOffsetPowerReferenceCarrier, int) | Configures the power reference to use for measuring the relative power of the offset channel. |
| ConfigureOffsetPowerReferenceArray(string, RFmxSpecAnMXAcpOffsetPowerReferenceCarrier[], int[]) | Configures the power reference to use for measuring the relative power of the offset channel. |
| ConfigureOffsetRelativeAttenuation(string, double) | Configures the attenuation, in dB, relative to the external attenuation. |
| ConfigureOffsetRelativeAttenuationArray(string, double[]) | Configures the attenuation, in dB, relative to the external attenuation. |
| ConfigureOffsetRrcFilter(string, RFmxSpecAnMXAcpOffsetRrcFilterEnabled, double) | Configures the root raised cosine (RRC) channel filter to be applied on the offset channel before measuring the offset channel power. |
| ConfigureOffsetRrcFilterArray(string, RFmxSpecAnMXAcpOffsetRrcFilterEnabled[], double[]) | Configures the root raised cosine (RRC) channel filter to be applied on the offset channel before measuring the offset channel power. |
| ConfigurePowerUnits(string, RFmxSpecAnMXAcpPowerUnits) | Configures the units for the absolute power. |
| ConfigureRbwFilter(string, RFmxSpecAnMXAcpRbwAutoBandwidth, double, RFmxSpecAnMXAcpRbwFilterType) | Configures the resolution bandwidth (RBW) filter. |
| ConfigureSweepTime(string, RFmxSpecAnMXAcpSweepTimeAuto, double) | Configures the sweep time. |
| GetAllTracesEnabled(string, out bool) | Gets whether the traces to be stored and retrieved after performing the adjacent channel power (ACP) measurement are enabled. |
| GetAmplitudeCorrectionType(string, out RFmxSpecAnMXAcpAmplitudeCorrectionType) | Gets 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 _RFmxInstrCfgExternalAttenuationTable function to configure the external attenuation table. |
| GetAveragingCount(string, out int) | Gets the number of acquisitions used for averaging. |
| GetAveragingEnabled(string, out RFmxSpecAnMXAcpAveragingEnabled) | Gets whether averaging is enabled for the adjacent channel power (ACP) measurement. |
| GetAveragingType(string, out RFmxSpecAnMXAcpAveragingType) | Gets the averaging type for averaging multiple spectrum acquisitions. |
| GetCarrierFrequency(string, out double) | Gets the center frequency, in hertz (Hz), of the carrier, relative to the RF center frequency. |
| GetCarrierIntegrationBandwidth(string, out double) | Gets the frequency range, in hertz (Hz), over which the measurement integrates the carrier power. |
| GetCarrierMode(string, out RFmxSpecAnMXAcpCarrierMode) | Gets whether to consider the carrier power as part of total carrier power measurement. |
| GetCarrierRrcFilterAlpha(string, out double) | Gets the roll-off factor for the root-raised-cosine (RRC) filter on the carrier channel before measuring the carrier channel power. |
| GetCarrierRrcFilterEnabled(string, out RFmxSpecAnMXAcpCarrierRrcFilterEnabled) | Gets whether to apply the root-raised-cosine (RRC) filter on the acquired carrier channel before measuring the carrier channel power. |
| GetDetectorPoints(string, out int) | Gets the number of trace points after the detector is applied. |
| GetDetectorType(string, out RFmxSpecAnMXAcpDetectorType) | Gets the type of detector to be used. |
| GetFarIFOutputPowerOffset(string, out double) | Gets the offset, in dB, by which to adjust the IF output power level for offset channels that are far from the carrier channel to improve the dynamic range. |
| GetFftOverlap(string, out double) | Gets the samples to overlap between the consecutive chunks as a percentage of the SetSequentialFftSize(string, int) method when you set the SetMeasurementMethod(string, RFmxSpecAnMXAcpMeasurementMethod) method to SequentialFft and the SetFftOverlapMode(string, RFmxSpecAnMXAcpFftOverlapMode) method to UserDefined. This value is expressed as a percentage. |
| GetFftOverlapMode(string, out RFmxSpecAnMXAcpFftOverlapMode) | Gets the overlap mode when you set the SetMeasurementMethod(string, RFmxSpecAnMXAcpMeasurementMethod) method to SequentialFft. |
| GetFftPadding(string, out double) | Gets the factor by which the time-domain waveform is zero-padded before FFT. |
| GetFftWindow(string, out RFmxSpecAnMXAcpFftWindow) | Gets the FFT window type to use to reduce spectral leakage. |
| GetIFOutputPowerOffsetAuto(string, out RFmxSpecAnMXAcpIFOutputPowerOffsetAuto) | Gets whether the measurement computes an IF output power level offset for the offset channels to improve the dynamic range of the adjacent channel power (ACP) measurement. |
| GetMeasurementEnabled(string, out bool) | Gets whether the adjacent channel power (ACP) measurement is enabled. |
| GetMeasurementMethod(string, out RFmxSpecAnMXAcpMeasurementMethod) | Gets the method for performing the adjacent channel power (ACP) measurement. |
| GetMeasurementMode(string, out RFmxSpecAnMXAcpMeasurementMode) | Gets 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. |
| GetNearIFOutputPowerOffset(string, out double) | Gets the offset, in dB, by which to adjust the IF output power level for offset channels that are near to the carrier channel to improve the dynamic range. |
| GetNoiseCalibrationAveragingAuto(string, out RFmxSpecAnMXAcpNoiseCalibrationAveragingAuto) | Gets whether RFmx automatically computes the averaging count used for instrument noise calibration. |
| GetNoiseCalibrationAveragingCount(string, out int) | Gets the averaging count used for noise calibration when you set the SetNoiseCalibrationAveragingAuto(string, RFmxSpecAnMXAcpNoiseCalibrationAveragingAuto) method to False. |
| GetNoiseCalibrationMode(string, out RFmxSpecAnMXAcpNoiseCalibrationMode) | Gets 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. |
| GetNoiseCompensationEnabled(string, out RFmxSpecAnMXAcpNoiseCompensationEnabled) | Gets whether compensation of the channel powers for the inherent noise floor of the RF signal analyzer is enabled. |
| GetNoiseCompensationType(string, out RFmxSpecAnMXAcpNoiseCompensationType) | Gets the noise compensation type. Refer to the Noise Compensation Algorithm topic for more information. |
| GetNumberOfAnalysisThreads(string, out int) | Gets the maximum number of threads used for parallelism for adjacent channel power (ACP) measurement. |
| GetNumberOfCarriers(string, out int) | Gets the number of carriers. |
| GetNumberOfOffsets(string, out int) | Gets the number of offset channels. |
| GetOffsetEnabled(string, out RFmxSpecAnMXAcpOffsetEnabled) | Gets whether the offset channel for adjacent channel power (ACP) measurement is enabled. |
| GetOffsetFrequency(string, out double) | Gets the center or edge frequency, in hertz (Hz), of the offset channel, relative to the center frequency of the closest carrier as determined by the SetOffsetFrequencyDefinition(string, RFmxSpecAnMXAcpOffsetFrequencyDefinition) method. The sign of offset frequency is ignored and the SetOffsetSideband(string, RFmxSpecAnMXAcpOffsetSideband) method determines whether the upper, lower, or both offsets are measured. |
| GetOffsetFrequencyDefinition(string, out RFmxSpecAnMXAcpOffsetFrequencyDefinition) | Gets the offset frequency definition used to specify the SetOffsetFrequency(string, double) method. |
| GetOffsetIntegrationBandwidth(string, out double) | Gets the frequency range, in hertz (Hz), over which the measurement integrates the offset channel power. |
| GetOffsetPowerReferenceCarrier(string, out RFmxSpecAnMXAcpOffsetPowerReferenceCarrier) | Gets the carrier, for which the measured power is the power reference to measure offset channel relative power. |
| GetOffsetPowerReferenceSpecific(string, out int) | Gets the carrier index, for which the measured power is the power reference for the offset channel relative power. |
| GetOffsetRelativeAttenuation(string, out double) | Gets the attenuation, in dB, relative to the external attenuation. |
| GetOffsetRrcFilterAlpha(string, out double) | Gets the roll-off factor for the root-raised-cosine (RRC) filter on the acquired offset channel before measuring the offset channel power. |
| GetOffsetRrcFilterEnabled(string, out RFmxSpecAnMXAcpOffsetRrcFilterEnabled) | Gets whether the root-raised-cosine (RRC) filter is applied on the acquired offset channel before measuring the offset channel power. |
| GetOffsetSideband(string, out RFmxSpecAnMXAcpOffsetSideband) | Gets whether the offset segment is present on one side, or on both sides of the carriers. |
| GetPowerUnits(string, out RFmxSpecAnMXAcpPowerUnits) | Gets the adjacent channel power (ACP) power units. |
| GetRbwFilterAutoBandwidth(string, out RFmxSpecAnMXAcpRbwAutoBandwidth) | Gets whether the measurement computes the resolution bandwidth (RBW). |
| GetRbwFilterBandwidth(string, out double) | Gets the bandwidth, in hertz (Hz), of the resolution bandwidth (RBW) filter used to sweep the acquired signal. |
| GetRbwFilterBandwidthDefinition(string, out RFmxSpecAnMXAcpRbwFilterBandwidthDefinition) | Gets the bandwidth definition which you use to specify the value of the SetRbwFilterBandwidth(string, double) method. |
| GetRbwFilterType(string, out RFmxSpecAnMXAcpRbwFilterType) | Gets the shape of the digital resolution bandwidth (RBW) filter. |
| GetSequentialFftSize(string, out int) | Gets the FFT size when you set the SetMeasurementMethod(string, RFmxSpecAnMXAcpMeasurementMethod) method to SequentialFft. |
| GetSweepTimeAuto(string, out RFmxSpecAnMXAcpSweepTimeAuto) | Gets whether the measurement computes the sweep time. |
| GetSweepTimeInterval(string, out double) | Gets the sweep time, in seconds, when you set the SetSweepTimeAuto(string, RFmxSpecAnMXAcpSweepTimeAuto) method to False. |
| SetAllTracesEnabled(string, bool) | Sets whether to enable the traces to be stored and retrieved after performing the adjacent channel power (ACP) measurement. |
| SetAmplitudeCorrectionType(string, RFmxSpecAnMXAcpAmplitudeCorrectionType) | Sets 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 _RFmxInstrCfgExternalAttenuationTable function to configure the external attenuation table. |
| SetAveragingCount(string, int) | Sets the number of acquisitions used for averaging when you set SetAveragingEnabled(string, RFmxSpecAnMXAcpAveragingEnabled) to True. |
| SetAveragingEnabled(string, RFmxSpecAnMXAcpAveragingEnabled) | Sets whether to enable averaging of the spectrum for the adjacent channel power (ACP) measurement. |
| SetAveragingType(string, RFmxSpecAnMXAcpAveragingType) | Sets the averaging type for averaging multiple spectrum acquisitions. The averaged spectrum is used for the adjacent channel power (ACP) measurement. |
| SetCarrierFrequency(string, double) | Sets the center frequency, in hertz (Hz), of the carrier, relative to the RF center frequency. |
| SetCarrierIntegrationBandwidth(string, double) | Sets the frequency range, in hertz (Hz), over which the measurement integrates the carrier power. |
| SetCarrierMode(string, RFmxSpecAnMXAcpCarrierMode) | Sets whether to consider the carrier power as part of total carrier power measurement. The total relative power of a carrier is measured with reference to the total power of all active carriers. The relative power of an offset channel is measured with reference to the total carrier power when you set the RFmxSpecAnMXAcpOffsetPowerReferenceCarrier to Composite. |
| SetCarrierRrcFilterAlpha(string, double) | Sets the roll-off factor for the root-raised-cosine (RRC) filter on the carrier channel before measuring the carrier channel power. |
| SetCarrierRrcFilterEnabled(string, RFmxSpecAnMXAcpCarrierRrcFilterEnabled) | Sets whether to apply the root-raised-cosine (RRC) filter on the acquired carrier channel after measuring the carrier channel power. |
| SetDetectorPoints(string, int) | Sets the number of trace points after the detector is applied. |
| SetDetectorType(string, RFmxSpecAnMXAcpDetectorType) | Sets the type of detector to be used. |
| SetFarIFOutputPowerOffset(string, double) | Sets the offset, in dB, by which to adjust the IF output power level for offset channels that are far from the carrier channel to improve the dynamic range. |
| SetFftOverlap(string, double) | Sets the samples to overlap between the consecutive chunks as a percentage of the SetSequentialFftSize(string, int) method when you set the SetMeasurementMethod(string, RFmxSpecAnMXAcpMeasurementMethod) method to SequentialFft and the SetFftOverlapMode(string, RFmxSpecAnMXAcpFftOverlapMode) method to UserDefined. This value is expressed as a percentage. |
| SetFftOverlapMode(string, RFmxSpecAnMXAcpFftOverlapMode) | Sets the overlap mode when you set the SetMeasurementMethod(string, RFmxSpecAnMXAcpMeasurementMethod) method to SequentialFft. |
| SetFftPadding(string, double) | Sets 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 method is applicable only when the acquisition span is less than the device instantaneous bandwidth of the device. |
| SetFftWindow(string, RFmxSpecAnMXAcpFftWindow) | Sets the FFT window type to use to reduce spectral leakage. |
| SetIFOutputPowerOffsetAuto(string, RFmxSpecAnMXAcpIFOutputPowerOffsetAuto) | Sets whether the measurement computes an IF output power level offset, for the offset channels to improve the dynamic range of the ACP measurement. |
| SetMeasurementEnabled(string, bool) | Sets whether to enable the adjacent channel power (ACP) measurement. |
| SetMeasurementMethod(string, RFmxSpecAnMXAcpMeasurementMethod) | Sets the method for performing the adjacent channel power (ACP) measurement. |
| SetMeasurementMode(string, RFmxSpecAnMXAcpMeasurementMode) | Sets 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. |
| SetNearIFOutputPowerOffset(string, double) | Sets the offset, in dB, by which to adjust the IF output power level for offset channels that are near to the carrier channel to improve the dynamic range. |
| SetNoiseCalibrationAveragingAuto(string, RFmxSpecAnMXAcpNoiseCalibrationAveragingAuto) | Sets whether RFmx automatically computes the averaging count used for instrument noise calibration. |
| SetNoiseCalibrationAveragingCount(string, int) | Sets the averaging count used for noise calibration when you set the SetNoiseCalibrationAveragingAuto(string, RFmxSpecAnMXAcpNoiseCalibrationAveragingAuto) method to False. |
| SetNoiseCalibrationMode(string, RFmxSpecAnMXAcpNoiseCalibrationMode) | Sets 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. |
| SetNoiseCompensationEnabled(string, RFmxSpecAnMXAcpNoiseCompensationEnabled) | Sets whether to enable compensation of the channel powers for the inherent noise floor of the RF signal analyzer. |
| SetNoiseCompensationType(string, RFmxSpecAnMXAcpNoiseCompensationType) | Sets the noise compensation type. Refer to the Noise Compensation Algorithm topic for more information. |
| SetNumberOfAnalysisThreads(string, int) | Sets the maximum number of threads used for parallelism for adjacent channel power (ACP) measurement. |
| SetNumberOfCarriers(string, int) | Sets the number of carriers. |
| SetNumberOfOffsets(string, int) | Sets the number of offset channels. |
| SetOffsetEnabled(string, RFmxSpecAnMXAcpOffsetEnabled) | Sets whether to enable the offset channel for adjacent channel power (ACP) measurement. |
| SetOffsetFrequency(string, double) | Sets the center or edge frequency, in hertz (Hz), of the offset channel, relative to the center frequency of the closest carrier as determined by the SetOffsetFrequencyDefinition(string, RFmxSpecAnMXAcpOffsetFrequencyDefinition) method. The sign of offset frequency is ignored and the SetOffsetSideband(string, RFmxSpecAnMXAcpOffsetSideband) method determines whether the upper, lower, or both offsets are measured. |
| SetOffsetFrequencyDefinition(string, RFmxSpecAnMXAcpOffsetFrequencyDefinition) | Sets the offset frequency definition used to specify the SetOffsetFrequency(string, double) method. |
| SetOffsetIntegrationBandwidth(string, double) | Sets the frequency range, in hertz (Hz), over which the measurement integrates the offset channel power. |
| SetOffsetPowerReferenceCarrier(string, RFmxSpecAnMXAcpOffsetPowerReferenceCarrier) | Sets the carrier, for which the measured power is the power reference to measure offset channel relative power. The offset channel power is measured only if you set the ACP RFmxSpecAnMXAcpOffsetPowerReferenceCarrier to Active. |
| SetOffsetPowerReferenceSpecific(string, int) | Sets the carrier index, for which the measured power is the power reference for the offset channel relative power, when you set the RFmxSpecAnMXAcpOffsetPowerReferenceCarrier method to Specific. |
| SetOffsetRelativeAttenuation(string, double) | Sets the attenuation, in dB, relative to the external attenuation. Use this method to compensate for the variations in external attenuation when offset channels are spread wide in frequency. |
| SetOffsetRrcFilterAlpha(string, double) | Sets the roll-off factor for the root-raised-cosine (RRC) filter on the acquired offset channel before measuring the offset channel power. |
| SetOffsetRrcFilterEnabled(string, RFmxSpecAnMXAcpOffsetRrcFilterEnabled) | Sets whether to apply the root-raised-cosine (RRC) filter on the acquired offset channel before measuring the offset channel power. |
| SetOffsetSideband(string, RFmxSpecAnMXAcpOffsetSideband) | Sets whether the offset segment is present on one side, or on both sides of the carriers. |
| SetPowerUnits(string, RFmxSpecAnMXAcpPowerUnits) | Sets the adjacent channel power (ACP) power units. |
| SetRbwFilterAutoBandwidth(string, RFmxSpecAnMXAcpRbwAutoBandwidth) | Sets whether the measurement computes the resolution bandwidth (RBW). |
| SetRbwFilterBandwidth(string, double) | Sets the bandwidth, in hertz (Hz), of the resolution bandwidth (RBW) filter used to sweep the acquired signal, when you set SetRbwFilterAutoBandwidth(string, RFmxSpecAnMXAcpRbwAutoBandwidth) to False. |
| SetRbwFilterBandwidthDefinition(string, RFmxSpecAnMXAcpRbwFilterBandwidthDefinition) | Sets the bandwidth definition which you use to specify the value of the SetRbwFilterBandwidth(string, double) method. |
| SetRbwFilterType(string, RFmxSpecAnMXAcpRbwFilterType) | Sets the shape of the digital resolution bandwidth (RBW) filter. |
| SetSequentialFftSize(string, int) | Sets the FFT size when you set the SetMeasurementMethod(string, RFmxSpecAnMXAcpMeasurementMethod) method to SequentialFft. |
| SetSweepTimeAuto(string, RFmxSpecAnMXAcpSweepTimeAuto) | Sets whether the measurement computes the sweep time. |
| SetSweepTimeInterval(string, double) | Sets the sweep time, in seconds, when you set SetSweepTimeAuto(string, RFmxSpecAnMXAcpSweepTimeAuto) to False. |
| ValidateNoiseCalibrationData(string, out RFmxSpecAnMXAcpNoiseCalibrationDataValid) | Indicates whether calibration data is valid for the configuration specified by the signal name in the selectorstring parameter. |