ModAccResults

Provides methods to fetch and read the ModAcc measurement results.

class nirfmxtdscdma.modacc_results.ModAccResults(signal_obj)

Bases: object

Provides methods to fetch and read the ModAcc measurement results.

fetch_code_domain_error_trace(selector_string, timeout)

Fetches the value of the code domain error trace for the individual code channels in the domain of the base spreading factor. This value is averaged over all active time slots and averaging iterations.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

code_domain_error (float):

This parameter returns an array of the code domain error traces for the individual code channels in the domain of the base spreading factor averaged over all active time slots and averaging iterations. This value is expressed in dB.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (code_domain_error, error_code)

fetch_composite_evm(selector_string, timeout)

Returns the composite EVM of all the channels in the ModAcc measurement.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

rms_composite_evm (float):

This parameter returns the value of the RMS of the composite EVM, averaged over all active time slots and all averaging iterations. This value is expressed as a percentage. Values close to 0 indicate a good modulation accuracy. In a loopback setup, values of approximately 0.2 to 0.4 are typical.

peak_composite_evm (float):

This parameter returns the value of the peak composite EVM among all active time slots and averaging iterations. This value is expressed as a percentage.

composite_rho (float):

This parameter returns the composite value of rho, averaged over all active time-slots and all averaging iterations. A value of 1 indicates a perfectly modulated signal. Typical values for real signals in a loopback setup are slightly below 1.000000.

frequency_error (float):

This parameter returns the frequency error averaged over all measured slots. This value is expressed in Hz.

chip_rate_error (float):

This parameter returns the chip rate error. This value is expressed in ppm.

rms_composite_magnitude_error (float):

This parameter returns the value of the time-slot based RMS of the composite magnitude error averaged over all active time slots and averaging iterations. This value is expressed as a percentage.

rms_composite_phase_error (float):

This parameter returns the time-slot based RMS of the composite phase error, averaged over all active time slots and averaging iterations. This value is expressed in degrees.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (rms_composite_evm, peak_composite_evm, composite_rho, frequency_error, chip_rate_error, rms_composite_magnitude_error, rms_composite_phase_error, error_code)

fetch_constellation_trace(selector_string, timeout, constellation)

Fetches the constellation trace of the received TD-SCDMA signal. If the averaging is enabled, this trace refers to the last averaging iteration..

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

• constellation (numpy.complex64) – This parameter returns an array of complex chips of the corrected signal on which the ModAcc measurements are performed. You can use these chips to obtain the constellation diagram.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

fetch_data_active_cde(selector_string, timeout)

Returns the peak value among the code domain errors (CDEs) of the active channels, as well as the code number, spreading factor, and branch that correspond to this peak value.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

maximum_peak_data_active_cde (float):

This parameter returns the maximum value of the peak data active CDE among all active physical channels, active time slots and averaging iterations. This value is expressed in dB. The peak data active CDE value is averaged over all averaging iterations.

peak_data_active_cde_spreading_factor (int):

This parameter returns the spreading factor used for retrieving the peak CDE of the active physical channel corresponding to measured value of the MODACC_RESULTS_MAXIMUM_PEAK_DATA_ACTIVE_CDE attribute.

peak_data_active_cde_code (int):

This parameter returns the peak channelization code of the channel corresponding to the measured value of the MODACC_RESULTS_MAXIMUM_PEAK_DATA_ACTIVE_CDE attribute.

peak_data_active_cde_number_of_channels (int):

This parameter returns the number of channels used to determine the peak active CDE.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (maximum_peak_data_active_cde, peak_data_active_cde_spreading_factor, peak_data_active_cde_code, peak_data_active_cde_number_of_channels, error_code)

fetch_data_cde(selector_string, timeout)

Returns the maximum value of the measured data code domain errors (CDEs), along with the spreading factor and the channelization code of the corresponding channel.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

maximum_peak_data_cde (float):

This parameter returns the maximum peak CDE among all active time slots and averaging iterations. This value is expressed in dB.

peak_data_cde_spreading_factor (int):

This parameter returns the spreading factor used for retrieving the peak CDE of the channel corresponding to measured value of the MODACC_RESULTS_MAXIMUM_PEAK_DATA_CDE attribute.

