ModAccResults

Provides methods to fetch and read the ModAcc measurement results.

class nirfmxgsm.modacc_results.ModAccResults(signal_obj)

Bases: object

Provides methods to fetch and read the ModAcc measurement results.

fetch_constellation_trace(selector_string, timeout, constellation_trace)

Fetches the constellation trace concatenated over all the measured time slots for the last acquisition.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. The default is “” (empty string).

  Example:

  ”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_trace (numpy.complex64) – This parameter returns the constellation trace concatenated over all the measured time slots for the last acquisition.

Returns:

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

Return type:

int

fetch_demodulated_bits(selector_string, timeout, demodulated_bits)

Fetches the array of demodulated bits concatenated over all the measured time slots for the last acquisition.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. The default is “” (empty string).

  Example:

  ”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.

• demodulated_bits (numpy.int8) – This parameter returns an array of demodulated bits concatenated over all the measured time slots for the last acquisition.

Returns:

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

Return type:

int

fetch_detected_tsc(selector_string, timeout)

Fetches the detected training sequence code (TSC) of the last burst for GSM/EDGE/EGPRS.

Use “slot<n>” as the selector string to read results from this method.

When the MODACC_MEASUREMENT_INTERVAL attribute is set to Timeslot at Offset, Detected TSC array has one element and the Detected TSC is returned at index 0.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name, and slot number. The default is “” (empty string).

  Example:

  ”slot0”

  ”result::r1/slot0”

  You can use the build_slot_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_tsc (enums.ModAccDetectedTsc):

This parameter returns the detected TSC when you set the BURST_SYNCHRONIZATION_TYPE attribute to TSC.

Name (Value)	Description
Unknown (-1)	Burst synchronization is not found and measurements correspond to best estimate of synchronization.
TSC0 (0)	The detected TSC is TSC0.
TSC1 (1)	The detected TSC is TSC1.
TSC2 (2)	The detected TSC is TSC2.
TSC3 (3)	The detected TSC is TSC3.
TSC4 (4)	The detected TSC is TSC4.
TSC5 (5)	The detected TSC is TSC5.
TSC6 (6)	The detected TSC is TSC6.
TSC7 (7)	The detected TSC is TSC7.

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_tsc, error_code)

fetch_detected_tsc_array(selector_string, timeout)

Fetches the detected training sequence code (TSC) of the last acquisition for GSM/EDGE/EGPRS.

When the MODACC_MEASUREMENT_INTERVAL attribute is set to Timeslot at Offset, Detected TSC array has one element and the Detected TSC is returned at index 0.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. The default is “” (empty string).

  Example:

  ”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_tsc (enums.ModAccDetectedTsc):

This parameter returns an array of the detected TSCs when you set the BURST_SYNCHRONIZATION_TYPE attribute to TSC.

Name (Value)	Description
Unknown (-1)	The synchronization is not found and measurements correspond to best estimate of synchronization.
TSC0 (0)	The detected TSC is TSC0.
TSC1 (1)	The detected TSC is TSC1.
TSC2 (2)	The detected TSC is TSC2.
TSC3 (3)	The detected TSC is TSC3.
TSC4 (4)	The detected TSC is TSC4.
TSC5 (5)	The detected TSC is TSC5.
TSC6 (6)	The detected TSC is TSC6.
TSC7 (7)	The detected TSC is TSC7.

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_tsc, error_code)

fetch_evm(selector_string, timeout)

Fetches the EVM measurement results for EDGE/EGPRS.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. The default is “” (empty string).

  Example:

  ”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:

mean_rms_evm (float):

This parameter returns the mean of RMS EVM values over all the measured time slots. This value is expressed as a percentage.

maximum_rms_evm (float):

This parameter returns the maximum of RMS EVM values over all the measured time slots. This value is expressed as a percentage.

mean_peak_evm (float):

This parameter returns the mean of peak EVM values over all the measured time slots. This value is expressed as a percentage.

maximum_peak_evm (float):

This parameter returns the maximum of peak EVM values over all the measured time slots. This value is expressed as a percentage.

ninety_fifth_percentile_evm (float):

This parameter returns the EVM value, at which no more than 5 percent of the symbols have an EVM exceeding this value. This value is expressed as a percentage.

mean_frequency_error (float):

This parameter returns the mean of frequency error values over all the measured time slots. This value is expressed in Hz.

