from typing import List
from .........Internal.Core import Core
from .........Internal.CommandsGroup import CommandsGroup
from .........Internal import Conversions
from .........Internal.ArgSingleSuppressed import ArgSingleSuppressed
from .........Internal.Types import DataType
from .........Internal.ArgSingleList import ArgSingleList
from .........Internal.ArgSingle import ArgSingle
from ......... import enums
from ......... import repcap
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
[docs]
class CurrentCls:
"""Current commands group definition. 3 total commands, 0 Subgroups, 3 group commands"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("current", core, parent)
[docs]
def read(self, start: float = None, count: float = None, decimation: float = None, rxAntenna=repcap.RxAntenna.Default, stream=repcap.Stream.Default) -> List[float]:
"""SCPI: READ:WLAN:MEASurement<Instance>:MEValuation:TRACe:SFLatness:MIMO:RXANtenna<n>:STReam<s>:ACARrier:CURRent \n
Snippet: value: List[float] = driver.multiEval.trace.spectrFlatness.mimo.rxAntenna.stream.acarrier.current.read(start = 1.0, count = 1.0, decimation = 1.0, rxAntenna = repcap.RxAntenna.Default, stream = repcap.Stream.Default) \n
Return the spectrum flatness traces over all carriers (complete FFTSize) for Rx antenna <n> and stream <s>, for true MIMO
measurements. The results of the current, average, minimum and maximum traces can be retrieved. The values described
below are returned by FETCh and READ commands. CALCulate commands return limit check results instead, one value for each
result listed below. \n
Use RsCmwWlanMeas.reliability.last_value to read the updated reliability indicator. \n
:param start: numeric For the optional query parameters start, count and decimation, see 'Trace sub-arrays'.
:param count: numeric For the optional query parameters start, count and decimation, see 'Trace sub-arrays'.
:param decimation: numeric For the optional query parameters start, count and decimation, see 'Trace sub-arrays'.
:param rxAntenna: optional repeated capability selector. Default value: Nr1 (settable in the interface 'RxAntenna')
:param stream: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Stream')
:return: sflat_all_carr_tx: float Comma-separated list of power levels, one value per subcarrier (including data, pilot and unused subcarriers) The number of power levels depends on the WLAN standard, channel bandwidth and mode, see Table 'OFDM subcarriers'. Unit: dB"""
param = ArgSingleList().compose_cmd_string(ArgSingle('start', start, DataType.Float, None, is_optional=True), ArgSingle('count', count, DataType.Float, None, is_optional=True), ArgSingle('decimation', decimation, DataType.Float, None, is_optional=True))
rxAntenna_cmd_val = self._cmd_group.get_repcap_cmd_value(rxAntenna, repcap.RxAntenna)
stream_cmd_val = self._cmd_group.get_repcap_cmd_value(stream, repcap.Stream)
suppressed = ArgSingleSuppressed(0, DataType.Integer, False, 1, 'Reliability')
response = self._core.io.query_bin_or_ascii_float_list_suppressed(f'READ:WLAN:MEASurement<Instance>:MEValuation:TRACe:SFLatness:MIMO:RXANtenna{rxAntenna_cmd_val}:STReam{stream_cmd_val}:ACARrier:CURRent? {param}'.rstrip(), suppressed)
return response
[docs]
def fetch(self, start: float = None, count: float = None, decimation: float = None, rxAntenna=repcap.RxAntenna.Default, stream=repcap.Stream.Default) -> List[float]:
"""SCPI: FETCh:WLAN:MEASurement<Instance>:MEValuation:TRACe:SFLatness:MIMO:RXANtenna<n>:STReam<s>:ACARrier:CURRent \n
Snippet: value: List[float] = driver.multiEval.trace.spectrFlatness.mimo.rxAntenna.stream.acarrier.current.fetch(start = 1.0, count = 1.0, decimation = 1.0, rxAntenna = repcap.RxAntenna.Default, stream = repcap.Stream.Default) \n
Return the spectrum flatness traces over all carriers (complete FFTSize) for Rx antenna <n> and stream <s>, for true MIMO
measurements. The results of the current, average, minimum and maximum traces can be retrieved. The values described
below are returned by FETCh and READ commands. CALCulate commands return limit check results instead, one value for each
result listed below. \n
Use RsCmwWlanMeas.reliability.last_value to read the updated reliability indicator. \n
:param start: numeric For the optional query parameters start, count and decimation, see 'Trace sub-arrays'.
:param count: numeric For the optional query parameters start, count and decimation, see 'Trace sub-arrays'.
:param decimation: numeric For the optional query parameters start, count and decimation, see 'Trace sub-arrays'.
:param rxAntenna: optional repeated capability selector. Default value: Nr1 (settable in the interface 'RxAntenna')
:param stream: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Stream')
:return: sflat_all_carr_tx: float Comma-separated list of power levels, one value per subcarrier (including data, pilot and unused subcarriers) The number of power levels depends on the WLAN standard, channel bandwidth and mode, see Table 'OFDM subcarriers'. Unit: dB"""
param = ArgSingleList().compose_cmd_string(ArgSingle('start', start, DataType.Float, None, is_optional=True), ArgSingle('count', count, DataType.Float, None, is_optional=True), ArgSingle('decimation', decimation, DataType.Float, None, is_optional=True))
rxAntenna_cmd_val = self._cmd_group.get_repcap_cmd_value(rxAntenna, repcap.RxAntenna)
stream_cmd_val = self._cmd_group.get_repcap_cmd_value(stream, repcap.Stream)
suppressed = ArgSingleSuppressed(0, DataType.Integer, False, 1, 'Reliability')
response = self._core.io.query_bin_or_ascii_float_list_suppressed(f'FETCh:WLAN:MEASurement<Instance>:MEValuation:TRACe:SFLatness:MIMO:RXANtenna{rxAntenna_cmd_val}:STReam{stream_cmd_val}:ACARrier:CURRent? {param}'.rstrip(), suppressed)
return response
# noinspection PyTypeChecker
[docs]
def calculate(self, start: float = None, count: float = None, decimation: float = None, rxAntenna=repcap.RxAntenna.Default, stream=repcap.Stream.Default) -> List[enums.ResultStatus2]:
"""SCPI: CALCulate:WLAN:MEASurement<Instance>:MEValuation:TRACe:SFLatness:MIMO:RXANtenna<n>:STReam<s>:ACARrier:CURRent \n
Snippet: value: List[enums.ResultStatus2] = driver.multiEval.trace.spectrFlatness.mimo.rxAntenna.stream.acarrier.current.calculate(start = 1.0, count = 1.0, decimation = 1.0, rxAntenna = repcap.RxAntenna.Default, stream = repcap.Stream.Default) \n
Return the spectrum flatness traces over all carriers (complete FFTSize) for Rx antenna <n> and stream <s>, for true MIMO
measurements. The results of the current, average, minimum and maximum traces can be retrieved. The values described
below are returned by FETCh and READ commands. CALCulate commands return limit check results instead, one value for each
result listed below. \n
Use RsCmwWlanMeas.reliability.last_value to read the updated reliability indicator. \n
:param start: numeric For the optional query parameters start, count and decimation, see 'Trace sub-arrays'.
:param count: numeric For the optional query parameters start, count and decimation, see 'Trace sub-arrays'.
:param decimation: numeric For the optional query parameters start, count and decimation, see 'Trace sub-arrays'.
:param rxAntenna: optional repeated capability selector. Default value: Nr1 (settable in the interface 'RxAntenna')
:param stream: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Stream')
:return: sflat_all_carr_tx: float Comma-separated list of power levels, one value per subcarrier (including data, pilot and unused subcarriers) The number of power levels depends on the WLAN standard, channel bandwidth and mode, see Table 'OFDM subcarriers'. Unit: dB"""
param = ArgSingleList().compose_cmd_string(ArgSingle('start', start, DataType.Float, None, is_optional=True), ArgSingle('count', count, DataType.Float, None, is_optional=True), ArgSingle('decimation', decimation, DataType.Float, None, is_optional=True))
rxAntenna_cmd_val = self._cmd_group.get_repcap_cmd_value(rxAntenna, repcap.RxAntenna)
stream_cmd_val = self._cmd_group.get_repcap_cmd_value(stream, repcap.Stream)
suppressed = ArgSingleSuppressed(0, DataType.Integer, False, 1, 'Reliability')
response = self._core.io.query_str_suppressed(f'CALCulate:WLAN:MEASurement<Instance>:MEValuation:TRACe:SFLatness:MIMO:RXANtenna{rxAntenna_cmd_val}:STReam{stream_cmd_val}:ACARrier:CURRent? {param}'.rstrip(), suppressed)
return Conversions.str_to_list_enum(response, enums.ResultStatus2)