peak_data_cde_code (int):

This parameter returns the peak channelization code of the channel corresponding to the measured value of the MODACC_RESULTS_MAXIMUM_PEAK_DATA_CDE attribute.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (maximum_peak_data_cde, peak_data_cde_spreading_factor, peak_data_cde_code, error_code)

fetch_data_evm(selector_string, timeout)

Returns the EVM measurement of the data channel.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

rms_data_evm (float):

This parameter returns the RMS of the data EVM, averaged over all active time slots and all averaging iterations. This value is expressed as a percentage.

peak_data_evm (float):

This parameter returns the peak data EVM among all active time slots and averaging iterations. This value is expressed as a percentage.

data_rho (float):

This parameter returns the data rho value, averaged over all active time slots and all averaging iterations.

rms_data_magnitude_error (float):

This parameter returns the RMS of the data magnitude error, averaged over all active time slots and all averaging iterations. This value is expressed as a percentage.

rms_data_phase_error (float):

This parameter returns the RMS of the data phase error, averaged over all active time slots and all averaging iterations. This value is expressed in degrees.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (rms_data_evm, peak_data_evm, data_rho, rms_data_magnitude_error, rms_data_phase_error, error_code)

fetch_data_rcde(selector_string, timeout)

Returns the maximum value of the measured data relative code domain error (RCDE), along with the spreading factor and the channelization code of the corresponding channel.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

maximum_peak_data_rcde (float):

This parameter returns the maximum value of the peak RDCEs among all active time slots and averaging iterations. This value is expressed in dB.

RFmx calculates the RCDEs by projecting the descrambled error vector onto the codes of each active channel. The RCDE is the ratio of the mean power of the projection onto that code to the mean power of the corresponding active channel in the reference waveform.

peak_data_rcde_spreading_factor (int):

This parameter returns the spreading factor of the channel corresponding to the value of the MODACC_RESULTS_PEAK_DATA_RCDE attribute.

peak_data_rcde_code (int):

This parameter returns the channelization code of the channel corresponding to the value of the MODACC_RESULTS_PEAK_DATA_RCDE_CODE attribute.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (maximum_peak_data_rcde, peak_data_rcde_spreading_factor, peak_data_rcde_code, error_code)

fetch_detected_channel(selector_string, timeout)

Returns a detected channel by its channel name.

Use “channel*<n>*” as the Selector String to read results from this method.

If the averaging is enabled, the detected channels of the last averaging operation can be retrieved.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name, and channel number. Examples:

  ”channel0”

  ”signal::sig1/channel0”

  ”result::r1/channel0”

  ”signal::sig1/result::r1/channel0”

  You can use the build_channel_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

detected_slot_index (int):

This parameter returns the slot index of the detected channel.

detected_spreading_factor (int):

This parameter returns the spreading factor of the detected channel.

detected_modulation_type (enums.ModAccDetectedModulationType):

This parameter returns the modulation type for the detected channel.

Name (value)	Description
QPSK (0)	The modulation type is QPSK.
8PSK (1)	The modulation type is 8-PSK.
16QAM (2)	The modulation type is16-QAM.

detected_channelization_code (int):

This parameter returns the channelization code of the detected channel.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (detected_slot_index, detected_spreading_factor, detected_modulation_type, detected_channelization_code, error_code)

fetch_detected_channel_array(selector_string, timeout)

Returns the detected channels. If you set the CHANNEL_CONFIGURATION_MODE attribute to User Defined, the measurement returns the configured channels. If the averaging is enabled, this method returns the array of detected channels of the last averaging iteration.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

detected_slot_index (int):

This parameter returns an array of slot indexes of the detected channels.

detected_spreading_factor (int):

This parameter returns an array of spreading factors of the detected channels.

detected_modulation_type (enums.ModAccDetectedModulationType):

This parameter returns an array of the modulation types for the detected channels.

Name (value)	Description
QPSK (0)	The modulation type is QPSK.
8PSK (1)	The modulation type is 8-PSK.
16QAM (2)	The modulation type is 16-QAM.

