Provides methods to configure the ModAcc measurement.

Derives from

Syntax

Namespace: NationalInstruments.RFmx.NRMX

public class RFmxNRMXModAccConfiguration : RFmxNRMXSubObject

Methods

NameDescription
AutoLevel(string, double)

Performs the user-configured ModAcc measurement at multiple reference levels relative to the user-configured SetReferenceLevel(string, double) method and configures the reference level corresponding to the lowest GetCompositeRmsEvmMean(string, out double) result.
This method only measures at the reference levels that do not result in an ADC or OSP overflow when you set the SetAutoLevelAllowOverflow(string, RFmxNRMXModAccAutoLevelAllowOverflow) method to False. If you set the ModAcc Auto Level Allow Overflow method to True, this method measures at a few reference levels beyond the overflow.

ClearNoiseCalibrationDatabase()

Clears the noise calibration database used for EVM noise compensation.

ConfigureMeasurementMode(string, RFmxNRMXModAccMeasurementMode)

Configures the measurement mode for the ModAcc measurement.

ConfigureNoiseCompensationEnabled(string, RFmxNRMXModAccNoiseCompensationEnabled)

Configures whether to enable EVM noise compensation for the ModAcc measurement.supporteddevices:PXIe-5830/5831/5832/5646/5840/5841/5842/5860.

ConfigureReferenceWaveform(string, ComplexWaveform< ComplexSingle >)

Configures the reference waveform for the creation of reference data symbols for EVM computation.

GetAllTracesEnabled(string, out bool)

Gets whether to enable the traces to be stored and retrieved after performing the ModAcc measurement.

GetAutoLevelAllowOverflow(string, out RFmxNRMXModAccAutoLevelAllowOverflow)

Gets whether the AutoLevel(string, double) function should search for the optimum reference levels while allowing ADC overflow.

GetAveragingCount(string, out int)

Gets the number of acquisitions used for averaging when you set the SetAveragingEnabled(string, RFmxNRMXModAccAveragingEnabled) method to True.

GetAveragingEnabled(string, out RFmxNRMXModAccAveragingEnabled)

Enables averaging for the measurement.

GetChannelEstimationType(string, out RFmxNRMXModAccChannelEstimationType)

Gets the method used for channel estimation.

GetCommonClockSourceEnabled(string, out RFmxNRMXModAccCommonClockSourceEnabled)

Gets whether same reference clock is used for local oscillator and digital-to-analog converter. When same reference clock is used the Carrier Frequency Offset is proportional to Sample Clock Error.

GetCompositeResultsIncludeDmrs(string, out RFmxNRMXModAccCompositeResultsIncludeDmrs)

Gets whether the DMRS resource elements are included for composite EVM and magnitude and phase error results and traces.

GetCompositeResultsIncludePtrs(string, out RFmxNRMXModAccCompositeResultsIncludePtrs)

Gets whether the PTRS resource elements are included for composite EVM and magnitude and phase error results and traces.

GetDCSubcarrierRemovalEnabled(string, out RFmxNRMXModAccDCSubcarrierRemovalEnabled)

Gets whether the DC subcarrier is removed from the EVM results.

GetEvmReferenceDataSymbolsMode(string, out RFmxNRMXModAccEvmReferenceDataSymbolsMode)

Gets whether to either use a reference waveform or an acquired waveform to create reference data symbols for EVM computation.

GetEvmUnit(string, out RFmxNRMXModAccEvmUnit)

Gets the units of the EVM results.

GetFftWindowLength(string, out double)

Gets the FFT window length (W). This value is expressed as a percentage of the cyclic prefix length. This method is used when you set the SetFftWindowType(string, RFmxNRMXModAccFftWindowType) method to Type3GPP, where it is needed to calculate the EVM using two different FFT window positions, Delta_C-W/2, and Delta_C+W/2.

GetFftWindowOffset(string, out double)

Gets the position of the FFT window used to calculate the EVM when SetFftWindowType(string, RFmxNRMXModAccFftWindowType) method is set to TypeCustom. The offset is expressed as a percentage of the cyclic prefix length. If you set this method to 0, the EVM window starts at the end of cyclic prefix. If you set this method to 100, the EVM window starts at the beginning of cyclic prefix.

