RFmxWcdmaMXQevmResults.FetchIQImpairments Method
- Updated2024-07-17
- 3 minute(s) read
RFmx
Fetches the mean and maximum I/Q origin offsets, I/Q gain imbalances, and I/Q quadrature errors for the QEVM measurement.
Namespace: NationalInstruments.RFmx.WcdmaMX
Assembly: NationalInstruments.RFmx.WcdmaMX.Fx40 (in NationalInstruments.RFmx.WcdmaMX.Fx40.dll) Version: 24.5.0.49286 (24.5.0.49286)
Syntax
public int FetchIQImpairments( string selectorString, double timeout, out double meanIQOriginOffset, out double meanIQGainImbalance, out double meanIQQuadratureError, out double maximumIQOriginOffset, out double maximumIQGainImbalance, out double maximumIQQuadratureError )
Public Function FetchIQImpairments ( selectorString As String, timeout As Double, <OutAttribute> ByRef meanIQOriginOffset As Double, <OutAttribute> ByRef meanIQGainImbalance As Double, <OutAttribute> ByRef meanIQQuadratureError As Double, <OutAttribute> ByRef maximumIQOriginOffset As Double, <OutAttribute> ByRef maximumIQGainImbalance As Double, <OutAttribute> ByRef maximumIQQuadratureError As Double ) As Integer
Parameters
- selectorString String
-
Specifies a selector string comprising of the result name.
Example:
""
"result::r1"
You can use the BuildResultString(String) method to build the selector string. - timeout Double
- Specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete.
- meanIQOriginOffset Double
-
Upon return, contains the mean of I/Q origin offsets for a QPSK signal. This value is expressed in dB.
This value is obtained by averaging the I/Q origin offsets over all averaging acquisitions. The number of acquisitions is specified by the value of the SetAveragingCount(String, Int32) method.
The I/Q origin offset is a measure of the DC component present in the I/Q signal being measured.
- meanIQGainImbalance Double
-
Upon return, contains the mean of the I/Q gain imbalances for a QPSK signal. This value is expressed in dB.
This value is obtained by the I/Q gain imbalances obtained over all averaging acquisitions. The number of acquisitions is specified by the value of the SetAveragingCount(String, Int32) method.
The I/Q gain imbalance is the ratio of the magnitude of the I component to the Q component of the I/Q signal being measured. This result is for future use.
- meanIQQuadratureError Double
-
Upon return, contains the mean of the I/Q quadrature errors for a QPSK signal. This value is expressed in degrees.
This value is obtained by the mean of I/Q quadrature errors obtained over all averaging acquisitions. The number of acquisitions is specified by the value of the SetAveragingCount(String, Int32) method.
Quadrature error is a measure of the error in the phase between I and Q components of the signal being measured. This result is for future use.
- maximumIQOriginOffset Double
-
Upon return, contains the maximum I/Q origin offset for a QPSK signal. This value is expressed in dB.
- maximumIQGainImbalance Double
-
Upon return, contains the maximum value of I/Q gain imbalances for a QPSK signal. This value is expressed in dB. This value is obtained over all averaging iterations. The number of acquisitions is specified by the value of the SetAveragingCount(String, Int32) method.
The I/Q gain imbalance is the ratio of the magnitude of the I component to the Q component of the I/Q signal being measured. This result is for future use.
- maximumIQQuadratureError Double
-
Upon return, contains the maximum value of I/Q quadrature errors for a QPSK signal. This value is expressed in degrees. This value is obtained over all averaging iterations.
The number of acquisitions is specified by the value of the SetAveragingCount(String, Int32) method.
Quadrature error is a measure of the error in the phase between I and Q components of the signal being measured. This result is for future use.
Return Value
Int32Returns the status code of this method. The status code either indicates success or describes a warning condition.