from .....Internal.Core import Core
from .....Internal.CommandsGroup import CommandsGroup
from .....Internal import Conversions
from .....Internal.Types import DataType
from .....Internal.ArgSingleList import ArgSingleList
from .....Internal.ArgSingle import ArgSingle
from ..... import repcap
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
class ValuesCls:
"""
| Commands in total: 1
| Subgroups: 0
| Direct child commands: 1
"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("values", core, parent)
[docs]
def get(self, start: int=None, size: int=None, tdRtSignal=repcap.TdRtSignal.Default) -> float:
"""
``TDRT:SIGNal<*>:DATA:VALues`` \n
Snippet: ``value: float = driver.tdrt.signal.data.values.get(start = 1, size = 1, tdRtSignal = repcap.TdRtSignal.Default)`` \n
Returns the data of the waveform points for transmission from the instrument to the controlling computer. The data can be
used in MATLAB, for example. Without parameters, the complete waveform is retrieved. Using the offset and length
parameters, data can be retrieved in smaller portions, which makes the command faster. To set the export format, use
method ``RsRtx.formatPy.data.set()`` .
:param start: Number of offset waveform points.
:param size: Number of waveform points to be retrieved.
:param tdRtSignal: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Signal')
"""
param = ArgSingleList().compose_cmd_string(ArgSingle('start', start, DataType.Integer, None, is_optional=True), ArgSingle('size', size, DataType.Integer, None, is_optional=True))
tdRtSignal_cmd_val = self._cmd_group.get_repcap_cmd_value(tdRtSignal, repcap.TdRtSignal)
response = self._core.io.query_str(f'TDRT:SIGNal{tdRtSignal_cmd_val}:DATA:VALues? {param}'.rstrip())
return Conversions.str_to_float(response)