GetFftWindowType(string, out RFmxNRMXModAccFftWindowType)

Gets the FFT window type used for EVM calculation.

GetFrequencyErrorEstimation(string, out RFmxNRMXModAccFrequencyErrorEstimation)

Gets the operation mode of frequency error estimation. If frequency error is absent in the signal to be analyzed, you may disable frequency estimation to reduce measurement time or to avoid measurement inaccuracy due to error in frequency error estimation.

GetIQGainImbalanceCorrectionEnabled(string, out RFmxNRMXModAccIQGainImbalanceCorrectionEnabled)

Gets whether to enable IQ gain imbalance correction.

GetIQImpairmentsModel(string, out RFmxNRMXModAccIQImpairmentsModel)

Gets the I/Q impairments model used by the measurement for estimating I/Q impairments.

GetIQImpairmentsPerSubcarrierEnabled(string, out RFmxNRMXModAccIQImpairmentsPerSubcarrierEnabled)

Gets whether to return I/Q impairments independently for each subcarrier.

GetIQMismatchEstimationEnabled(string, out RFmxNRMXModAccIQMismatchEstimationEnabled)

Gets whether to estimate the IQ impairments such as IQ gain imbalance and quadrature skew.

GetIQOriginOffsetEstimationEnabled(string, out RFmxNRMXModAccIQOriginOffsetEstimationEnabled)

Gets whether to estimate the IQ origin offset. If IQ origin offset is absent in the signal to be analyzed, you may disable IQ origin offset estimation to reduce measurement time or to avoid measurement inaccuracy due to error in IQ origin offset estimation.

GetIQQuadratureErrorCorrectionEnabled(string, out RFmxNRMXModAccIQQuadratureErrorCorrectionEnabled)

Gets whether to enable IQ quadrature error correction.

GetIQTimingSkewCorrectionEnabled(string, out RFmxNRMXModAccIQTimingSkewCorrectionEnabled)

Gets whether to enable IQ timing skew correction.

GetMagnitudeAndPhaseErrorEnabled(string, out RFmxNRMXModAccMagnitudeAndPhaseErrorEnabled)

Gets whether to measure the magnitude and the phase error.

GetMeasurementEnabled(string, out bool)

Gets whether to enable the ModAcc measurement.

GetMeasurementLength(string, out double)

Gets the measurement length in units specified by Measurement Length Unit method.

GetMeasurementLengthUnit(string, out RFmxNRMXModAccMeasurementLengthUnit)

Gets the units in which measurement offset and measurement length are specified.

GetMeasurementMode(string, out RFmxNRMXModAccMeasurementMode)

Gets whether the measurement should calibrate the noise floor of the analyzer or perform the ModAcc measurement.

GetMeasurementOffset(string, out double)

Gets the measurement offset to skip from the synchronization boundary. The synchronization boundary is specified by the SetSynchronizationMode(string, RFmxNRMXModAccSynchronizationMode) method. The unit for this is specified by ModAcc Measurement Length Unit.

GetMulticarrierFilterEnabled(string, out RFmxNRMXModAccMulticarrierFilterEnabled)

Gets whether to use the filter in single carrier configurations to minimize leakage into the carrier. Measurement ignores this method, if number of carriers is set to more than 1 or if you set the SetAcquisitionBandwidthOptimizationEnabled(string, RFmxNRMXAcquisitionBandwidthOptimizationEnabled) method to False, where in the multi carrier filter will always be used.

GetNoiseCompensationEnabled(string, out RFmxNRMXModAccNoiseCompensationEnabled)

Gets whether the contribution of the instrument noise is compensated for EVM computation. You must measure the noise floor before applying the noise compensation. The instrument noise floor is measured for the RF path used by the ModAcc measurement and cached for future use.

GetNoiseCompensationInputPowerCheckEnabled(string, out RFmxNRMXModAccNoiseCompensationInputPowerCheckEnabled)

Gets whether the measurement checks if any high power signal is present at the RFIn port of the instrument while performing noise floor calibration.

GetNoiseCompensationReferenceLevelCoercionLimit(string, out double)