detected_channelization_code (int):

This parameter returns an array of channelization code numbers for the detected channels.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (detected_slot_index, detected_spreading_factor, detected_modulation_type, detected_channelization_code, error_code)

fetch_evm_trace(selector_string, timeout, evm)

Fetches the average of the EVM traces on the chip level.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

• evm (numpy.float32) – This parameter returns the EVM trace values as a real value array.

Returns:

x0 (float):

This parameter returns the start time of the trace. This value is expressed in seconds.

dx (float):

This parameter returns the sampling time of the trace. This value is expressed in seconds.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (x0, dx, error_code)

fetch_iq_impairments(selector_string, timeout)

Returns the I/Q origin offset, I/Q gain imbalance, and I/Q quadrature error.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

iq_origin_offset (float):

This parameter returns the I/Q origin offset of the composite signal, averaged over all measured slots. This value is expressed in dB.

iq_gain_imbalance (float):

This parameter returns the I/Q gain imbalance of the composite signal, averaged over all measured slots. This value is expressed in dB.

iq_quadrature_error (float):

This parameter returns the I/Q quadrature error of the composite signal, averaged over all measured slots. This value is expressed in degrees.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (iq_origin_offset, iq_gain_imbalance, iq_quadrature_error, error_code)

fetch_magnitude_error_trace(selector_string, timeout, magnitude_error)

Fetches the average of the magnitude error trace on the chip level.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

• magnitude_error (numpy.float32) – This parameter returns the magnitude trace error values as a real value array.

Returns:

x0 (float):

This parameter returns the start time of the trace. This value is expressed in seconds.

dx (float):

This parameter returns the sampling time of the trace. This value is expressed in seconds.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (x0, dx, error_code)

fetch_maximum_code_domain_error_trace(selector_string, timeout)

Fetches the maximum code domain error trace among all active time slots and averaging iterations for the ModAcc measurement.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

maximum_code_domain_error (float):

This parameter returns an array of the maximum code domain error traces among all active time slots and averaging iterations. This value is expressed in dB.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (maximum_code_domain_error, error_code)

fetch_maximum_evm_trace(selector_string, timeout, maximum_evm)

Fetches the maximum EVM trace values on the chip level.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

• maximum_evm (numpy.float32) – This parameter returns an array of the maximum EVM trace values on the chip level. This value is expressed as a percentage.

Returns:

x0 (float):

This parameter returns the start time of the trace. This value is expressed in seconds.

dx (float):

This parameter returns the sampling time of the trace. This value is expressed in seconds.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (x0, dx, error_code)

fetch_maximum_magnitude_error_trace(selector_string, timeout, maximum_magnitude_error)

Fetches the maximum magnitude error trace on the chip level.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

• maximum_magnitude_error (numpy.float32) – This parameter returns an array of maximum magnitude error trace on the chip level. This value is expressed as a percentage.

Returns:

x0 (float):

This parameter returns the start time of the trace. This value is expressed in seconds.

dx (float):

This parameter returns the sampling time of the trace. This value is expressed in seconds.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (x0, dx, error_code)

fetch_maximum_phase_error_trace(selector_string, timeout, maximum_phase_error)

Fetches the maximum phase error trace on the chip level.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

• maximum_phase_error (numpy.float32) – This parameter returns an array of the maximum phase error traces on the chip level. This value is expressed in degrees.

Returns:

x0 (float):

This parameter returns the start time of the trace. This value is expressed in seconds.

dx (float):

This parameter returns the sampling time of the trace. This value is expressed in seconds.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (x0, dx, error_code)

fetch_midamble_and_data_power(selector_string, timeout)

Returns the power of the midamble and the data channel.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

midamble_power (float):

This parameter returns the power of the midamble, averaged over all measured slots. This value is expressed in dBm.

data_field1_power (float):

This parameter returns the power of the data field 1, averaged over all measured slots. This value is expressed in dBm.

data_field2_power (float):

This parameter returns the power of the data field 2, averaged over all measured slots. This value is expressed in dBm.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (midamble_power, data_field1_power, data_field2_power, error_code)

fetch_midamble_evm(selector_string, timeout)

