CdaResults

Provides methods to fetch and read the Cda measurement results.

class nirfmxcdma2k.cda_results.CdaResults(signal_obj)

Bases: object

Provides methods to fetch and read the Cda measurement results.

fetch_code_domain_i_and_q_power(selector_string, timeout)

Returns the I and Q mean active powers, and I and Q peak inactive powers.

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:

i_mean_active_power (float):

This parameter returns the average power of all active code channels measured on the I-branch. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER attribute.

q_mean_active_power (float):

This parameter returns the average power of all active code channels measured on the Q-branch. If you set the CDA Pwr Unit attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA Result Total Power attribute.

i_peak_inactive_power (float):

This parameter returns the maximum measured code power among the set of inactive channels on the I-Branch. If you set the CDA Pwr Unit attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA Result Total Power attribute.

q_peak_inactive_power (float):

This parameter returns the maximum measured code power among the set of inactive channels on the Q-branch and in the code domain of the base spreading factor. If you set the CDA Pwr Unit attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA Result Total Power 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 (i_mean_active_power, q_mean_active_power, i_peak_inactive_power, q_peak_inactive_power, error_code)

fetch_code_domain_i_and_q_power_trace(selector_string, timeout)

Returns the I and Q code power trace measured in the code domain of the base spreading factor.

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:

i_code_domain_powers (float):

This parameter returns the array of I code power measured in the code domain of the base spreading factor. This value is expressed in dB or dBm.

q_code_domain_powers (float):

This parameter returns the array of Q code power measured in the code domain of the base spreading factor. This value is expressed in dB or 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 (i_code_domain_powers, q_code_domain_powers, error_code)

fetch_code_domain_power(selector_string, timeout)

Returns the scalar code domain power 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:

total_power (float):

This parameter returns the mean power of the received signal. This value is expressed in dBm.

total_active_power (float):

This parameter returns the sum of the powers of all active code channels. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER attribute.

mean_active_power (float):

This parameter returns the average power of all active code channels. If you set the CDA Pwr Unit attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA Result Total Power attribute.

peak_active_power (float):

This parameter returns the average code power measured among the set of inactive channels in the code domain of the base spreading factor. If you set the CDA Pwr Unit attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA Result Total Power attribute.

mean_inactive_power (float):

This parameter returns the maximum power among all active code channels. If you set the CDA Pwr Unit attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA Result Total Power attribute.

peak_inactive_power (float):

This parameter returns the maximum measured code power among the set of inactive channels in the code domain of the base spreading factor. If you set the CDA Pwr Unit attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA Result Total Power 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 (total_power, total_active_power, mean_active_power, peak_active_power, mean_inactive_power, peak_inactive_power, error_code)

fetch_iq_impairments(selector_string, timeout)

Returns the measured I/Q impairments.

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. This value is expressed in dB.

iq_gain_imbalance (float):

This parameter returns the I/Q gain imbalance of the composite signal. This value is expressed in dB.

iq_quadrature_error (float):

This parameter returns the I/Q quadrature error of the composite signal. 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_symbol_constellation_trace(selector_string, timeout, symbol_constellation)

Returns the symbol constellation trace of the configured measurement 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.

• symbol_constellation (numpy.complex64) – This parameter returns the array of symbol constellation points of the configured measurement channel.

Returns:

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

Return type:

int

fetch_symbol_evm(selector_string, timeout)

Returns the modulation accuracy related measures for the configured measurement 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_symbol_evm (float):

This parameter returns the RMS symbol EVM of the configured measurement channel. This value is expressed as a percentage.

peak_symbol_evm (float):

This parameter returns the peak symbol EVM of the configured measurement channel. This value is expressed as a percentage.

rms_symbol_magnitude_error (float):

This parameter returns the RMS symbol magnitude error of the configured measurement channel. This value is expressed as a percentage.

rms_symbol_phase_error (float):

This parameter returns the mean symbol power of the configured measurement channel. This value is expressed in dB, when you set the CDA_POWER_UNIT attribute to dB, and in dBm, when you set the CDA Pwr Unit attribute to dBm.

mean_symbol_power (float):

This parameter returns the RMS symbol phase error of the configured measurement channel. This value is expressed in degrees.

frequency_error (float):

This parameter returns the chip rate error. This value is expressed in parts per million (ppm).

chip_rate_error (float):

This parameter returns the frequency error. 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 (rms_symbol_evm, peak_symbol_evm, rms_symbol_magnitude_error, rms_symbol_phase_error, mean_symbol_power, frequency_error, chip_rate_error, error_code)

fetch_symbol_evm_trace(selector_string, timeout)

Returns the symbol EVM trace of the configured measurement 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:

symbol_evm (float):

This parameter returns the array of symbol EVM values of the configured measurement channel. 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 (symbol_evm, error_code)

fetch_symbol_magnitude_error_trace(selector_string, timeout)

