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
class UserCls:
"""
| Commands in total: 21
| Subgroups: 4
| Direct child commands: 4
"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("user", core, parent)
@property
def alevel(self):
"""
| Commands in total: 2
| Subgroups: 0
| Direct child commands: 2
"""
if not hasattr(self, '_alevel'):
from .Alevel import AlevelCls
self._alevel = AlevelCls(self._core, self._cmd_group)
return self._alevel
@property
def apply(self):
"""
| Commands in total: 1
| Subgroups: 0
| Direct child commands: 1
"""
if not hasattr(self, '_apply'):
from .Apply import ApplyCls
self._apply = ApplyCls(self._core, self._cmd_group)
return self._apply
@property
def flist(self):
"""
| Commands in total: 7
| Subgroups: 3
| Direct child commands: 4
"""
if not hasattr(self, '_flist'):
from .Flist import FlistCls
self._flist = FlistCls(self._core, self._cmd_group)
return self._flist
@property
def slist(self):
"""
| Commands in total: 7
| Subgroups: 3
| Direct child commands: 3
"""
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:
"""
``[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.
: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:
"""
``[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.
: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:
"""
``[SOURce<HW>]:CORRection:FRESponse:RF:USER:PRESet`` \n
Snippet: ``driver.source.correction.fresponse.rf.user.preset()`` \n
Sets the parameters to their default values (``*RST`` values specified for the commands) . Not affected is the state set
with the method ``RsSmw.source.correction.fresponse.rf.user.state()`` .
"""
self._core.io.write(f'SOURce<HwInstance>:CORRection:FRESponse:RF:USER:PRESet')
[docs]
def preset_with_opc(self, opc_timeout_ms: int = -1) -> None:
"""
``[SOURce<HW>]:CORRection:FRESponse:RF:USER:PRESet`` \n
Snippet: ``driver.source.correction.fresponse.rf.user.preset_with_opc()`` \n
Sets the parameters to their default values (``*RST`` values specified for the commands) . Not affected is the state set
with the method ``RsSmw.source.correction.fresponse.rf.user.state()`` .
Same as preset, but waits for the operation to complete before continuing further. Use the RsSmw.utilities.opc_timeout_set() to set the timeout value.
: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:
"""
``[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.
: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:
"""
``[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.
: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:
"""
``[SOURce<HW>]:CORRection:FRESponse:RF:USER:[STATe]`` \n
Snippet: ``value: bool = driver.source.correction.fresponse.rf.user.get_state()`` \n
Enables the frequency response correction.
: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:
"""
``[SOURce<HW>]:CORRection:FRESponse:RF:USER:[STATe]`` \n
Snippet: ``driver.source.correction.fresponse.rf.user.set_state(freq_resp_state = False)`` \n
Enables the frequency response correction.
: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