Returns the midamble EVM measurement results.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

rms_midamble_evm (float):

This parameter returns the RMS of the midamble EVM, averaged over all active time slots and all averaging iterations. This value is expressed as a percentage.

peak_midamble_evm (float):

This parameter returns the peak midamble EVM among all active time slots and averaging iterations. This value is expressed as a percentage.

midamble_rho (float):

This parameter returns the rho value of the midamble, averaged over all measured active time slots and averaging iterations.

rms_midamble_magnitude_error (float):

This parameter returns the RMS of the midamble magnitude error, averaged over all active time slots and averaging iterations. This value is expressed as a percentage.

rms_midamble_phase_error (float):

This parameter returns the RMS of the midamble phase error, averaged over all active time slots and all averaging iterations. This value is expressed in degrees.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (rms_midamble_evm, peak_midamble_evm, midamble_rho, rms_midamble_magnitude_error, rms_midamble_phase_error, error_code)

fetch_number_of_detected_channels(selector_string, timeout)

Returns the number of detected channels. If the averaging is enabled, it returns the number of detected channels of the last averaging iteration. If you set the CHANNEL_CONFIGURATION_MODE attribute to User Defined, the measurement returns the number of configured channels.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

number_of_detected_channels (int):

This parameter returns the total number of the detected channels.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (number_of_detected_channels, error_code)

fetch_phase_error_trace(selector_string, timeout, phase_error)

Returns the average of the phase error trace on the chip level.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

• phase_error (numpy.float32) – This parameter returns the phase error trace values as a real value array. This value is expressed in degrees.

Returns:

x0 (float):

This parameter returns the start time of the trace. This value is expressed in seconds.

dx (float):

This parameter returns the sampling time of the trace. This value is expressed in seconds.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (x0, dx, error_code)

fetch_pilot_evm(selector_string, timeout)

Fetches the EVM measurement of the pilot time slot.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. Examples:

  ””

  ”signal::sig1”

  ”result::r1”

  ”signal::sig1/result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

rms_pilot_evm (float):

This parameter returns the RMS of the pilot EVM, averaged over all averaging iterations. This value is expressed as a percentage.

peak_pilot_evm (float):

This parameter returns the maximum of the peak pilot EVM among the averaging iterations. This value is expressed as a percentage.

pilot_rho (float):

This parameter returns the pilot Rho value, averaged over all averaging iterations.

rms_pilot_magnitude_error (float):

This parameter returns the RMS of the pilot magnitude error, averaged over all the averaging iterations. This value is expressed as a percentage.

rms_pilot_phase_error (float):

This parameter returns the RMS of the pilot phase error, averaged over all averaging iterations. This value is expressed in degrees.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (rms_pilot_evm, peak_pilot_evm, pilot_rho, rms_pilot_magnitude_error, rms_pilot_phase_error, error_code)

get_chip_rate_error(selector_string)

Gets the chip rate error. This value is expressed in ppm.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the chip rate error. This value is expressed in ppm.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_composite_rho(selector_string)

Gets the composite value of rho, averaged over all active time slots and all averaging iterations.

A value of 1 indicates a perfectly modulated signal. Typical values for real signals in a loopback setup are slightly below 1.000000.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the composite value of rho, averaged over all active time slots and all averaging iterations.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_data_field1_power(selector_string)

Gets the data field 1 power, averaged over all measured active time slots. This value is expressed in dBm.

You do not need to use a selector string to read this result for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the data field 1 power, averaged over all measured active time slots. This value is expressed in dBm.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_data_field2_power(selector_string)

Gets the data field 2 power, averaged over all measured active time slots. This value is expressed in dBm.

You do not need to use a selector string to read this result for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the data field 2 power, averaged over all measured active time slots. This value is expressed in dBm.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_data_rho(selector_string)

Gets the data rho value, averaged over all active time slots and all averaging iterations.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the data rho value, averaged over all active time slots and all averaging iterations.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_detected_channelization_code(selector_string)

Gets the channelization code of the selected channel within the set of active channels. If the averaging is enabled, this attribute refers to the last averaging iteration.

