from ......Internal.Core import Core
from ......Internal.CommandsGroup import CommandsGroup
from ......Internal.RepeatedCapability import RepeatedCapability
from ...... import repcap
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
class LevelCls:
"""
| Commands in total: 1
| Subgroups: 0
| Direct child commands: 1
Repeated Capability Setting:
.. code-block:: python
# Range: Nr1 .. Nr4 \n
driver.applications.k10Xlte.sense.adjust.level.repcap_instrument_set(repcap.Instrument.Nr1)
"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("level", core, parent)
self._cmd_group.rep_cap = RepeatedCapability(self._cmd_group.group_name, 'repcap_instrument_get', 'repcap_instrument_set', repcap.Instrument.Nr1)
def repcap_instrument_set(self, instrument: repcap.Instrument) -> None:
"""
Repeated Capability default value numeric suffix.
This value is used, if you do not explicitely set it in the child set/get methods, or if you leave it to Instrument.Default.
Default value after init: Instrument.Nr1
"""
self._cmd_group.set_repcap_enum_value(instrument)
def repcap_instrument_get(self) -> repcap.Instrument:
"""
Returns the current default repeated capability for the child set/get methods.
"""
# noinspection PyTypeChecker
return self._cmd_group.get_repcap_enum_value()
[docs]
def set(self, instrument=repcap.Instrument.Default) -> None:
"""
``[SENSe]:ADJust:LEVel<ant>`` \n
Snippet: ``driver.applications.k10Xlte.sense.adjust.level.set(instrument = repcap.Instrument.Default)`` \n
Initiates a single (internal) measurement that evaluates and sets the ideal reference level for the current input data
and measurement settings. Thus, the settings of the RF attenuation and the reference level are optimized for the signal
level. The FSW is not overloaded and the dynamic range is not limited by an S/N ratio that is too small.
:param instrument: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Level')
"""
instrument_cmd_val = self._cmd_group.get_repcap_cmd_value(instrument, repcap.Instrument)
self._core.io.write(f'SENSe:ADJust:LEVel{instrument_cmd_val}')
[docs]
def set_with_opc(self, instrument=repcap.Instrument.Default, opc_timeout_ms: int = -1) -> None:
instrument_cmd_val = self._cmd_group.get_repcap_cmd_value(instrument, repcap.Instrument)
"""
``[SENSe]:ADJust:LEVel<ant>`` \n
Snippet: ``driver.applications.k10Xlte.sense.adjust.level.set_with_opc(instrument = repcap.Instrument.Default)`` \n
Initiates a single (internal) measurement that evaluates and sets the ideal reference level for the current input data
and measurement settings. Thus, the settings of the RF attenuation and the reference level are optimized for the signal
level. The FSW is not overloaded and the dynamic range is not limited by an S/N ratio that is too small.
Same as set, but waits for the operation to complete before continuing further. Use the RsFsw.utilities.opc_timeout_set() to set the timeout value.
:param instrument: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Level')
:param opc_timeout_ms: Maximum time to wait in milliseconds, valid only for this call.
"""
self._core.io.write_with_opc(f'SENSe:ADJust:LEVel{instrument_cmd_val}', opc_timeout_ms)
def clone(self) -> 'LevelCls':
"""
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 = LevelCls(self._core, self._cmd_group.parent)
self._cmd_group.synchronize_repcaps(new_group)
return new_group