from .....Internal.Core import Core
from .....Internal.CommandsGroup import CommandsGroup
from .....Internal import Conversions
from .....Internal.Utilities import trim_str_response
from ..... import enums
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
[docs]class IqRecorderCls:
"""IqRecorder commands group definition. 7 total commands, 1 Subgroups, 6 group commands"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("iqRecorder", core, parent)
@property
def catalog(self):
"""catalog commands group. 0 Sub-classes, 1 commands."""
if not hasattr(self, '_catalog'):
from .Catalog import CatalogCls
self._catalog = CatalogCls(self._core, self._cmd_group)
return self._catalog
[docs] def get_offset(self) -> int:
"""SCPI: TRIGger:GPRF:MEASurement<Instance>:IQRecorder:OFFSet \n
Snippet: value: int = driver.trigger.gprfMeasurement.iqRecorder.get_offset() \n
Delays the start of the measurement relative to the trigger event. This setting is relevant for the trigger source 'IF
Power' and for trigger signals at TRIG IN. \n
:return: trigger_offset: Range: 0 samples to 64E+6 samples
"""
response = self._core.io.query_str('TRIGger:GPRF:MEASurement<Instance>:IQRecorder:OFFSet?')
return Conversions.str_to_int(response)
[docs] def set_offset(self, trigger_offset: int) -> None:
"""SCPI: TRIGger:GPRF:MEASurement<Instance>:IQRecorder:OFFSet \n
Snippet: driver.trigger.gprfMeasurement.iqRecorder.set_offset(trigger_offset = 1) \n
Delays the start of the measurement relative to the trigger event. This setting is relevant for the trigger source 'IF
Power' and for trigger signals at TRIG IN. \n
:param trigger_offset: Range: 0 samples to 64E+6 samples
"""
param = Conversions.decimal_value_to_str(trigger_offset)
self._core.io.write(f'TRIGger:GPRF:MEASurement<Instance>:IQRecorder:OFFSet {param}')
[docs] def get_source(self) -> str:
"""SCPI: TRIGger:GPRF:MEASurement<Instance>:IQRecorder:SOURce \n
Snippet: value: str = driver.trigger.gprfMeasurement.iqRecorder.get_source() \n
Selects a trigger event source for I/Q recorder measurements. To query a list of all supported sources, use method RsCma.
Trigger.GprfMeasurement.IqRecorder.Catalog.source. \n
:return: source: Source as string, examples: 'Free Run' Immediate start without trigger signal 'IF Power' Trigger by IF power steps 'Base1: External TRIG In' Trigger signal at connector TRIG IN 'AFRF Gen1: ...' Trigger by processed waveform file
"""
response = self._core.io.query_str('TRIGger:GPRF:MEASurement<Instance>:IQRecorder:SOURce?')
return trim_str_response(response)
[docs] def set_source(self, source: str) -> None:
"""SCPI: TRIGger:GPRF:MEASurement<Instance>:IQRecorder:SOURce \n
Snippet: driver.trigger.gprfMeasurement.iqRecorder.set_source(source = '1') \n
Selects a trigger event source for I/Q recorder measurements. To query a list of all supported sources, use method RsCma.
Trigger.GprfMeasurement.IqRecorder.Catalog.source. \n
:param source: Source as string, examples: 'Free Run' Immediate start without trigger signal 'IF Power' Trigger by IF power steps 'Base1: External TRIG In' Trigger signal at connector TRIG IN 'AFRF Gen1: ...' Trigger by processed waveform file
"""
param = Conversions.value_to_quoted_str(source)
self._core.io.write(f'TRIGger:GPRF:MEASurement<Instance>:IQRecorder:SOURce {param}')
[docs] def get_mgap(self) -> float:
"""SCPI: TRIGger:GPRF:MEASurement<Instance>:IQRecorder:MGAP \n
Snippet: value: float = driver.trigger.gprfMeasurement.iqRecorder.get_mgap() \n
Defines the minimum duration of the power-down periods (gaps) between two triggered power pulses. This setting is
relevant for trigger source 'IF Power'. \n
:return: minimum_gap: Range: 0 s to 0.01 s, Unit: s
"""
response = self._core.io.query_str('TRIGger:GPRF:MEASurement<Instance>:IQRecorder:MGAP?')
return Conversions.str_to_float(response)
[docs] def set_mgap(self, minimum_gap: float) -> None:
"""SCPI: TRIGger:GPRF:MEASurement<Instance>:IQRecorder:MGAP \n
Snippet: driver.trigger.gprfMeasurement.iqRecorder.set_mgap(minimum_gap = 1.0) \n
Defines the minimum duration of the power-down periods (gaps) between two triggered power pulses. This setting is
relevant for trigger source 'IF Power'. \n
:param minimum_gap: Range: 0 s to 0.01 s, Unit: s
"""
param = Conversions.decimal_value_to_str(minimum_gap)
self._core.io.write(f'TRIGger:GPRF:MEASurement<Instance>:IQRecorder:MGAP {param}')
[docs] def get_timeout(self) -> float or bool:
"""SCPI: TRIGger:GPRF:MEASurement<Instance>:IQRecorder:TOUT \n
Snippet: value: float or bool = driver.trigger.gprfMeasurement.iqRecorder.get_timeout() \n
Specifies the time after which an initiated measurement must have received a trigger event. If no trigger event is
received, the measurement is stopped in remote control mode. In manual operation mode, a trigger timeout is indicated.
This setting is relevant for the trigger source 'IF Power' and for trigger signals at TRIG IN. \n
:return: timeout: (float or boolean) Range: 0.01 s to 300 s, Unit: s
"""
response = self._core.io.query_str('TRIGger:GPRF:MEASurement<Instance>:IQRecorder:TOUT?')
return Conversions.str_to_float_or_bool(response)
[docs] def set_timeout(self, timeout: float or bool) -> None:
"""SCPI: TRIGger:GPRF:MEASurement<Instance>:IQRecorder:TOUT \n
Snippet: driver.trigger.gprfMeasurement.iqRecorder.set_timeout(timeout = 1.0) \n
Specifies the time after which an initiated measurement must have received a trigger event. If no trigger event is
received, the measurement is stopped in remote control mode. In manual operation mode, a trigger timeout is indicated.
This setting is relevant for the trigger source 'IF Power' and for trigger signals at TRIG IN. \n
:param timeout: (float or boolean) Range: 0.01 s to 300 s, Unit: s
"""
param = Conversions.decimal_or_bool_value_to_str(timeout)
self._core.io.write(f'TRIGger:GPRF:MEASurement<Instance>:IQRecorder:TOUT {param}')
[docs] def get_threshold(self) -> float:
"""SCPI: TRIGger:GPRF:MEASurement<Instance>:IQRecorder:THReshold \n
Snippet: value: float = driver.trigger.gprfMeasurement.iqRecorder.get_threshold() \n
Defines the trigger threshold for trigger source 'IF Power'. \n
:return: threshold: Range: -50 dB to 0 dB, Unit: dB (full scale, i.e. relative to expected power minus external attenuation)
"""
response = self._core.io.query_str('TRIGger:GPRF:MEASurement<Instance>:IQRecorder:THReshold?')
return Conversions.str_to_float(response)
[docs] def set_threshold(self, threshold: float) -> None:
"""SCPI: TRIGger:GPRF:MEASurement<Instance>:IQRecorder:THReshold \n
Snippet: driver.trigger.gprfMeasurement.iqRecorder.set_threshold(threshold = 1.0) \n
Defines the trigger threshold for trigger source 'IF Power'. \n
:param threshold: Range: -50 dB to 0 dB, Unit: dB (full scale, i.e. relative to expected power minus external attenuation)
"""
param = Conversions.decimal_value_to_str(threshold)
self._core.io.write(f'TRIGger:GPRF:MEASurement<Instance>:IQRecorder:THReshold {param}')
# noinspection PyTypeChecker
[docs] def get_slope(self) -> enums.SignalSlopeExt:
"""SCPI: TRIGger:GPRF:MEASurement<Instance>:IQRecorder:SLOPe \n
Snippet: value: enums.SignalSlopeExt = driver.trigger.gprfMeasurement.iqRecorder.get_slope() \n
Selects whether the trigger event is generated at the rising or at the falling edge of the trigger pulse. This command is
relevant for the trigger source 'IF Power'. \n
:return: event: REDGe | FEDGe | RISing | FALLing REDGe, RISing Rising edge FEDGe, FALLing Falling edge
"""
response = self._core.io.query_str('TRIGger:GPRF:MEASurement<Instance>:IQRecorder:SLOPe?')
return Conversions.str_to_scalar_enum(response, enums.SignalSlopeExt)
[docs] def set_slope(self, event: enums.SignalSlopeExt) -> None:
"""SCPI: TRIGger:GPRF:MEASurement<Instance>:IQRecorder:SLOPe \n
Snippet: driver.trigger.gprfMeasurement.iqRecorder.set_slope(event = enums.SignalSlopeExt.FALLing) \n
Selects whether the trigger event is generated at the rising or at the falling edge of the trigger pulse. This command is
relevant for the trigger source 'IF Power'. \n
:param event: REDGe | FEDGe | RISing | FALLing REDGe, RISing Rising edge FEDGe, FALLing Falling edge
"""
param = Conversions.enum_scalar_to_str(event, enums.SignalSlopeExt)
self._core.io.write(f'TRIGger:GPRF:MEASurement<Instance>:IQRecorder:SLOPe {param}')
def clone(self) -> 'IqRecorderCls':
"""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 = IqRecorderCls(self._core, self._cmd_group.parent)
self._cmd_group.synchronize_repcaps(new_group)
return new_group