SlotPowerResults

Provides methods to fetch and read the SlotPower measurement results.

class nirfmxtdscdma.slotpower_results.SlotPowerResults(signal_obj)[source]

Bases: object

Provides methods to fetch and read the SlotPower measurement results.

fetch_powers(selector_string, timeout)[source]

Fetches the Slot Power and Slot Power Delta values.

The SlotPower measurement assumes that there is only one active traffic time slot per subframe, and that the position of this active time slot is the same in each subframe. Additionally, it assumes that there are no pilots present in the received signal.

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:

slot_power (float):

This parameter returns an array of mean powers of the active traffic time slots being measured. This value is expressed in dBm. The power of each traffic slot is measured by first excluding the gap period of 12.5 microseconds at the end of the time slot, and then excluding the transient duration of 25 microseconds at the start and the end of the remaining portion of the slot.

slot_power_delta (float):

This parameter returns an array of the power differences between active traffic slots in adjacent subframes. 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 (slot_power, slot_power_delta, error_code)