peak_evm_symbol (int):

This parameter returns the symbol number in the useful portion of the burst corresponding to Maximum Peak EVM parameter.

error_code (int):

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

Return type:

Tuple (mean_rms_evm, maximum_rms_evm, mean_peak_evm, maximum_peak_evm, ninety_fifth_percentile_evm, mean_frequency_error, peak_evm_symbol, error_code)

fetch_evm_amplitude_droop(selector_string, timeout)

Fetches the amplitude droop measurement results for EDGE/EGPRS.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. The default is “” (empty string).

  Example:

  ”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:

mean_amplitude_droop (float):

This parameter returns the mean of amplitude droop values over all the measured time slots. This value is expressed in dB/symbol.

maximum_amplitude_droop (float):

This parameter returns the maximum of amplitude droop values over all the measured time slots. This value is expressed in dB/symbol.

error_code (int):

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

Return type:

Tuple (mean_amplitude_droop, maximum_amplitude_droop, error_code)

fetch_evm_magnitude_error(selector_string, timeout)

Fetches the magnitude error measurement results for EDGE/EGPRS.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. The default is “” (empty string).

  Example:

  ”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:

mean_magnitude_error (float):

This parameter returns the mean of RMS values of magnitude error over all the measured time slots. This value is expressed as a percentage.

maximum_magnitude_error (float):

This parameter returns the maximum of RMS values of magnitude error over all the measured time slots. 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 (mean_magnitude_error, maximum_magnitude_error, error_code)

fetch_evm_phase_error(selector_string, timeout)

Fetches the phase error measurement results for EDGE/EGPRS.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. The default is “” (empty string).

  Example:

  ”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:

mean_phase_error (float):

This parameter returns the mean of RMS values of phase error over all the measured time slots. This value is expressed in degrees.

maximum_phase_error (float):

This parameter returns the maximum of RMS values of phase error over all the measured time 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 (mean_phase_error, maximum_phase_error, error_code)

fetch_evm_trace(selector_string, timeout, evm)

Fetches the EDGE/EGPRS RMS EVM trace concatenated over all the measured time slots for the last acquisition.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. The default is “” (empty string).

  Example:

  ”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 measured at each time instance.

Returns:

x0 (float):

This parameter returns the start time, in seconds.

dx (float):

This parameter returns the sample duration, 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)

Fetches the origin offset and gain imbalance measurement results for GSM/EDGE/EGPRS.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. The default is “” (empty string).

  Example:

  ”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:

mean_iq_gain_imbalance (float):

This parameter returns the mean of I/Q gain imbalance values over all the measured time slots. This value is expressed in dB. The presence of quadrature skew in the signal affects the measurement of I/Q gain imbalance.

maximum_iq_gain_imbalance (float):

This parameter returns the maximum of I/Q gain imbalance values over all the measured time slots. This value is expressed in dB. The presence of quadrature skew in the signal affects the measurement of I/Q gain imbalance.

mean_iq_origin_offset (float):

This parameter returns the mean of I/Q origin offset values over all the measured time slots. This value is expressed in dB. Presence of I/Q gain imbalance and quadrature skew in the signal affects the I/Q origin offset measurement. The measurement returns this result for GSM/EDGE/EGPRS.

maximum_iq_origin_offset (float):

This parameter returns the maximum of I/Q origin offset values over all the measured time slots. This value is expressed in dB. Presence of I/Q gain imbalance and quadrature skew in the signal affects the I/Q origin offset measurement. The measurement returns this result for GSM/EDGE/EGPRS.

error_code (int):

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

Return type:

Tuple (mean_iq_gain_imbalance, maximum_iq_gain_imbalance, mean_iq_origin_offset, maximum_iq_origin_offset, error_code)

fetch_magnitude_error_trace(selector_string, timeout, magnitude_error)

Fetches the EDGE/EGPRS magnitude error trace concatenated over all the measured time slots for the last acquisition.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. The default is “” (empty string).

  Example:

  ”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 an array of magnitude error values measured at each time instance.

Returns:

x0 (float):

This parameter returns the start time, in seconds.

dx (float):

This parameter returns the sample duration, 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_pfer(selector_string, timeout)

Fetches the phase and frequency error measurement results for GSM.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. The default is “” (empty string).

  Example:

  ”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:

mean_rms_phase_error (float):

This parameter returns the mean of RMS phase error values over all the measured time slots. This value is expressed in degrees.

maximum_rms_phase_error (float):

This parameter returns the maximum of RMS phase error values over all the measured time slots. This value is expressed in degrees.

mean_peak_phase_error (float):

This parameter returns the mean of peak phase error values over all the measured time slots. This value is expressed in degrees.

maximum_peak_phase_error (float):

This parameter returns the maximum of peak phase error values over all the measured time slots. This value is expressed in degrees.

mean_frequency_error (float):

This parameter returns the mean of frequency error values over all the measured time slots. This value is expressed in Hz.

peak_symbol (int):

This parameter returns the symbol number in the useful portion of the burst corresponding to phase error value in the Maximum Peak Phase Error parameter.

error_code (int):

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

Return type:

Tuple (mean_rms_phase_error, maximum_rms_phase_error, mean_peak_phase_error, maximum_peak_phase_error, mean_frequency_error, peak_symbol, error_code)

fetch_phase_error_trace(selector_string, timeout, phase_error)

Fetches the phase error trace concatenated over all the measured time slots for the last acquisition.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of result name. The default is “” (empty string).

  Example:

  ”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.

Returns:

x0 (float):

This parameter returns the start time, in seconds.

dx (float):

This parameter returns the sample duration, in symbols.

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)

get_detected_tsc(selector_string)

Gets the detected training sequence code (TSC) if you set the BURST_SYNCHRONIZATION_TYPE attribute to TSC.

Use “slot<n>” as the selector string to read this result.

When the MODACC_MEASUREMENT_INTERVAL attribute is set to Timeslot at Offset, Detected TSC array has one element and the Detected TSC is returned at index 0.

Name (Value)	Description
Unknown (-1)	The synchronization is not found, and measurements correspond to best estimate of synchronization.
TSC0 (0)	The detected TSC is TSC0.
TSC1 (1)	The detected TSC is TSC1.
TSC2 (2)	The detected TSC is TSC2.
TSC3 (3)	The detected TSC is TSC3.
TSC4 (4)	The detected TSC is TSC4.
TSC5 (5)	The detected TSC is TSC5.
TSC6 (6)	The detected TSC is TSC6.
TSC7 (7)	The detected TSC is TSC7.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.ModAccDetectedTsc):

Returns the detected training sequence code (TSC) if you set the BURST_SYNCHRONIZATION_TYPE attribute to TSC.

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

Gets the EVM value at which no more than 5% of the symbols have an EVM exceeding this value. This value is expressed as a percentage. The attribute returns this result for EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the EVM value at which no more than 5% of the symbols have an EVM exceeding this value. This value is expressed as a percentage. The attribute returns this result for EDGE/EGPRS measurements.

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

Gets the measured magnitude error value multiplied by 100, at which, no more than 5 percent of the symbols have magnitude error exceeding this value. This result is returned while performing ModAcc measurement on EDGE/EGPRS. This value is measured 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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the measured magnitude error value multiplied by 100, at which, no more than 5 percent of the symbols have magnitude error exceeding this value. This result is returned while performing ModAcc measurement on EDGE/EGPRS. This value is measured 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_evm_95th_percentile_phase_error(selector_string)

Gets the measured phase error value multiplied by 100, at which, no more than 5 percent of the symbols have phase error exceeding this value. This result is returned while performing ModAcc measurement on EDGE/EGPRS. This value is measured in degrees.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the measured phase error value multiplied by 100, at which, no more than 5 percent of the symbols have phase error exceeding this value. This result is returned while performing ModAcc measurement on EDGE/EGPRS. This value is measured 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_evm_maximum_amplitude_droop(selector_string)

Gets the maximum of the amplitude droop values over all the measured time slots. This value is expressed in dB/symbol. The attribute returns this result for EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum of the amplitude droop values over all the measured time slots. This value is expressed in dB/symbol. The attribute returns this result for EDGE/EGPRS measurements.

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

Gets the maximum of the frequency error values over all the measured time slots. This value is expressed in Hz. The attribute returns this result for EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum of the frequency error values over all the measured time slots. This value is expressed in Hz. The attribute returns this result for EDGE/EGPRS measurements.

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