Use “channel*<n>*” as the Selector String to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the channelization code of the selected channel within the set of active channels. If the averaging is enabled, this attribute refers to the last averaging iteration.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_detected_modulation_type(selector_string)

Gets the modulation type of the selected channel within the set of active channels. If the averaging is enabled, this attribute refers to the last averaging iteration.

Use “channel*<n>*” as the Selector String to read this result.

Name (Value)	Description
QPSK (0)	Indicates QPSK modulation.
8PSK (1)	Indicates 8-PSK modulation.
16QAM (2)	Indicates 16-QAM modulation.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.ModAccDetectedModulationType):

Returns the modulation type of the selected channel within the set of active channels. If the averaging is enabled, this attribute refers to the last averaging iteration.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_detected_slot_index(selector_string)

Gets the slot index of the detected channel within the set of active channels. If the averaging is enabled, this attribute refers to the last averaging iteration.

Use “channel*<n>*” as the Selector String to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the slot index of the detected channel within the set of active channels. If the averaging is enabled, this attribute refers to the last averaging iteration.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_detected_spreading_factor(selector_string)

Gets the spreading factor of the selected channel within the set of active channels. If the averaging is enabled, this attribute refers to the last averaging iteration.

Use “channel*<n>*” as the Selector String to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the spreading factor of the selected channel within the set of active channels. If the averaging is enabled, this attribute refers to the last averaging iteration.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_frequency_error(selector_string)

Gets the frequency error averaged over all measured slots. This value is expressed in Hz.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the frequency error averaged over all measured slots. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_iq_gain_imbalance(selector_string)

Gets the I/Q gain imbalance of the composite signal, averaged over all measured slots. This value is expressed in dB.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the I/Q gain imbalance of the composite signal, averaged over all measured slots. This value is expressed in dB.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_iq_origin_offset(selector_string)

Gets the I/Q origin offset of the composite signal, averaged over all measured slots. This value is expressed in dB.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the I/Q origin offset of the composite signal, averaged over all measured slots. This value is expressed in dB.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_iq_quadrature_error(selector_string)

Gets the I/Q quadrature error of the composite signal, averaged over all measured slots. This value is expressed in degrees.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the I/Q quadrature error of the composite signal, averaged over all measured slots. This value is expressed in degrees.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_maximum_composite_rho(selector_string)

Gets the maximum value of the composite rho among all active time slots and averaging iterations.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum value of the composite rho among all active time slots and averaging iterations.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_maximum_peak_data_active_cde(selector_string)

Gets the maximum value of the peak data active code domain error (CDE) among all active physical channels, active time slots and averaging iterations. This value is expressed in dB.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum value of the peak data active code domain error (CDE) among all active physical channels, active time slots and averaging iterations. This value is expressed in dB.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_maximum_peak_data_cde(selector_string)

Gets the maximum peak code domain error (CDE) among all active time slots and averaging iterations. This value is expressed in dB.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum peak code domain error (CDE) among all active time slots and averaging iterations. This value is expressed in dB.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_maximum_peak_data_rcde(selector_string)

Gets the maximum value of the peak relative code domain error (RDCE) among all active time slots and averaging iterations. This value is expressed in dB.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum value of the peak relative code domain error (RDCE) among all active time slots and averaging iterations. This value is expressed in dB.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_midamble_code(selector_string)

Gets the midamble code.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the midamble code.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_midamble_power(selector_string)

Gets the midamble power, averaged over all measured slots. This value is expressed in dBm.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the midamble power, averaged over all measured slots. This value is expressed in dBm.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_midamble_rho(selector_string)

Gets the rho value of the midamble, averaged over all measured active time slots and averaging iterations.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the rho value of the midamble, averaged over all measured active time slots and averaging iterations.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_midamble_shift(selector_string)

Gets the midamble code shift. This value is expressed in chips.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the midamble code shift. This value is expressed in chips.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_number_of_detected_channels(selector_string)

Gets the number of detected active channels. If the averaging is enabled, this attribute returns the number of detected channels of the last averaging iteration.

You do not need to use a selector string to read this result for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the number of detected active channels. If the averaging is enabled, this attribute returns the number of detected channels of the last averaging iteration.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_composite_evm(selector_string)