Gets the coercion limit for the reference level for noise compensation. When you set the SetMeasurementMode(string, RFmxNRMXModAccMeasurementMode) method to Measure and SetNoiseCompensationEnabled(string, RFmxNRMXModAccNoiseCompensationEnabled) method to True, the measurement attempts to read noise floor calibration data corresponding to the configured reference level. If noise floor calibration data corresponding to the configured reference level is not found in the calibration database, the measurement attempts to read noise floor calibration data from the calibration database for any reference level in the range of the configured reference level plus or minus the coercion limit you set for this method.

GetNumberOfAnalysisThreads(string, out int)

Gets the maximum number of threads used for parallelism for the ModAcc measurement.

GetPhaseTrackingMode(string, out RFmxNRMXModAccPhaseTrackingMode)

Gets the method used for phase tracking.

GetPreFftErrorEstimationInterval(string, out RFmxNRMXModAccPreFftErrorEstimationInterval)

Gets the interval used for Pre-FFT error estimation.

GetShortFrameEnabled(string, out RFmxNRMXModAccShortFrameEnabled)

Gets whether the input signal has a periodicity shorter than the NR frame duration.

GetShortFrameLength(string, out double)

Gets the short frame periodicity in unit specified by Short Frame Length Unit.

GetShortFrameLengthUnit(string, out RFmxNRMXModAccShortFrameLengthUnit)

Gets the units in which Short Frame Length is specified.

GetSpectralFlatnessCondition(string, out RFmxNRMXModAccSpectralFlatnessCondition)

Gets the test condition for Spectral Flatness measurement.

GetSpectrumInverted(string, out RFmxNRMXModAccSpectrumInverted)

Gets whether the spectrum of the signal being measured is inverted. This happens when I and Q component of the baseband complex signal is swapped.

GetSymbolClockErrorEstimationEnabled(string, out RFmxNRMXModAccSymbolClockErrorEstimationEnabled)

Gets whether to estimate symbol clock error. This method is ignored when the Common Clock Source Enabled method is True and the Frequency Error Estimation method is Disabled, in which case, symbol clock error is not estimated. If symbol clock error is absent in the signal to be analyzed, you may disable symbol clock error estimation to reduce measurement time or to avoid measurement inaccuracy due to error in symbol clock error estimation.

GetSynchronizationMode(string, out RFmxNRMXModAccSynchronizationMode)

Gets whether the measurement is performed from slot or frame boundary.

GetTimingTrackingMode(string, out RFmxNRMXModAccTimingTrackingMode)

Gets the method used for timing tracking.

GetTransientPeriod(string, out double)

It configures the transient duration as specified in section 6.4.2.1a of 3GPP 38.101-1 specification.

GetTransientPeriodEvmMode(string, out RFmxNRMXModAccTransientPeriodEvmMode)

Configures the EVM measurement behavior for symbols affected by power transients.

GetTransientPowerChangeThreshold(string, out double)

Gets transient period power change threshold level in dB.

SetAllTracesEnabled(string, bool)

Sets whether to enable the traces to be stored and retrieved after performing the ModAcc measurement.

SetAutoLevelAllowOverflow(string, RFmxNRMXModAccAutoLevelAllowOverflow)

Sets whether the AutoLevel(string, double) function should search for the optimum reference levels while allowing ADC overflow.

SetAveragingCount(string, int)

Sets the number of acquisitions used for averaging when you set the SetAveragingEnabled(string, RFmxNRMXModAccAveragingEnabled) method to True.

SetAveragingEnabled(string, RFmxNRMXModAccAveragingEnabled)

Enables averaging for the measurement.

SetChannelEstimationType(string, RFmxNRMXModAccChannelEstimationType)

Sets the method used for channel estimation.

SetCommonClockSourceEnabled(string, RFmxNRMXModAccCommonClockSourceEnabled)

Sets whether same reference clock is used for local oscillator and digital-to-analog converter. When same reference clock is used the Carrier Frequency Offset is proportional to Sample Clock Error.

SetCompositeResultsIncludeDmrs(string, RFmxNRMXModAccCompositeResultsIncludeDmrs)

Sets whether the DMRS resource elements are included for composite EVM and magnitude and phase error results and traces.

SetCompositeResultsIncludePtrs(string, RFmxNRMXModAccCompositeResultsIncludePtrs)

Sets whether the PTRS resource elements are included for composite EVM and magnitude and phase error results and traces.

