from ....Internal.Core import Core
from ....Internal.CommandsGroup import CommandsGroup
from ....Internal import Conversions
from ....Internal.Utilities import trim_str_response
from .... import enums
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
[docs]
class MultiEvalCls:
"""MultiEval commands group definition. 11 total commands, 2 Subgroups, 8 group commands"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("multiEval", core, parent)
@property
def catalog(self):
"""catalog commands group. 0 Sub-classes, 1 commands."""
if not hasattr(self, '_catalog'):
from .Catalog import CatalogCls
self._catalog = CatalogCls(self._core, self._cmd_group)
return self._catalog
@property
def listPy(self):
"""listPy commands group. 0 Sub-classes, 2 commands."""
if not hasattr(self, '_listPy'):
from .ListPy import ListPyCls
self._listPy = ListPyCls(self._core, self._cmd_group)
return self._listPy
[docs]
def get_source(self) -> str:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:SOURce \n
Snippet: value: str = driver.trigger.multiEval.get_source() \n
Selects the source of the trigger events. Some values are always available. They are listed below. Depending on the
installed options, additional values are available. You can query a list of all supported values via TRIGger:...
:CATalog:SOURce?. \n
:return: source: string 'Free Run (Fast Sync) ' Free run with synchronization 'Free Run (No Sync) ' Free run without synchronization 'IF Power' Power trigger (received RF power)
"""
response = self._core.io.query_str('TRIGger:LTE:MEASurement<Instance>:MEValuation:SOURce?')
return trim_str_response(response)
[docs]
def set_source(self, source: str) -> None:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:SOURce \n
Snippet: driver.trigger.multiEval.set_source(source = 'abc') \n
Selects the source of the trigger events. Some values are always available. They are listed below. Depending on the
installed options, additional values are available. You can query a list of all supported values via TRIGger:...
:CATalog:SOURce?. \n
:param source: string 'Free Run (Fast Sync) ' Free run with synchronization 'Free Run (No Sync) ' Free run without synchronization 'IF Power' Power trigger (received RF power)
"""
param = Conversions.value_to_quoted_str(source)
self._core.io.write(f'TRIGger:LTE:MEASurement<Instance>:MEValuation:SOURce {param}')
[docs]
def get_threshold(self) -> float or bool:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:THReshold \n
Snippet: value: float or bool = driver.trigger.multiEval.get_threshold() \n
Defines the trigger threshold for power trigger sources. \n
:return: trig_threshold: (float or boolean) numeric Range: -50 dB to 0 dB, Unit: dB (full scale, i.e. relative to reference level minus external attenuation)
"""
response = self._core.io.query_str('TRIGger:LTE:MEASurement<Instance>:MEValuation:THReshold?')
return Conversions.str_to_float_or_bool(response)
[docs]
def set_threshold(self, trig_threshold: float or bool) -> None:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:THReshold \n
Snippet: driver.trigger.multiEval.set_threshold(trig_threshold = 1.0) \n
Defines the trigger threshold for power trigger sources. \n
:param trig_threshold: (float or boolean) numeric Range: -50 dB to 0 dB, Unit: dB (full scale, i.e. relative to reference level minus external attenuation)
"""
param = Conversions.decimal_or_bool_value_to_str(trig_threshold)
self._core.io.write(f'TRIGger:LTE:MEASurement<Instance>:MEValuation:THReshold {param}')
# noinspection PyTypeChecker
[docs]
def get_slope(self) -> enums.SignalSlope:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:SLOPe \n
Snippet: value: enums.SignalSlope = driver.trigger.multiEval.get_slope() \n
Qualifies whether the trigger event is generated at the rising or at the falling edge of the trigger pulse (valid for
external and power trigger sources) . \n
:return: slope: REDGe | FEDGe REDGe: Rising edge FEDGe: Falling edge
"""
response = self._core.io.query_str('TRIGger:LTE:MEASurement<Instance>:MEValuation:SLOPe?')
return Conversions.str_to_scalar_enum(response, enums.SignalSlope)
[docs]
def set_slope(self, slope: enums.SignalSlope) -> None:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:SLOPe \n
Snippet: driver.trigger.multiEval.set_slope(slope = enums.SignalSlope.FEDGe) \n
Qualifies whether the trigger event is generated at the rising or at the falling edge of the trigger pulse (valid for
external and power trigger sources) . \n
:param slope: REDGe | FEDGe REDGe: Rising edge FEDGe: Falling edge
"""
param = Conversions.enum_scalar_to_str(slope, enums.SignalSlope)
self._core.io.write(f'TRIGger:LTE:MEASurement<Instance>:MEValuation:SLOPe {param}')
[docs]
def get_delay(self) -> float:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:DELay \n
Snippet: value: float = driver.trigger.multiEval.get_delay() \n
Defines a time delaying the start of the measurement relative to the trigger event. This setting has no influence on free
run measurements. \n
:return: delay: numeric Range: -250E-6 s to 250E-6 s, Unit: s
"""
response = self._core.io.query_str('TRIGger:LTE:MEASurement<Instance>:MEValuation:DELay?')
return Conversions.str_to_float(response)
[docs]
def set_delay(self, delay: float) -> None:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:DELay \n
Snippet: driver.trigger.multiEval.set_delay(delay = 1.0) \n
Defines a time delaying the start of the measurement relative to the trigger event. This setting has no influence on free
run measurements. \n
:param delay: numeric Range: -250E-6 s to 250E-6 s, Unit: s
"""
param = Conversions.decimal_value_to_str(delay)
self._core.io.write(f'TRIGger:LTE:MEASurement<Instance>:MEValuation:DELay {param}')
[docs]
def get_timeout(self) -> float or bool:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:TOUT \n
Snippet: value: float or bool = driver.trigger.multiEval.get_timeout() \n
Selects the maximum time that the measurement waits for a trigger event before it stops in remote control mode or
indicates a trigger timeout in manual operation mode. This setting has no influence on 'Free Run' measurements. \n
:return: trigger_timeout: (float or boolean) numeric | ON | OFF Range: 0.01 s to 167772.15 s, Unit: s ON | OFF enables or disables the timeout.
"""
response = self._core.io.query_str('TRIGger:LTE:MEASurement<Instance>:MEValuation:TOUT?')
return Conversions.str_to_float_or_bool(response)
[docs]
def set_timeout(self, trigger_timeout: float or bool) -> None:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:TOUT \n
Snippet: driver.trigger.multiEval.set_timeout(trigger_timeout = 1.0) \n
Selects the maximum time that the measurement waits for a trigger event before it stops in remote control mode or
indicates a trigger timeout in manual operation mode. This setting has no influence on 'Free Run' measurements. \n
:param trigger_timeout: (float or boolean) numeric | ON | OFF Range: 0.01 s to 167772.15 s, Unit: s ON | OFF enables or disables the timeout.
"""
param = Conversions.decimal_or_bool_value_to_str(trigger_timeout)
self._core.io.write(f'TRIGger:LTE:MEASurement<Instance>:MEValuation:TOUT {param}')
[docs]
def get_mgap(self) -> int:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:MGAP \n
Snippet: value: int = driver.trigger.multiEval.get_mgap() \n
Sets a minimum time during which the IF signal must be below the trigger threshold before the trigger is armed so that an
IF power trigger event can be generated. \n
:return: min_trig_gap: integer Range: 0 slots to 20 slots, Unit: slots
"""
response = self._core.io.query_str('TRIGger:LTE:MEASurement<Instance>:MEValuation:MGAP?')
return Conversions.str_to_int(response)
[docs]
def set_mgap(self, min_trig_gap: int) -> None:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:MGAP \n
Snippet: driver.trigger.multiEval.set_mgap(min_trig_gap = 1) \n
Sets a minimum time during which the IF signal must be below the trigger threshold before the trigger is armed so that an
IF power trigger event can be generated. \n
:param min_trig_gap: integer Range: 0 slots to 20 slots, Unit: slots
"""
param = Conversions.decimal_value_to_str(min_trig_gap)
self._core.io.write(f'TRIGger:LTE:MEASurement<Instance>:MEValuation:MGAP {param}')
# noinspection PyTypeChecker
[docs]
def get_smode(self) -> enums.SyncMode:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:SMODe \n
Snippet: value: enums.SyncMode = driver.trigger.multiEval.get_smode() \n
Selects the size of the search window for synchronization - normal or enhanced. \n
:return: sync_mode: NORMal | ENHanced
"""
response = self._core.io.query_str('TRIGger:LTE:MEASurement<Instance>:MEValuation:SMODe?')
return Conversions.str_to_scalar_enum(response, enums.SyncMode)
[docs]
def set_smode(self, sync_mode: enums.SyncMode) -> None:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:SMODe \n
Snippet: driver.trigger.multiEval.set_smode(sync_mode = enums.SyncMode.ENHanced) \n
Selects the size of the search window for synchronization - normal or enhanced. \n
:param sync_mode: NORMal | ENHanced
"""
param = Conversions.enum_scalar_to_str(sync_mode, enums.SyncMode)
self._core.io.write(f'TRIGger:LTE:MEASurement<Instance>:MEValuation:SMODe {param}')
# noinspection PyTypeChecker
[docs]
def get_amode(self) -> enums.MevAcquisitionMode:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:AMODe \n
Snippet: value: enums.MevAcquisitionMode = driver.trigger.multiEval.get_amode() \n
Selects whether the measurement synchronizes to a slot boundary or to a subframe boundary. The parameter is relevant for
'Free Run (Fast Sync) ' and for list mode measurements with 'Synchronization Mode' = 'Enhanced'. \n
:return: acquisition_mode: SLOT | SUBFrame
"""
response = self._core.io.query_str('TRIGger:LTE:MEASurement<Instance>:MEValuation:AMODe?')
return Conversions.str_to_scalar_enum(response, enums.MevAcquisitionMode)
[docs]
def set_amode(self, acquisition_mode: enums.MevAcquisitionMode) -> None:
"""SCPI: TRIGger:LTE:MEASurement<Instance>:MEValuation:AMODe \n
Snippet: driver.trigger.multiEval.set_amode(acquisition_mode = enums.MevAcquisitionMode.SLOT) \n
Selects whether the measurement synchronizes to a slot boundary or to a subframe boundary. The parameter is relevant for
'Free Run (Fast Sync) ' and for list mode measurements with 'Synchronization Mode' = 'Enhanced'. \n
:param acquisition_mode: SLOT | SUBFrame
"""
param = Conversions.enum_scalar_to_str(acquisition_mode, enums.MevAcquisitionMode)
self._core.io.write(f'TRIGger:LTE:MEASurement<Instance>:MEValuation:AMODe {param}')
def clone(self) -> 'MultiEvalCls':
"""Clones the group by creating new object from it and its whole existing subgroups
Also copies all the existing default Repeated Capabilities setting,
which you can change independently without affecting the original group"""
new_group = MultiEvalCls(self._core, self._cmd_group.parent)
self._cmd_group.synchronize_repcaps(new_group)
return new_group