Gets the maximum of RMS values of magnitude error over all the measured time slots. This value is expressed as a percentage. The attribute returns this result for EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum of RMS values of magnitude error over all the measured time slots. This value is expressed as a percentage. The attribute returns this result for EDGE/EGPRS measurements.

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

Gets the maximum of the peak EVM values over all the measured time slots. This value is expressed as a percentage. The attribute returns this result for EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum of the peak EVM values over all the measured time slots. This value is expressed as a percentage. The attribute returns this result for EDGE/EGPRS measurements.

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

Gets the maximum of peak magnitude error values over all the measured time slots. This result is returned while performing ModAcc measurement on EDGE/EGPRS. This value is measured 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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum of peak magnitude error values over all the measured time slots. This result is returned while performing ModAcc measurement on EDGE/EGPRS. This value is measured 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_evm_maximum_peak_phase_error(selector_string)

Gets the maximum of peak phase error values over all the measured time slots. This result is returned while performing ModAcc measurement on EDGE/EGPRS. This value is measured in degrees.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum of peak phase error values over all the measured time slots. This result is returned while performing ModAcc measurement on EDGE/EGPRS. This value is measured 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_evm_maximum_phase_error(selector_string)

Gets the maximum of the RMS values of phase error over all the measured time slots. This value is expressed in degrees. The attribute returns this result for EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum of the RMS values of phase error over all the measured time slots. This value is expressed in degrees. The attribute returns this result for EDGE/EGPRS measurements.

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

Gets the maximum of RMS values of EVM over all the measured time slots. This value is expressed as a percentage. The attribute returns this result for EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum of RMS values of EVM over all the measured time slots. This value is expressed as a percentage. The attribute returns this result for EDGE/EGPRS measurements.

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

Gets the mean of the amplitude droop values over all the measured time slots. This value is expressed in dB/symbol. The attribute returns this result for EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean of the amplitude droop values over all the measured time slots. This value is expressed in dB/symbol. The attribute returns this result for EDGE/EGPRS measurements.

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

Gets the mean of the frequency error values over all the measured time slots. This value is expressed in Hz. The attribute returns this result for EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean of the frequency error values over all the measured time slots. This value is expressed in Hz. The attribute returns this result for EDGE/EGPRS measurements.

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

Gets the mean of RMS values of magnitude error over all the measured time slots. This value is expressed as a percentage. The attribute returns this result for EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean of RMS values of magnitude error over all the measured time slots. This value is expressed as a percentage. The attribute returns this result for EDGE/EGPRS measurements.

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

Gets the mean of the peak EVM values over all the measured time slots. This value is expressed as a percentage. The attribute returns this result for EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean of the peak EVM values over all the measured time slots. This value is expressed as a percentage. The attribute returns this result for EDGE/EGPRS measurements.

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

Gets the mean of peak magnitude error values over all the measured time slots. This result is returned while performing ModAcc measurement on EDGE/EGPRS. This value is measured 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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean of peak magnitude error values over all the measured time slots. This result is returned while performing ModAcc measurement on EDGE/EGPRS. This value is measured 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_evm_mean_peak_phase_error(selector_string)

Gets the mean of peak phase error values over all the measured time slots. This result is returned while performing ModAcc measurement on EDGE/EGPRS. This value is measured in degrees.

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 and named results. &amp;gt;

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean of peak phase error values over all the measured time slots. This result is returned while performing ModAcc measurement on EDGE/EGPRS. This value is measured 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_evm_mean_phase_error(selector_string)

Gets the mean of RMS values of phase error over all the measured time slots. This value is expressed in degrees. The attribute returns this result for EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean of RMS values of phase error over all the measured time slots. This value is expressed in degrees. The attribute returns this result for EDGE/EGPRS measurements.

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

Gets the mean of RMS values of EVM over all the measured time slots. This value is expressed as a percentage. The attribute returns this result for EDGE/EGPRS measurements.

You do not need to use a Selector String to configure or 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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean of RMS values of EVM over all the measured time slots. This value is expressed as a percentage. The attribute returns this result for EDGE/EGPRS measurements.

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

Gets the symbol number in the useful portion of the burst corresponding to MODACC_RESULTS_EVM_MAXIMUM_PEAK_EVM result. The attribute returns this result for ModAcc EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the symbol number in the useful portion of the burst corresponding to MODACC_RESULTS_EVM_MAXIMUM_PEAK_EVM result. The attribute returns this result for ModAcc EDGE/EGPRS measurements.

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

