from .......Internal.Core import Core
from .......Internal.CommandsGroup import CommandsGroup
from .......Internal import Conversions
from .......Internal.Utilities import trim_str_response
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
[docs]class UserCls:
"""User commands group definition. 21 total commands, 4 Subgroups, 4 group commands"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("user", core, parent)
@property
def alevel(self):
"""alevel commands group. 0 Sub-classes, 2 commands."""
if not hasattr(self, '_alevel'):
from .Alevel import AlevelCls
self._alevel = AlevelCls(self._core, self._cmd_group)
return self._alevel
@property
def apply(self):
"""apply commands group. 0 Sub-classes, 1 commands."""
if not hasattr(self, '_apply'):
from .Apply import ApplyCls
self._apply = ApplyCls(self._core, self._cmd_group)
return self._apply
@property
def flist(self):
"""flist commands group. 3 Sub-classes, 4 commands."""
if not hasattr(self, '_flist'):
from .Flist import FlistCls
self._flist = FlistCls(self._core, self._cmd_group)
return self._flist
@property
def slist(self):
"""slist commands group. 3 Sub-classes, 3 commands."""
if not hasattr(self, '_slist'):
from .Slist import SlistCls
self._slist = SlistCls(self._core, self._cmd_group)
return self._slist
[docs] def get_load(self) -> str:
"""SCPI: [SOURce<HW>]:CORRection:FRESponse:RF:USER:LOAD \n
Snippet: value: str = driver.source.correction.fresponse.rf.user.get_load() \n
Loads the selected file from the default or the specified directory. Loaded are files with extension *.freqresp. Refer to
'Accessing Files in the Default or Specified Directory' for general information on file handling in the default and in a
specific directory. \n
:return: freq_resp_rf_rcl: 'filename' Filename or complete file path; file extension can be omitted
"""
response = self._core.io.query_str('SOURce<HwInstance>:CORRection:FRESponse:RF:USER:LOAD?')
return trim_str_response(response)
[docs] def set_load(self, freq_resp_rf_rcl: str) -> None:
"""SCPI: [SOURce<HW>]:CORRection:FRESponse:RF:USER:LOAD \n
Snippet: driver.source.correction.fresponse.rf.user.set_load(freq_resp_rf_rcl = 'abc') \n
Loads the selected file from the default or the specified directory. Loaded are files with extension *.freqresp. Refer to
'Accessing Files in the Default or Specified Directory' for general information on file handling in the default and in a
specific directory. \n
:param freq_resp_rf_rcl: 'filename' Filename or complete file path; file extension can be omitted
"""
param = Conversions.value_to_quoted_str(freq_resp_rf_rcl)
self._core.io.write(f'SOURce<HwInstance>:CORRection:FRESponse:RF:USER:LOAD {param}')
[docs] def preset(self) -> None:
"""SCPI: [SOURce<HW>]:CORRection:FRESponse:RF:USER:PRESet \n
Snippet: driver.source.correction.fresponse.rf.user.preset() \n
Sets the option's parameters to their default values (*RST values specified for the commands) . Not affected is the state
set with the command [:SOURce<hw>]:CORRection:FRESponse:RF:USER[:STATe]. \n
"""
self._core.io.write(f'SOURce<HwInstance>:CORRection:FRESponse:RF:USER:PRESet')
[docs] def preset_with_opc(self, opc_timeout_ms: int = -1) -> None:
"""SCPI: [SOURce<HW>]:CORRection:FRESponse:RF:USER:PRESet \n
Snippet: driver.source.correction.fresponse.rf.user.preset_with_opc() \n
Sets the option's parameters to their default values (*RST values specified for the commands) . Not affected is the state
set with the command [:SOURce<hw>]:CORRection:FRESponse:RF:USER[:STATe]. \n
Same as preset, but waits for the operation to complete before continuing further. Use the RsSmbv.utilities.opc_timeout_set() to set the timeout value. \n
:param opc_timeout_ms: Maximum time to wait in milliseconds, valid only for this call."""
self._core.io.write_with_opc(f'SOURce<HwInstance>:CORRection:FRESponse:RF:USER:PRESet', opc_timeout_ms)
[docs] def get_store(self) -> str:
"""SCPI: [SOURce<HW>]:CORRection:FRESponse:RF:USER:STORe \n
Snippet: value: str = driver.source.correction.fresponse.rf.user.get_store() \n
Saves the current settings into the selected file; the file extension (*.freqresp) is assigned automatically. Refer to
'Accessing Files in the Default or Specified Directory' for general information on file handling in the default and in a
specific directory. \n
:return: freq_resp_rf_save: 'filename' Filename or complete file path
"""
response = self._core.io.query_str('SOURce<HwInstance>:CORRection:FRESponse:RF:USER:STORe?')
return trim_str_response(response)
[docs] def set_store(self, freq_resp_rf_save: str) -> None:
"""SCPI: [SOURce<HW>]:CORRection:FRESponse:RF:USER:STORe \n
Snippet: driver.source.correction.fresponse.rf.user.set_store(freq_resp_rf_save = 'abc') \n
Saves the current settings into the selected file; the file extension (*.freqresp) is assigned automatically. Refer to
'Accessing Files in the Default or Specified Directory' for general information on file handling in the default and in a
specific directory. \n
:param freq_resp_rf_save: 'filename' Filename or complete file path
"""
param = Conversions.value_to_quoted_str(freq_resp_rf_save)
self._core.io.write(f'SOURce<HwInstance>:CORRection:FRESponse:RF:USER:STORe {param}')
[docs] def get_state(self) -> bool:
"""SCPI: [SOURce<HW>]:CORRection:FRESponse:RF:USER:[STATe] \n
Snippet: value: bool = driver.source.correction.fresponse.rf.user.get_state() \n
Enables/disables the frequency response correction. \n
:return: freq_resp_state: 1| ON| 0| OFF
"""
response = self._core.io.query_str('SOURce<HwInstance>:CORRection:FRESponse:RF:USER:STATe?')
return Conversions.str_to_bool(response)
[docs] def set_state(self, freq_resp_state: bool) -> None:
"""SCPI: [SOURce<HW>]:CORRection:FRESponse:RF:USER:[STATe] \n
Snippet: driver.source.correction.fresponse.rf.user.set_state(freq_resp_state = False) \n
Enables/disables the frequency response correction. \n
:param freq_resp_state: 1| ON| 0| OFF
"""
param = Conversions.bool_to_str(freq_resp_state)
self._core.io.write(f'SOURce<HwInstance>:CORRection:FRESponse:RF:USER:STATe {param}')
def clone(self) -> 'UserCls':
"""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 = UserCls(self._core, self._cmd_group.parent)
self._cmd_group.synchronize_repcaps(new_group)
return new_group