from ....Internal.Core import Core
from ....Internal.CommandsGroup import CommandsGroup
from ....Internal import Conversions
from .... import enums
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
class PrachCls:
"""
| Commands in total: 4
| Subgroups: 0
| Direct child commands: 4
"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("prach", core, parent)
[docs]
def get_threshold(self) -> float | bool:
"""
``TRIGger:NRSub:MEASurement<Instance>:PRACh:THReshold`` \n
Snippet: ``value: float | bool = driver.trigger.nrSubMeas.prach.get_threshold()`` \n
Defines the trigger threshold for power trigger sources.
:return: trig_threshold: (float or boolean) numeric
"""
response = self._core.io.query_str('TRIGger:NRSub:MEASurement<Instance>:PRACh:THReshold?')
return Conversions.str_to_float_or_bool(response)
[docs]
def set_threshold(self, trig_threshold: float | bool) -> None:
"""
``TRIGger:NRSub:MEASurement<Instance>:PRACh:THReshold`` \n
Snippet: ``driver.trigger.nrSubMeas.prach.set_threshold(trig_threshold = 1.0)`` \n
Defines the trigger threshold for power trigger sources.
:param trig_threshold: (float or boolean) numeric
"""
param = Conversions.decimal_or_bool_value_to_str(trig_threshold)
self._core.io.write(f'TRIGger:NRSub:MEASurement<Instance>:PRACh:THReshold {param}')
# noinspection PyTypeChecker
[docs]
def get_slope(self) -> enums.SignalSlope:
"""
``TRIGger:NRSub:MEASurement<Instance>:PRACh:SLOPe`` \n
Snippet: ``value: enums.SignalSlope = driver.trigger.nrSubMeas.prach.get_slope()`` \n
Qualifies whether the trigger event is generated at the rising or at the falling edge of the trigger pulse (valid for
external and power trigger sources) .
:return: slope: REDGe: Rising edge FEDGe: Falling edge
"""
response = self._core.io.query_str('TRIGger:NRSub:MEASurement<Instance>:PRACh:SLOPe?')
return Conversions.str_to_scalar_enum(response, enums.SignalSlope)
[docs]
def set_slope(self, slope: enums.SignalSlope) -> None:
"""
``TRIGger:NRSub:MEASurement<Instance>:PRACh:SLOPe`` \n
Snippet: ``driver.trigger.nrSubMeas.prach.set_slope(slope = enums.SignalSlope.FEDGe)`` \n
Qualifies whether the trigger event is generated at the rising or at the falling edge of the trigger pulse (valid for
external and power trigger sources) .
:param slope: REDGe: Rising edge FEDGe: Falling edge
"""
param = Conversions.enum_scalar_to_str(slope, enums.SignalSlope)
self._core.io.write(f'TRIGger:NRSub:MEASurement<Instance>:PRACh:SLOPe {param}')
[docs]
def get_timeout(self) -> float | bool:
"""
``TRIGger:NRSub:MEASurement<Instance>:PRACh:TOUT`` \n
Snippet: ``value: float | bool = driver.trigger.nrSubMeas.prach.get_timeout()`` \n
Selects the maximum time that the measurement waits for a trigger event before it stops in remote control mode or
indicates a trigger timeout in manual operation mode. This setting has no influence on Free Run measurements.
:return: trigger_timeout: (float or boolean) numeric | ON | OFF
"""
response = self._core.io.query_str('TRIGger:NRSub:MEASurement<Instance>:PRACh:TOUT?')
return Conversions.str_to_float_or_bool(response)
[docs]
def set_timeout(self, trigger_timeout: float | bool) -> None:
"""
``TRIGger:NRSub:MEASurement<Instance>:PRACh:TOUT`` \n
Snippet: ``driver.trigger.nrSubMeas.prach.set_timeout(trigger_timeout = 1.0)`` \n
Selects the maximum time that the measurement waits for a trigger event before it stops in remote control mode or
indicates a trigger timeout in manual operation mode. This setting has no influence on Free Run measurements.
:param trigger_timeout: (float or boolean) numeric | ON | OFF
"""
param = Conversions.decimal_or_bool_value_to_str(trigger_timeout)
self._core.io.write(f'TRIGger:NRSub:MEASurement<Instance>:PRACh:TOUT {param}')
[docs]
def get_mgap(self) -> float:
"""
``TRIGger:NRSub:MEASurement<Instance>:PRACh:MGAP`` \n
Snippet: ``value: float = driver.trigger.nrSubMeas.prach.get_mgap()`` \n
Sets a minimum time during which the IF signal must be below the trigger threshold before the trigger is armed so that an
IF power trigger event can be generated.
:return: min_trig_gap: float
"""
response = self._core.io.query_str('TRIGger:NRSub:MEASurement<Instance>:PRACh:MGAP?')
return Conversions.str_to_float(response)
[docs]
def set_mgap(self, min_trig_gap: float) -> None:
"""
``TRIGger:NRSub:MEASurement<Instance>:PRACh:MGAP`` \n
Snippet: ``driver.trigger.nrSubMeas.prach.set_mgap(min_trig_gap = 1.0)`` \n
Sets a minimum time during which the IF signal must be below the trigger threshold before the trigger is armed so that an
IF power trigger event can be generated.
:param min_trig_gap: float
"""
param = Conversions.decimal_value_to_str(min_trig_gap)
self._core.io.write(f'TRIGger:NRSub:MEASurement<Instance>:PRACh:MGAP {param}')