from ...Internal.Core import Core
from ...Internal.CommandsGroup import CommandsGroup
from ...Internal import Conversions
from ... import enums
from ... import repcap
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
class CategoryCls:
"""
| Commands in total: 1
| Subgroups: 0
| Direct child commands: 1
"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("category", core, parent)
[docs]
def set(self, category: enums.MeasCategory, measurement=repcap.Measurement.Default) -> None:
"""
``MEASurement<*>:CATegory`` \n
Snippet: ``driver.measurement.category.set(category = enums.MeasCategory.AMPTime, measurement = repcap.Measurement.Default)`` \n
Defines the measurement category.
:param category: AMPTime | JITTer | EYEJitter | OPTical | SPECtrum | HISTogram | PROTocol | EMC \n
- AMPTime: Amplitude and time measurements
- JITTer: Jitter measurements, available if one of the jitter options is installed.
- EMC: EMC/ESD test (option R&S RTP-K155)
- EYEJitter: Eye diagram measurements
- OPTical: Optical measurements
- SPECtrum: Spectrum measurements
- HISTogram: Histogram measurements
- PROTocol: Protocol measurements
:param measurement: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Measurement')
"""
param = Conversions.enum_scalar_to_str(category, enums.MeasCategory)
measurement_cmd_val = self._cmd_group.get_repcap_cmd_value(measurement, repcap.Measurement)
self._core.io.write_with_opc(f'MEASurement{measurement_cmd_val}:CATegory {param}')
# noinspection PyTypeChecker
[docs]
def get(self, measurement=repcap.Measurement.Default) -> enums.MeasCategory:
"""
``MEASurement<*>:CATegory`` \n
Snippet: ``value: enums.MeasCategory = driver.measurement.category.get(measurement = repcap.Measurement.Default)`` \n
Defines the measurement category.
:param measurement: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Measurement')
:return: category: AMPTime | JITTer | EYEJitter | OPTical | SPECtrum | HISTogram | PROTocol | EMC \n
- AMPTime: Amplitude and time measurements
- JITTer: Jitter measurements, available if one of the jitter options is installed.
- EMC: EMC/ESD test (option R&S RTP-K155)
- EYEJitter: Eye diagram measurements
- OPTical: Optical measurements
- SPECtrum: Spectrum measurements
- HISTogram: Histogram measurements
- PROTocol: Protocol measurements
"""
measurement_cmd_val = self._cmd_group.get_repcap_cmd_value(measurement, repcap.Measurement)
response = self._core.io.query_str_with_opc(f'MEASurement{measurement_cmd_val}:CATegory?')
return Conversions.str_to_scalar_enum(response, enums.MeasCategory)