SetDCSubcarrierRemovalEnabled(string, RFmxNRMXModAccDCSubcarrierRemovalEnabled)

Sets whether the DC subcarrier is removed from the EVM results.

SetEvmReferenceDataSymbolsMode(string, RFmxNRMXModAccEvmReferenceDataSymbolsMode)

Sets whether to either use a reference waveform or an acquired waveform to create reference data symbols for EVM computation.

SetEvmUnit(string, RFmxNRMXModAccEvmUnit)

Sets the units of the EVM results.

SetFftWindowLength(string, double)

Sets the FFT window length (W). This value is expressed as a percentage of the cyclic prefix length. This method is used when you set the SetFftWindowType(string, RFmxNRMXModAccFftWindowType) method to Type3GPP, where it is needed to calculate the EVM using two different FFT window positions, Delta_C-W/2, and Delta_C+W/2.

SetFftWindowOffset(string, double)

Sets the position of the FFT window used to calculate the EVM when SetFftWindowType(string, RFmxNRMXModAccFftWindowType) method is set to TypeCustom. The offset is expressed as a percentage of the cyclic prefix length. If you set this method to 0, the EVM window starts at the end of cyclic prefix. If you set this method to 100, the EVM window starts at the beginning of cyclic prefix.

SetFftWindowType(string, RFmxNRMXModAccFftWindowType)

Sets the FFT window type used for EVM calculation.

SetFrequencyErrorEstimation(string, RFmxNRMXModAccFrequencyErrorEstimation)

Sets the operation mode of frequency error estimation. If frequency error is absent in the signal to be analyzed, you may disable frequency estimation to reduce measurement time or to avoid measurement inaccuracy due to error in frequency error estimation.

SetIQGainImbalanceCorrectionEnabled(string, RFmxNRMXModAccIQGainImbalanceCorrectionEnabled)

Sets whether to enable IQ gain imbalance correction.

SetIQImpairmentsModel(string, RFmxNRMXModAccIQImpairmentsModel)

Sets the I/Q impairments model used by the measurement for estimating I/Q impairments.

SetIQImpairmentsPerSubcarrierEnabled(string, RFmxNRMXModAccIQImpairmentsPerSubcarrierEnabled)

Sets whether to return I/Q impairments independently for each subcarrier.

SetIQMismatchEstimationEnabled(string, RFmxNRMXModAccIQMismatchEstimationEnabled)

Sets whether to estimate the IQ impairments such as IQ gain imbalance and quadrature skew.

SetIQOriginOffsetEstimationEnabled(string, RFmxNRMXModAccIQOriginOffsetEstimationEnabled)

Sets whether to estimate the IQ origin offset. If IQ origin offset is absent in the signal to be analyzed, you may disable IQ origin offset estimation to reduce measurement time or to avoid measurement inaccuracy due to error in IQ origin offset estimation.

SetIQQuadratureErrorCorrectionEnabled(string, RFmxNRMXModAccIQQuadratureErrorCorrectionEnabled)

Sets whether to enable IQ quadrature error correction.

SetIQTimingSkewCorrectionEnabled(string, RFmxNRMXModAccIQTimingSkewCorrectionEnabled)

Sets whether to enable IQ timing skew correction.

SetMagnitudeAndPhaseErrorEnabled(string, RFmxNRMXModAccMagnitudeAndPhaseErrorEnabled)

Sets whether to measure the magnitude and the phase error.

SetMeasurementEnabled(string, bool)

Sets whether to enable the ModAcc measurement.

SetMeasurementLength(string, double)

Sets the measurement length in units specified by Measurement Length Unit method.

SetMeasurementLengthUnit(string, RFmxNRMXModAccMeasurementLengthUnit)

Sets the units in which measurement offset and measurement length are specified.

SetMeasurementMode(string, RFmxNRMXModAccMeasurementMode)

Sets whether the measurement should calibrate the noise floor of the analyzer or perform the ModAcc measurement.

SetMeasurementOffset(string, double)

Sets the measurement offset to skip from the synchronization boundary. The synchronization boundary is specified by the SetSynchronizationMode(string, RFmxNRMXModAccSynchronizationMode) method. The unit for this is specified by ModAcc Measurement Length Unit.

