from ......Internal.Core import Core
from ......Internal.CommandsGroup import CommandsGroup
from ......Internal import Conversions
from ...... import enums
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
[docs]class RampCls:
"""Ramp commands group definition. 21 total commands, 5 Subgroups, 10 group commands"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("ramp", core, parent)
@property
def blank(self):
"""blank commands group. 0 Sub-classes, 2 commands."""
if not hasattr(self, '_blank'):
from .Blank import BlankCls
self._blank = BlankCls(self._core, self._cmd_group)
return self._blank
@property
def fall(self):
"""fall commands group. 0 Sub-classes, 1 commands."""
if not hasattr(self, '_fall'):
from .Fall import FallCls
self._fall = FallCls(self._core, self._cmd_group)
return self._fall
@property
def preSweep(self):
"""preSweep commands group. 0 Sub-classes, 3 commands."""
if not hasattr(self, '_preSweep'):
from .PreSweep import PreSweepCls
self._preSweep = PreSweepCls(self._core, self._cmd_group)
return self._preSweep
@property
def stair(self):
"""stair commands group. 2 Sub-classes, 0 commands."""
if not hasattr(self, '_stair'):
from .Stair import StairCls
self._stair = StairCls(self._core, self._cmd_group)
return self._stair
@property
def sweep(self):
"""sweep commands group. 0 Sub-classes, 1 commands."""
if not hasattr(self, '_sweep'):
from .Sweep import SweepCls
self._sweep = SweepCls(self._core, self._cmd_group)
return self._sweep
[docs] def get_attenuation(self) -> float:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:ATTenuation \n
Snippet: value: float = driver.source.bb.pramp.ramp.get_attenuation() \n
Sets the attenuation in constant power sweep mode. \n
:return: const_atten: float Range: 0.01 to 60
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:RAMP:ATTenuation?')
return Conversions.str_to_float(response)
[docs] def set_attenuation(self, const_atten: float) -> None:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:ATTenuation \n
Snippet: driver.source.bb.pramp.ramp.set_attenuation(const_atten = 1.0) \n
Sets the attenuation in constant power sweep mode. \n
:param const_atten: float Range: 0.01 to 60
"""
param = Conversions.decimal_value_to_str(const_atten)
self._core.io.write(f'SOURce<HwInstance>:BB:PRAMp:RAMP:ATTenuation {param}')
[docs] def get_constmode(self) -> bool:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:CONStmode \n
Snippet: value: bool = driver.source.bb.pramp.ramp.get_constmode() \n
Enables power constant mode. \n
:return: constmode: 1| ON| 0| OFF
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:RAMP:CONStmode?')
return Conversions.str_to_bool(response)
[docs] def set_constmode(self, constmode: bool) -> None:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:CONStmode \n
Snippet: driver.source.bb.pramp.ramp.set_constmode(constmode = False) \n
Enables power constant mode. \n
:param constmode: 1| ON| 0| OFF
"""
param = Conversions.bool_to_str(constmode)
self._core.io.write(f'SOURce<HwInstance>:BB:PRAMp:RAMP:CONStmode {param}')
[docs] def get_level(self) -> float:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:LEVel \n
Snippet: value: float = driver.source.bb.pramp.ramp.get_level() \n
Queries the resulting constant power value of the power sweep. \n
:return: const_level: float Range: -145 to 30
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:RAMP:LEVel?')
return Conversions.str_to_float(response)
[docs] def get_range(self) -> float:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:RANGe \n
Snippet: value: float = driver.source.bb.pramp.ramp.get_range() \n
Sets the power sweep range. \n
:return: range_py: float Range: 0.01 to 50, Unit: dB
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:RAMP:RANGe?')
return Conversions.str_to_float(response)
[docs] def set_range(self, range_py: float) -> None:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:RANGe \n
Snippet: driver.source.bb.pramp.ramp.set_range(range_py = 1.0) \n
Sets the power sweep range. \n
:param range_py: float Range: 0.01 to 50, Unit: dB
"""
param = Conversions.decimal_value_to_str(range_py)
self._core.io.write(f'SOURce<HwInstance>:BB:PRAMp:RAMP:RANGe {param}')
[docs] def get_resolution(self) -> float:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:RESolution \n
Snippet: value: float = driver.source.bb.pramp.ramp.get_resolution() \n
Queries the resolution of the power steps. \n
:return: power_resolution: float Range: 0 to 60
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:RAMP:RESolution?')
return Conversions.str_to_float(response)
[docs] def get_sample_rate(self) -> float:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:SAMPlerate \n
Snippet: value: float = driver.source.bb.pramp.ramp.get_sample_rate() \n
Queries the calculated sample rate. \n
:return: sample_rate: float Range: 0 to 20
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:RAMP:SAMPlerate?')
return Conversions.str_to_float(response)
# noinspection PyTypeChecker
[docs] def get_shape(self) -> enums.PowerRampShape:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:SHAPe \n
Snippet: value: enums.PowerRampShape = driver.source.bb.pramp.ramp.get_shape() \n
Selects the power sweep shape. \n
:return: shape: LINear| STAir| TRIangle LINear The sweep curve resembles a sawtooth. STAir The sweep curve resembles a stair step with definable 'Dwell time' or 'Power step', see [:SOURcehw]:BB:PRAMp:RAMP:STAir:DWELl:TIME and [:SOURcehw]:BB:PRAMp:RAMP:STAir:STEP:LEVel. TRIangle The sweep curve resembles a triangle.
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:RAMP:SHAPe?')
return Conversions.str_to_scalar_enum(response, enums.PowerRampShape)
[docs] def set_shape(self, shape: enums.PowerRampShape) -> None:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:SHAPe \n
Snippet: driver.source.bb.pramp.ramp.set_shape(shape = enums.PowerRampShape.LINear) \n
Selects the power sweep shape. \n
:param shape: LINear| STAir| TRIangle LINear The sweep curve resembles a sawtooth. STAir The sweep curve resembles a stair step with definable 'Dwell time' or 'Power step', see [:SOURcehw]:BB:PRAMp:RAMP:STAir:DWELl:TIME and [:SOURcehw]:BB:PRAMp:RAMP:STAir:STEP:LEVel. TRIangle The sweep curve resembles a triangle.
"""
param = Conversions.enum_scalar_to_str(shape, enums.PowerRampShape)
self._core.io.write(f'SOURce<HwInstance>:BB:PRAMp:RAMP:SHAPe {param}')
# noinspection PyTypeChecker
[docs] def get_slope(self) -> enums.PowerRampSlope:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:SLOPe \n
Snippet: value: enums.PowerRampSlope = driver.source.bb.pramp.ramp.get_slope() \n
Sets the slope direction (increasing or decreasing) . \n
:return: slope: ASCending| DESCending
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:RAMP:SLOPe?')
return Conversions.str_to_scalar_enum(response, enums.PowerRampSlope)
[docs] def set_slope(self, slope: enums.PowerRampSlope) -> None:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:SLOPe \n
Snippet: driver.source.bb.pramp.ramp.set_slope(slope = enums.PowerRampSlope.ASCending) \n
Sets the slope direction (increasing or decreasing) . \n
:param slope: ASCending| DESCending
"""
param = Conversions.enum_scalar_to_str(slope, enums.PowerRampSlope)
self._core.io.write(f'SOURce<HwInstance>:BB:PRAMp:RAMP:SLOPe {param}')
[docs] def get_start_level(self) -> float:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:STARtlevel \n
Snippet: value: float = driver.source.bb.pramp.ramp.get_start_level() \n
Queries the start or end power values of the active measurement. \n
:return: start_level: float Range: -145 to 30
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:RAMP:STARtlevel?')
return Conversions.str_to_float(response)
[docs] def get_stop_level(self) -> float:
"""SCPI: [SOURce<HW>]:BB:PRAMp:RAMP:STOPlevel \n
Snippet: value: float = driver.source.bb.pramp.ramp.get_stop_level() \n
Queries the start or end power values of the active measurement. \n
:return: stop_level: float Range: -145 to 30
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:RAMP:STOPlevel?')
return Conversions.str_to_float(response)
def clone(self) -> 'RampCls':
"""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 = RampCls(self._core, self._cmd_group.parent)
self._cmd_group.synchronize_repcaps(new_group)
return new_group