Gets the peak composite EVM among all active time slots and averaging iterations. This value is expressed as a percentage.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the peak composite EVM among all active time slots and averaging iterations. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_data_active_cde(selector_string)

Gets the value of the peak data active code domain error (CDE) among all physical channels and active time slots. This value is expressed in dB. The peak data active CDEs are averaged over all averaging iterations.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the value of the peak data active code domain error (CDE) among all physical channels and active time slots. This value is expressed in dB. The peak data active CDEs are averaged over all averaging iterations.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_data_active_cde_code(selector_string)

Gets the peak channelization code of the channel corresponding to the measured value of the MODACC_RESULTS_MAXIMUM_PEAK_DATA_ACTIVE_CDE attribute.

You do not need to use a selector string to read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the peak channelization code of the channel corresponding to the measured value of the MODACC_RESULTS_MAXIMUM_PEAK_DATA_ACTIVE_CDE attribute.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_data_active_cde_number_of_channels(selector_string)

Gets the number of channels used to determine the peak active code domain error (CDE).

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the number of channels used to determine the peak active code domain error (CDE).

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_data_active_cde_spreading_factor(selector_string)

Gets the spreading factor used to retrieve the peak code domain error (CDE) of the active physical channel corresponding to the measured value of the MODACC_RESULTS_MAXIMUM_PEAK_DATA_ACTIVE_CDE attribute.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the spreading factor used to retrieve the peak code domain error (CDE) of the active physical channel corresponding to the measured value of the MODACC_RESULTS_MAXIMUM_PEAK_DATA_ACTIVE_CDE attribute.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_data_cde(selector_string)

Gets the value of the peak code domain error (CDE) among all active time slots. This value is expressed in dB. The peak CDE value is averaged over all averaging iterations.

The CDEs are computed by projecting the descrambled error vector onto the code domain at a specific spreading factor.

The CDE for every code with a specific spreading factor is defined as the ratio of the mean power of the projection onto that code to the mean power of the composite reference waveform.

A fixed spreading factor of 16 is used. The CDEs are calculated separately for I and Q branches.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the value of the peak code domain error (CDE) among all active time slots. This value is expressed in dB. The peak CDE value is averaged over all averaging iterations.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_data_cde_code(selector_string)

Gets the peak channelization code of the channel corresponding to the measured value of the MODACC_RESULTS_MAXIMUM_PEAK_DATA_CDE attribute.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the peak channelization code of the channel corresponding to the measured value of the MODACC_RESULTS_MAXIMUM_PEAK_DATA_CDE attribute.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_data_cde_spreading_factor(selector_string)

Gets the spreading factor used to retrieve the peak code domain error (CDE) of the channel corresponding to measured value of the MODACC_RESULTS_MAXIMUM_PEAK_DATA_CDE attribute.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the spreading factor used to retrieve the peak code domain error (CDE) of the channel corresponding to measured value of the MODACC_RESULTS_MAXIMUM_PEAK_DATA_CDE attribute.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_data_evm(selector_string)

Gets the peak data EVM among all active time slots and averaging iterations. This value is expressed as a percentage.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the peak data EVM among all active time slots and averaging iterations. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_data_rcde(selector_string)

Gets the value of the peak data relative code domain error (RCDE) among all active time slots. This value is expressed in dB. The peak RCDE value is averaged over all averaging iterations.

The CDEs are calculated by projecting the descrambled error vector onto the codes of each active channel.

The RCDE is the ratio of the mean power of the projection onto that code to the mean power of the corresponding active channel in the reference waveform.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the value of the peak data relative code domain error (RCDE) among all active time slots. This value is expressed in dB. The peak RCDE value is averaged over all averaging iterations.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_data_rcde_code(selector_string)

Gets the channelization code of the channel corresponding to the value of the measured MODACC_RESULTS_MAXIMUM_PEAK_DATA_RCDE attribute.

You do not need to use a selector string to read this result for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the channelization code of the channel corresponding to the value of the measured MODACC_RESULTS_MAXIMUM_PEAK_DATA_RCDE attribute.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_data_rcde_spreading_factor(selector_string)