SetMulticarrierFilterEnabled(string, RFmxNRMXModAccMulticarrierFilterEnabled)

Sets whether to use the filter in single carrier configurations to minimize leakage into the carrier. Measurement ignores this method, if number of carriers is set to more than 1 or if you set the SetAcquisitionBandwidthOptimizationEnabled(string, RFmxNRMXAcquisitionBandwidthOptimizationEnabled) method to False, where in the multi carrier filter will always be used.

SetNoiseCompensationEnabled(string, RFmxNRMXModAccNoiseCompensationEnabled)

Sets whether the contribution of the instrument noise is compensated for EVM computation. You must measure the noise floor before applying the noise compensation. The instrument noise floor is measured for the RF path used by the ModAcc measurement and cached for future use.

SetNoiseCompensationInputPowerCheckEnabled(string, RFmxNRMXModAccNoiseCompensationInputPowerCheckEnabled)

Sets whether the measurement checks if any high power signal is present at the RFIn port of the instrument while performing noise floor calibration.

SetNoiseCompensationReferenceLevelCoercionLimit(string, double)

Sets the coercion limit for the reference level for noise compensation. When you set the SetMeasurementMode(string, RFmxNRMXModAccMeasurementMode) method to Measure and SetNoiseCompensationEnabled(string, RFmxNRMXModAccNoiseCompensationEnabled) method to True, the measurement attempts to read noise floor calibration data corresponding to the configured reference level. If noise floor calibration data corresponding to the configured reference level is not found in the calibration database, the measurement attempts to read noise floor calibration data from the calibration database for any reference level in the range of the configured reference level plus or minus the coercion limit you set for this method.

SetNumberOfAnalysisThreads(string, int)

Sets the maximum number of threads used for parallelism for the ModAcc measurement.

SetPhaseTrackingMode(string, RFmxNRMXModAccPhaseTrackingMode)

Sets the method used for phase tracking.

SetPreFftErrorEstimationInterval(string, RFmxNRMXModAccPreFftErrorEstimationInterval)

Sets the interval used for Pre-FFT error estimation.

SetShortFrameEnabled(string, RFmxNRMXModAccShortFrameEnabled)

Sets whether the input signal has a periodicity shorter than the NR frame duration.

SetShortFrameLength(string, double)

Sets the short frame periodicity in unit specified by Short Frame Length Unit.

SetShortFrameLengthUnit(string, RFmxNRMXModAccShortFrameLengthUnit)

Sets the units in which Short Frame Length is specified.

SetSpectralFlatnessCondition(string, RFmxNRMXModAccSpectralFlatnessCondition)

Sets the test condition for Spectral Flatness measurement.

SetSpectrumInverted(string, RFmxNRMXModAccSpectrumInverted)

Sets whether the spectrum of the signal being measured is inverted. This happens when I and Q component of the baseband complex signal is swapped.

SetSymbolClockErrorEstimationEnabled(string, RFmxNRMXModAccSymbolClockErrorEstimationEnabled)

Sets whether to estimate symbol clock error. This method is ignored when the Common Clock Source Enabled method is True and the Frequency Error Estimation method is Disabled, in which case, symbol clock error is not estimated. If symbol clock error is absent in the signal to be analyzed, you may disable symbol clock error estimation to reduce measurement time or to avoid measurement inaccuracy due to error in symbol clock error estimation.

SetSynchronizationMode(string, RFmxNRMXModAccSynchronizationMode)

Sets whether the measurement is performed from slot or frame boundary.

SetTimingTrackingMode(string, RFmxNRMXModAccTimingTrackingMode)

Sets the method used for timing tracking.

SetTransientPeriod(string, double)

It configures the transient duration as specified in section 6.4.2.1a of 3GPP 38.101-1 specification.

SetTransientPeriodEvmMode(string, RFmxNRMXModAccTransientPeriodEvmMode)

Configures the EVM measurement behavior for symbols affected by power transients.

SetTransientPowerChangeThreshold(string, double)

Sets transient period power change threshold level in dB.

ValidateCalibrationData(string, out RFmxNRMXModAccCalibrationDataValid)

Specifies whether calibration data is valid for the configuration specified by the signal name in the selectorString parameter.