Gets the maximum of I/Q gain imbalance values over all the measured time slots. This value is expressed in dB. The presence of quadrature skew in the signal affects the measurement of I/Q gain imbalance.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum of I/Q gain imbalance values over all the measured time slots. This value is expressed in dB. The presence of quadrature skew in the signal affects the measurement of I/Q gain imbalance.

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

Gets the maximum of the I/Q origin offset values over all the measured time slots. This value is expressed in dB. Presence of I/Q gain imbalance and quadrature skew in the signal affects the I/Q origin offset measurement. The attribute returns this result for GSM/EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum of the I/Q origin offset values over all the measured time slots. This value is expressed in dB. Presence of I/Q gain imbalance and quadrature skew in the signal affects the I/Q origin offset measurement. The attribute returns this result for GSM/EDGE/EGPRS measurements.

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

Gets the mean of I/Q gain imbalance values over all the measured time slots. This value is expressed in dB. The presence of quadrature skew in the signal affects the measurement of I/Q gain imbalance.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean of I/Q gain imbalance values over all the measured time slots. This value is expressed in dB. The presence of quadrature skew in the signal affects the measurement of I/Q gain imbalance.

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

Gets the mean of the I/Q origin offset values over all the measured time slots. This value is expressed in dB. Presence of I/Q gain imbalance and quadrature skew in the signal affects the I/Q origin offset measurement. The attribute returns this result for GSM/EDGE/EGPRS measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean of the I/Q origin offset values over all the measured time slots. This value is expressed in dB. Presence of I/Q gain imbalance and quadrature skew in the signal affects the I/Q origin offset measurement. The attribute returns this result for GSM/EDGE/EGPRS measurements.

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

Gets the measured phase error value multiplied by 100, at which, no more than 5 percent of the symbols have phase error exceeding this value. This result is returned while performing ModAcc measurement on GSM. This value is measured in degrees.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the measured phase error value multiplied by 100, at which, no more than 5 percent of the symbols have phase error exceeding this value. This result is returned while performing ModAcc measurement on GSM. This value is measured 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_pfer_maximum_frequency_error(selector_string)

Gets the maximum of the frequency error values over all the measured time slots. This value is expressed in Hz. The attribute returns this result for GSM ModAcc measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum of the frequency error values over all the measured time slots. This value is expressed in Hz. The attribute returns this result for GSM ModAcc measurements.

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

Gets the maximum of peak phase error values over all the measured time slots. This value is expressed in degrees. The attribute returns this result for GSM ModAcc measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum of peak phase error values over all the measured time slots. This value is expressed in degrees. The attribute returns this result for GSM ModAcc measurements.

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

Gets the maximum of the RMS values of phase error over all the measured time slots. This value is expressed in degrees. The attribute returns this result for GSM ModAcc measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the maximum of the RMS values of phase error over all the measured time slots. This value is expressed in degrees. The attribute returns this result for GSM ModAcc measurements.

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

Gets the mean of the frequency error values over all the measured time slots. This value is expressed in Hz. The attribute returns this result for GSM ModAcc measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean of the frequency error values over all the measured time slots. This value is expressed in Hz. The attribute returns this result for GSM ModAcc measurements.

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

Gets the mean of peak phase error values over all the measured time slots. This value is expressed in degrees. The attribute returns this result for GSM ModAcc measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean of peak phase error values over all the measured time slots. This value is expressed in degrees. The attribute returns this result for GSM ModAcc measurements.

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

Gets the mean of RMS values of phase error over all the measured time slots. This value is expressed in degrees. The attribute returns this result for GSM ModAcc measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the mean of RMS values of phase error over all the measured time slots. This value is expressed in degrees. The attribute returns this result for GSM ModAcc measurements.

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

Gets the symbol number in the useful portion of the burst corresponding to the phase error value in the MODACC_RESULTS_PFER_MAXIMUM_PEAK_PHASE_ERROR result. The attribute returns this result for GSM ModAcc measurements.

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 and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):

Returns the symbol number in the useful portion of the burst corresponding to the phase error value in the MODACC_RESULTS_PFER_MAXIMUM_PEAK_PHASE_ERROR result. The attribute returns this result for GSM ModAcc measurements.

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)