Gets the spreading factor of the channel corresponding to the value of the measured MODACC_RESULTS_MAXIMUM_PEAK_DATA_RCDE attribute.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the spreading factor of the channel corresponding to the value of the measured MODACC_RESULTS_MAXIMUM_PEAK_DATA_RCDE attribute.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_midamble_evm(selector_string)

&amp;gt;Returns the peak midamble EVM among all active time slots and averaging iterations. This value is expressed as a percentage.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

&amp;gt;Returns the peak midamble EVM among all active time slots and averaging iterations. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_pilot_evm(selector_string)

Gets the maximum of the peak pilot EVM among the averaging iterations. This value is expressed as a percentage.

You do not need to use a selector string to read this result for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum of the peak pilot EVM among the averaging iterations. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_pilot_rho(selector_string)

Gets the pilot Rho value, averaged over all averaging iterations.

You do not need to use a selector string to read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the pilot Rho value, averaged over all averaging iterations.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_rms_composite_evm(selector_string)

Gets the value of the time-slot based RMS of the composite EVM, averaged over all active time slots and all averaging iterations. This value is expressed as a percentage.

Values close to 0 indicate a good modulation accuracy. In a loopback setup, values of approximately 0.2 to 0.4 are typical.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the value of the time-slot based RMS of the composite EVM, averaged over all active time slots and all averaging iterations. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_rms_composite_magnitude_error(selector_string)

Gets the RMS of the composite magnitude error averaged over all active time slots and averaging iterations. This value is expressed as a percentage.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS of the composite magnitude error averaged over all active time slots and averaging iterations. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_rms_composite_phase_error(selector_string)

Gets the RMS of the composite phase error, averaged over all active time slots and averaging iterations. This value is expressed in degrees.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS of the composite phase error, averaged over all active time slots and averaging iterations. This value is expressed in degrees.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_rms_data_evm(selector_string)

Gets the RMS of the data EVM, averaged over all active time slots and all averaging iterations. This value is expressed as a percentage.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS of the data EVM, averaged over all active time slots and all averaging iterations. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_rms_data_magnitude_error(selector_string)

Gets the RMS of the data magnitude error, averaged over all active time slots and all averaging iterations. This value is expressed as a percentage.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS of the data magnitude error, averaged over all active time slots and all averaging iterations. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_rms_data_phase_error(selector_string)

Gets the RMS of the data phase error, averaged over all active time slots and all averaging iterations. This value is expressed in degrees.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS of the data phase error, averaged over all active time slots and all averaging iterations. This value is expressed in degrees.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_rms_midamble_evm(selector_string)

Gets the RMS of the midamble EVM, averaged over all active time slots and all averaging iterations. This value is expressed as a percentage.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS of the midamble EVM, averaged over all active time slots and all averaging iterations. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_rms_midamble_magnitude_error(selector_string)

Gets the RMS of the midamble magnitude error, averaged over all active time slots and averaging iterations. This value is expressed as a percentage.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS of the midamble magnitude error, averaged over all active time slots and averaging iterations. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_rms_midamble_phase_error(selector_string)

Gets the RMS of the midamble phase error, averaged over all active time slots and all averaging iterations. This value is expressed in degrees.

You do not need to use a selector string to read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS of the midamble phase error, averaged over all active time slots and all averaging iterations. This value is expressed in degrees.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_rms_pilot_evm(selector_string)

Gets the RMS of the pilot EVM, averaged over all averaging iterations. This value is expressed as a percentage.

You do not need to use a selector string to read this result for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS of the pilot EVM, averaged over all averaging iterations. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_rms_pilot_magnitude_error(selector_string)

Gets the RMS of the pilot magnitude error, averaged over all the averaging iterations. This value is expressed as a percentage.

You do not need to use a selector string to read this result for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS of the pilot magnitude error, averaged over all the averaging iterations. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_rms_pilot_phase_error(selector_string)

Gets the RMS of the pilot phase error, averaged over all averaging iterations. This value is expressed in degrees.

You do not need to use a selector string to read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS of the pilot phase error, averaged over all averaging iterations. This value is expressed in degrees.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)