Returns the symbol magnitude error trace of the configured measurement 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:

symbol_magnitude_error (float):

This parameter returns the trace of the symbol magnitude errors of the corrected composite signal. 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 (symbol_magnitude_error, error_code)

fetch_symbol_phase_error_trace(selector_string, timeout)

Returns the symbol phase error trace of the configured measurement 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:

symbol_phase_error (float):

This parameter returns the array of symbol phase error values of the configured measurement channel. 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 (symbol_phase_error, error_code)

fetch_symbol_power_trace(selector_string, timeout)

Returns the symbol power trace of the configured measurement 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:

symbol_powers (float):

This parameter returns the array of symbol power of the configured measurement channel. 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 (symbol_powers, error_code)

get_chip_rate_error(selector_string)

Gets the chip rate error. This value is expressed in parts per million (ppm).

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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the chip rate error. This value is expressed in parts per million (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_frequency_error(selector_string)

Gets the frequency error. This value is expressed in Hz.

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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the frequency error. 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_i_mean_active_power(selector_string)

Gets the average power of all active code channels measured on the I-branch. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER attribute.

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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the average power of all active code channels measured on the I-branch. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER 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_i_peak_inactive_power(selector_string)

Gets the maximum measured code power among the set of inactive channels on the I-branch and in the code domain of the base spreading factor. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER attribute.

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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum measured code power among the set of inactive channels on the I-branch and in the code domain of the base spreading factor. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER 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_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 result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and named results.

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 result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and named results.

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 result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and named results.

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_mean_active_power(selector_string)

Gets the average power of all active code channels. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER attribute.

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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the average power of all active code channels. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER 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_mean_inactive_power(selector_string)

Gets the average code power, measured among the set of inactive channels, in the code domain of the base spreading factor. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER attribute.

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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the average code power, measured among the set of inactive channels, in the code domain of the base spreading factor. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER 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_mean_pilot_power(selector_string)

Gets the mean power of the R-PICH.

Returns the mean power value in dB, when you set the CDA_POWER_UNIT attribute to dB.

Returns the mean power value in dBm, when you set the CDA Pwr Unit attribute to dBm.

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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean power of the R-PICH.

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_mean_symbol_power(selector_string)

Gets the mean symbol power of the configured measurement channel. This value is expressed in dB, when you set the CDA_POWER_UNIT attribute to dB, and in dBm, when you set the CDA Pwr Unit attribute to dBm.

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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean symbol power of the configured measurement channel. This value is expressed in dB, when you set the CDA_POWER_UNIT attribute to dB, and in dBm, when you set the CDA Pwr Unit attribute to 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_peak_active_power(selector_string)

Gets the maximum power among all active code channels. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER attribute.

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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum power among all active code channels. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER 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_inactive_power(selector_string)

Gets the maximum measured code power, measured among the set of inactive channels, in the code domain of the base spreading factor. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER attribute.

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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum measured code power, measured among the set of inactive channels, in the code domain of the base spreading factor. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER 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_symbol_evm(selector_string)

Gets the peak symbol EVM of the configured measurement channel. 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 instance. Refer to the Selector String topic for information about the string syntax for named signals and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the peak symbol EVM of the configured measurement channel. 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_q_mean_active_power(selector_string)

Gets the average power of all active code channels measured on the Q-branch. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER attribute.

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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the average power of all active code channels measured on the Q-branch. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER 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_q_peak_inactive_power(selector_string)

Gets the maximum measured code power among the set of inactive channels on the Q-branch and in the code domain of the base spreading factor. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER attribute.

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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum measured code power among the set of inactive channels on the Q-branch and in the code domain of the base spreading factor. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER 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_rms_symbol_evm(selector_string)

Gets the RMS symbol EVM of the configured measurement channel. 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 instance. Refer to the Selector String topic for information about the string syntax for named signals and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS symbol EVM of the configured measurement channel. 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_symbol_magnitude_error(selector_string)

Gets the RMS symbol magnitude error of the configured measurement channel. 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 instance. Refer to the Selector String topic for information about the string syntax for named signals and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS symbol magnitude error of the configured measurement channel. 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_symbol_phase_error(selector_string)

Gets the RMS symbol phase error of the configured measurement channel. This value is expressed in degrees.

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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS symbol phase error of the configured measurement channel. 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_total_active_power(selector_string)

Gets the sum of the powers of all active code channels. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER attribute.

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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the sum of the powers of all active code channels. If you set the CDA_POWER_UNIT attribute to dBm, this measurement returns the absolute measured power; otherwise, this measurement returns a value relative to the CDA_RESULTS_TOTAL_POWER 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_total_power(selector_string)

Gets the mean power of the received signal. 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 instance. Refer to the Selector String topic for information about the string syntax for named signals and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean power of the received signal. 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)