from ....Internal.Core import Core
from ....Internal.CommandsGroup import CommandsGroup
from ....Internal import Conversions
from .... import enums
from .... import repcap
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
[docs]class DeviationCls:
"""Deviation commands group definition. 3 total commands, 0 Subgroups, 3 group commands"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("deviation", core, parent)
# noinspection PyTypeChecker
[docs] def get_mode(self) -> enums.ModulationDevMode:
"""SCPI: [SOURce<HW>]:PM:DEViation:MODE \n
Snippet: value: enums.ModulationDevMode = driver.source.pm.deviation.get_mode() \n
Selects the coupling mode. The coupling mode parameter also determines the mode for fixing the total deviation. \n
:return: pm_dev_mode: UNCoupled| TOTal| RATio UNCoupled Does not couple the LF signals. The deviation values of both paths are independent. TOTal Couples the deviation of both paths. RATio Couples the deviation ratio of both paths
"""
response = self._core.io.query_str('SOURce<HwInstance>:PM:DEViation:MODE?')
return Conversions.str_to_scalar_enum(response, enums.ModulationDevMode)
[docs] def set_mode(self, pm_dev_mode: enums.ModulationDevMode) -> None:
"""SCPI: [SOURce<HW>]:PM:DEViation:MODE \n
Snippet: driver.source.pm.deviation.set_mode(pm_dev_mode = enums.ModulationDevMode.RATio) \n
Selects the coupling mode. The coupling mode parameter also determines the mode for fixing the total deviation. \n
:param pm_dev_mode: UNCoupled| TOTal| RATio UNCoupled Does not couple the LF signals. The deviation values of both paths are independent. TOTal Couples the deviation of both paths. RATio Couples the deviation ratio of both paths
"""
param = Conversions.enum_scalar_to_str(pm_dev_mode, enums.ModulationDevMode)
self._core.io.write(f'SOURce<HwInstance>:PM:DEViation:MODE {param}')
[docs] def get_sum(self) -> float:
"""SCPI: [SOURce<HW>]:PM:DEViation:SUM \n
Snippet: value: float = driver.source.pm.deviation.get_sum() \n
Sets the total deviation of the LF signal when using combined signal sources in phase modulation. \n
:return: pm_dev_sum: float Range: 0 to max
"""
response = self._core.io.query_str('SOURce<HwInstance>:PM:DEViation:SUM?')
return Conversions.str_to_float(response)
[docs] def set_sum(self, pm_dev_sum: float) -> None:
"""SCPI: [SOURce<HW>]:PM:DEViation:SUM \n
Snippet: driver.source.pm.deviation.set_sum(pm_dev_sum = 1.0) \n
Sets the total deviation of the LF signal when using combined signal sources in phase modulation. \n
:param pm_dev_sum: float Range: 0 to max
"""
param = Conversions.decimal_value_to_str(pm_dev_sum)
self._core.io.write(f'SOURce<HwInstance>:PM:DEViation:SUM {param}')
[docs] def set(self, deviation: float, generatorIx=repcap.GeneratorIx.Default) -> None:
"""SCPI: [SOURce]:PM<CH>:[DEViation] \n
Snippet: driver.source.pm.deviation.set(deviation = 1.0, generatorIx = repcap.GeneratorIx.Default) \n
Sets the modulation deviation of the phase modulation in RAD. \n
:param deviation: float The maximal deviation depends on the RF frequency and the selected modulation mode (see data sheet) . Range: 0 to max, Unit: RAD
:param generatorIx: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Pm')
"""
param = Conversions.decimal_value_to_str(deviation)
generatorIx_cmd_val = self._cmd_group.get_repcap_cmd_value(generatorIx, repcap.GeneratorIx)
self._core.io.write(f'SOURce:PM{generatorIx_cmd_val}:DEViation {param}')
[docs] def get(self, generatorIx=repcap.GeneratorIx.Default) -> float:
"""SCPI: [SOURce]:PM<CH>:[DEViation] \n
Snippet: value: float = driver.source.pm.deviation.get(generatorIx = repcap.GeneratorIx.Default) \n
Sets the modulation deviation of the phase modulation in RAD. \n
:param generatorIx: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Pm')
:return: deviation: float The maximal deviation depends on the RF frequency and the selected modulation mode (see data sheet) . Range: 0 to max, Unit: RAD"""
generatorIx_cmd_val = self._cmd_group.get_repcap_cmd_value(generatorIx, repcap.GeneratorIx)
response = self._core.io.query_str(f'SOURce:PM{generatorIx_cmd_val}:DEViation?')
return Conversions.str_to_float(response)