MultiEval¶
SCPI Commands
CONFigure:GSM:MEASurement<Instance>:MEValuation:TOUT
CONFigure:GSM:MEASurement<Instance>:MEValuation:REPetition
CONFigure:GSM:MEASurement<Instance>:MEValuation:SCONdition
CONFigure:GSM:MEASurement<Instance>:MEValuation:MOEXception
CONFigure:GSM:MEASurement<Instance>:MEValuation:RPMode
CONFigure:GSM:MEASurement<Instance>:MEValuation:FCRange
CONFigure:GSM:MEASurement<Instance>:MEValuation:HDALevel
CONFigure:GSM:MEASurement<Instance>:MEValuation:MSLots
CONFigure:GSM:MEASurement<Instance>:MEValuation:TSEQuence
CONFigure:GSM:MEASurement<Instance>:MEValuation:NBQSearch
CONFigure:GSM:MEASurement<Instance>:MEValuation:ABSearch
CONFigure:GSM:MEASurement<Instance>:MEValuation:MVIew
CONFigure:GSM:MEASurement<Instance>:MEValuation:AMODe
CONFigure:GSM:MEASurement<Instance>:MEValuation:APATtern
CONFigure:GSM:MEASurement<Instance>:MEValuation:GLENgth
CONFigure:GSM:MEASurement<Instance>:MEValuation:PCLMode
CONFigure:GSM:MEASurement<Instance>:MEValuation:PCL
CONFigure:GSM:MEASurement<Instance>:MEValuation:IIOFrames
- class MultiEval[source]
MultiEval commands group definition. 122 total commands, 11 Sub-groups, 18 group commands
- class ApatternStruct[source]
Structure for reading output parameters. Fields:
Slot_0: enums.SlotB: No parameter help available
Slot_1: enums.SlotB: No parameter help available
Slot_2: enums.SlotB: No parameter help available
Slot_3: enums.SlotB: No parameter help available
Slot_4: enums.SlotB: No parameter help available
Slot_5: enums.SlotB: No parameter help available
Slot_6: enums.SlotB: No parameter help available
Slot_7: enums.SlotB: No parameter help available
- class MslotsStruct[source]
Structure for reading output parameters. Fields:
Slot_Offset: int: decimal Start of the measurement interval relative to the GSM frame boundary Range: 0 to 7
Slot_Count: int: decimal Number of slots to be measured Range: 1 to 8
Meas_Slot: int: decimal Slot to be measured for one-slot measurements Range: 0 to 7
- class PclStruct[source]
Structure for reading output parameters. Fields:
Slot_0: int: integer Range: 0 to 31
Slot_1: int: integer Range: 0 to 31
Slot_2: int: integer Range: 0 to 31
Slot_3: int: integer Range: 0 to 31
Slot_4: int: integer Range: 0 to 31
Slot_5: int: integer Range: 0 to 31
Slot_6: int: integer Range: 0 to 31
Slot_7: int: integer Range: 0 to 31
- get_ab_search() → bool[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:ABSearch value: bool = driver.configure.multiEval.get_ab_search()
Enables or disables the access burst measurement.
- return
enable: OFF | ON ON: Enable access burst search OFF: Disable access burst search
- get_amode() → RsCmwGsmMeas.enums.AcquisitionMode[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:AMODe value: enums.AcquisitionMode = driver.configure.multiEval.get_amode()
Selects the method that the R&S CMW uses for frame synchronization.
- return
acquisition_mode: GAP | PATTern GAP: Gap PATTern: Pattern
- get_apattern() → ApatternStruct[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:APATtern value: ApatternStruct = driver.configure.multiEval.get_apattern()
Defines the burst pattern that the R&S CMW expects in the TDMA frames of the received GSM signal. The pattern is used for frame synchronization if the pattern acquisition mode is active (see method RsCmwGsmMeas.Configure.MultiEval.amode) .
- return
structure: for return value, see the help for ApatternStruct structure arguments.
- get_fc_range() → RsCmwGsmMeas.enums.RangeMode[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:FCRange value: enums.RangeMode = driver.configure.multiEval.get_fc_range()
Selects the width of the frequency range that the R&S CMW analyzes to establish time-synchronization with the received signal.
- return
mode: NORMal | WIDE NORMal: Normal frequency range WIDE: Wide frequency range
- get_glength() → int[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:GLENgth value: int = driver.configure.multiEval.get_glength()
Defines the gap length as an integer number of slots. The gap length is used for frame synchronization if the gap acquisition mode is active (see method RsCmwGsmMeas.Configure.MultiEval.amode) .
- return
gap_length: integer Range: 1 slot to 3 slots, Unit: slots
- get_hda_level() → float[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:HDALevel value: float or bool = driver.configure.multiEval.get_hda_level()
Defines a signal level relative to the ‘Expected Nominal Power’ (method RsCmwGsmMeas.Configure.RfSettings.envelopePower) where the two results obtained in a two stage measurement are joined.
- return
high_dyn_ass_level: numeric | ON | OFF Range: -60 dB to -10 dB, Unit: dB Additional parameters: OFF | ON (disables | enables two-shot measurement)
- get_iio_frames() → bool[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:IIOFrames value: bool = driver.configure.multiEval.get_iio_frames()
Enables feature ignore initial off frames to avoid trigger timeout in access burst measurement in idle mode.
- return
ignore: OFF | ON
- get_mo_exception() → bool[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:MOEXception value: bool = driver.configure.multiEval.get_mo_exception()
Specifies whether measurement results that the R&S CMW identifies as faulty or inaccurate are rejected.
- return
meas_on_exception: ON | OFF ON: Results are never rejected OFF: Faulty results are rejected
- get_mslots() → MslotsStruct[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:MSLots value: MslotsStruct = driver.configure.multiEval.get_mslots()
Defines settings for the measured slots. For the combined signal path scenario, useCONFigure:GSM:SIGN<i>:MSLot:UL.
- return
structure: for return value, see the help for MslotsStruct structure arguments.
- get_mview() → List[RsCmwGsmMeas.enums.SlotA][source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:MVIew value: List[enums.SlotA] = driver.configure.multiEval.get_mview()
Defines the expected modulation scheme and burst type in all timeslots and adjusts the power/time template accordingly.
- return
slot: No help available
- get_nbq_search() → bool[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:NBQSearch value: bool = driver.configure.multiEval.get_nbq_search()
Enables or disables the search for 16-QAM-modulated normal bursts.
- return
enable: OFF | ON ON: Enable 16-QAM NB search OFF: Disable 16-QAM NB search
- get_pcl() → PclStruct[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:PCL value: PclStruct = driver.configure.multiEval.get_pcl()
Sets the expected PCL values in all timeslots, to be used in method RsCmwGsmMeas.Configure.MultiEval.pclModePCL. The PCL values are interpreted according to the current GSM band setting (method RsCmwGsmMeas.Configure.band) .
INTRO_CMD_HELP: For the combined signal path scenario, use:
CONFigure:GSM:SIGN<i>:RFSettings:PCL:TCH:CSWitched
CONFigure:GSM:SIGN<i>:RFSettings:CHCCombined:TCH:CSWitched
- return
structure: for return value, see the help for PclStruct structure arguments.
- get_pcl_mode() → RsCmwGsmMeas.enums.PclMode[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:PCLMode value: enums.PclMode = driver.configure.multiEval.get_pcl_mode()
Defines how the R&S CMW determines the PCL of the measured signal.
- return
pcl_mode: AUTO | PCL | SIGNaling AUTO: Estimated PCL PCL: PCL defined via method RsCmwGsmMeas.Configure.MultiEval.pcl SIGNaling: PCL determined by coupled signaling application (combined signal path only)
- get_repetition() → RsCmwGsmMeas.enums.Repeat[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:REPetition value: enums.Repeat = driver.configure.multiEval.get_repetition()
Specifies the repetition mode of the measurement. The repetition mode specifies whether the measurement is stopped after a single shot or repeated continuously. Use CONFigure:..:MEAS<i>:…:SCOunt to determine the number of measurement intervals per single shot.
- return
repetition: SINGleshot | CONTinuous SINGleshot: Single-shot measurement CONTinuous: Continuous measurement
- get_rp_mode() → RsCmwGsmMeas.enums.RefPowerMode[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:RPMode value: enums.RefPowerMode = driver.configure.multiEval.get_rp_mode()
Defines how the reference power, i.e. the 0-dB line in the measurement diagram, is calculated.
- return
ref_power_mode: CURRent | DCOMpensated | AVERage Current, data compensated, average
- get_scondition() → RsCmwGsmMeas.enums.StopCondition[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:SCONdition value: enums.StopCondition = driver.configure.multiEval.get_scondition()
Qualifies whether the measurement is stopped after a failed limit check or continued. SLFail means that the measurement is stopped and reaches the RDY state when one of the results exceeds the limits.
- return
stop_condition: NONE | SLFail NONE: Continue measurement irrespective of the limit check SLFail: Stop measurement on limit failure
- get_timeout() → float[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:TOUT value: float = driver.configure.multiEval.get_timeout()
Defines a timeout for the measurement. The timer is started when the measurement is initiated via a READ or INIT command. It is not started if the measurement is initiated manually ([ON | OFF] key or [RESTART | STOP] key) . When the measurement has completed the first measurement cycle (first single shot) , the statistical depth is reached and the timer is reset. If the first measurement cycle has not been completed when the timer expires, the measurement is stopped. The measurement state changes to RDY. The reliability indicator is set to 1, indicating that a measurement timeout occurred. Still running READ, FETCh or CALCulate commands are completed, returning the available results. At least for some results, there are no values at all or the statistical depth has not been reached. A timeout of 0 s corresponds to an infinite measurement timeout.
- return
timeout: numeric Unit: s
- get_tsequence() → RsCmwGsmMeas.enums.TscA[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:TSEQuence value: enums.TscA = driver.configure.multiEval.get_tsequence()
Selects the training sequence of the analyzed bursts. For the combined signal path scenario, use CONFigure:GSM:SIGN<i>:CELL:BCC.
- return
tsc: OFF | TSC0 | TSC1 | TSC2 | TSC3 | TSC4 | TSC5 | TSC6 | TSC7 | TSCA | DUMM OFF: Analyze all bursts, irrespective of their training sequence TSC0 … TSC7:Analyze bursts with a particular GSM training sequence TSCA: Analyze bursts with any of the GSM training sequences TSC0 to TSC7 DUMMY: Analyze GSM-specific dummy bursts
- set_ab_search(enable: bool) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:ABSearch driver.configure.multiEval.set_ab_search(enable = False)
Enables or disables the access burst measurement.
- param enable
OFF | ON ON: Enable access burst search OFF: Disable access burst search
- set_amode(acquisition_mode: RsCmwGsmMeas.enums.AcquisitionMode) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:AMODe driver.configure.multiEval.set_amode(acquisition_mode = enums.AcquisitionMode.GAP)
Selects the method that the R&S CMW uses for frame synchronization.
- param acquisition_mode
GAP | PATTern GAP: Gap PATTern: Pattern
- set_apattern(value: RsCmwGsmMeas.Implementations.Configure_.MultiEval.MultiEval.ApatternStruct) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:APATtern driver.configure.multiEval.set_apattern(value = ApatternStruct())
Defines the burst pattern that the R&S CMW expects in the TDMA frames of the received GSM signal. The pattern is used for frame synchronization if the pattern acquisition mode is active (see method RsCmwGsmMeas.Configure.MultiEval.amode) .
- param value
see the help for ApatternStruct structure arguments.
- set_fc_range(mode: RsCmwGsmMeas.enums.RangeMode) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:FCRange driver.configure.multiEval.set_fc_range(mode = enums.RangeMode.NORMal)
Selects the width of the frequency range that the R&S CMW analyzes to establish time-synchronization with the received signal.
- param mode
NORMal | WIDE NORMal: Normal frequency range WIDE: Wide frequency range
- set_glength(gap_length: int) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:GLENgth driver.configure.multiEval.set_glength(gap_length = 1)
Defines the gap length as an integer number of slots. The gap length is used for frame synchronization if the gap acquisition mode is active (see method RsCmwGsmMeas.Configure.MultiEval.amode) .
- param gap_length
integer Range: 1 slot to 3 slots, Unit: slots
- set_hda_level(high_dyn_ass_level: float) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:HDALevel driver.configure.multiEval.set_hda_level(high_dyn_ass_level = 1.0)
Defines a signal level relative to the ‘Expected Nominal Power’ (method RsCmwGsmMeas.Configure.RfSettings.envelopePower) where the two results obtained in a two stage measurement are joined.
- param high_dyn_ass_level
numeric | ON | OFF Range: -60 dB to -10 dB, Unit: dB Additional parameters: OFF | ON (disables | enables two-shot measurement)
- set_iio_frames(ignore: bool) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:IIOFrames driver.configure.multiEval.set_iio_frames(ignore = False)
Enables feature ignore initial off frames to avoid trigger timeout in access burst measurement in idle mode.
- param ignore
OFF | ON
- set_mo_exception(meas_on_exception: bool) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:MOEXception driver.configure.multiEval.set_mo_exception(meas_on_exception = False)
Specifies whether measurement results that the R&S CMW identifies as faulty or inaccurate are rejected.
- param meas_on_exception
ON | OFF ON: Results are never rejected OFF: Faulty results are rejected
- set_mslots(value: RsCmwGsmMeas.Implementations.Configure_.MultiEval.MultiEval.MslotsStruct) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:MSLots driver.configure.multiEval.set_mslots(value = MslotsStruct())
Defines settings for the measured slots. For the combined signal path scenario, useCONFigure:GSM:SIGN<i>:MSLot:UL.
- param value
see the help for MslotsStruct structure arguments.
- set_mview(slot: List[RsCmwGsmMeas.enums.SlotA]) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:MVIew driver.configure.multiEval.set_mview(slot = [SlotA.ACCess, SlotA.Q16])
Defines the expected modulation scheme and burst type in all timeslots and adjusts the power/time template accordingly.
- param slot
ANY | OFF | GMSK | EPSK | ACCess | Q16 ANY: Any burst type can be analyzed OFF: No signal expected GMSK: GMSK-modulated normal bursts EPSK: 8PSK-modulated normal bursts ACCess: Access bursts Q16: 16-QAM-modulated normal bursts
- set_nbq_search(enable: bool) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:NBQSearch driver.configure.multiEval.set_nbq_search(enable = False)
Enables or disables the search for 16-QAM-modulated normal bursts.
- param enable
OFF | ON ON: Enable 16-QAM NB search OFF: Disable 16-QAM NB search
- set_pcl(value: RsCmwGsmMeas.Implementations.Configure_.MultiEval.MultiEval.PclStruct) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:PCL driver.configure.multiEval.set_pcl(value = PclStruct())
Sets the expected PCL values in all timeslots, to be used in method RsCmwGsmMeas.Configure.MultiEval.pclModePCL. The PCL values are interpreted according to the current GSM band setting (method RsCmwGsmMeas.Configure.band) .
INTRO_CMD_HELP: For the combined signal path scenario, use:
CONFigure:GSM:SIGN<i>:RFSettings:PCL:TCH:CSWitched
CONFigure:GSM:SIGN<i>:RFSettings:CHCCombined:TCH:CSWitched
- param value
see the help for PclStruct structure arguments.
- set_pcl_mode(pcl_mode: RsCmwGsmMeas.enums.PclMode) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:PCLMode driver.configure.multiEval.set_pcl_mode(pcl_mode = enums.PclMode.AUTO)
Defines how the R&S CMW determines the PCL of the measured signal.
- param pcl_mode
AUTO | PCL | SIGNaling AUTO: Estimated PCL PCL: PCL defined via method RsCmwGsmMeas.Configure.MultiEval.pcl SIGNaling: PCL determined by coupled signaling application (combined signal path only)
- set_repetition(repetition: RsCmwGsmMeas.enums.Repeat) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:REPetition driver.configure.multiEval.set_repetition(repetition = enums.Repeat.CONTinuous)
Specifies the repetition mode of the measurement. The repetition mode specifies whether the measurement is stopped after a single shot or repeated continuously. Use CONFigure:..:MEAS<i>:…:SCOunt to determine the number of measurement intervals per single shot.
- param repetition
SINGleshot | CONTinuous SINGleshot: Single-shot measurement CONTinuous: Continuous measurement
- set_rp_mode(ref_power_mode: RsCmwGsmMeas.enums.RefPowerMode) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:RPMode driver.configure.multiEval.set_rp_mode(ref_power_mode = enums.RefPowerMode.AVERage)
Defines how the reference power, i.e. the 0-dB line in the measurement diagram, is calculated.
- param ref_power_mode
CURRent | DCOMpensated | AVERage Current, data compensated, average
- set_scondition(stop_condition: RsCmwGsmMeas.enums.StopCondition) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:SCONdition driver.configure.multiEval.set_scondition(stop_condition = enums.StopCondition.NONE)
Qualifies whether the measurement is stopped after a failed limit check or continued. SLFail means that the measurement is stopped and reaches the RDY state when one of the results exceeds the limits.
- param stop_condition
NONE | SLFail NONE: Continue measurement irrespective of the limit check SLFail: Stop measurement on limit failure
- set_timeout(timeout: float) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:TOUT driver.configure.multiEval.set_timeout(timeout = 1.0)
Defines a timeout for the measurement. The timer is started when the measurement is initiated via a READ or INIT command. It is not started if the measurement is initiated manually ([ON | OFF] key or [RESTART | STOP] key) . When the measurement has completed the first measurement cycle (first single shot) , the statistical depth is reached and the timer is reset. If the first measurement cycle has not been completed when the timer expires, the measurement is stopped. The measurement state changes to RDY. The reliability indicator is set to 1, indicating that a measurement timeout occurred. Still running READ, FETCh or CALCulate commands are completed, returning the available results. At least for some results, there are no values at all or the statistical depth has not been reached. A timeout of 0 s corresponds to an infinite measurement timeout.
- param timeout
numeric Unit: s
- set_tsequence(tsc: RsCmwGsmMeas.enums.TscA) → None[source]
# SCPI: CONFigure:GSM:MEASurement<Instance>:MEValuation:TSEQuence driver.configure.multiEval.set_tsequence(tsc = enums.TscA.DUMM)
Selects the training sequence of the analyzed bursts. For the combined signal path scenario, use CONFigure:GSM:SIGN<i>:CELL:BCC.
- param tsc
OFF | TSC0 | TSC1 | TSC2 | TSC3 | TSC4 | TSC5 | TSC6 | TSC7 | TSCA | DUMM OFF: Analyze all bursts, irrespective of their training sequence TSC0 … TSC7:Analyze bursts with a particular GSM training sequence TSCA: Analyze bursts with any of the GSM training sequences TSC0 to TSC7 DUMMY: Analyze GSM-specific dummy bursts
Cloning the Group
# Create a clone of the original group, that exists independently
group2 = driver.configure.multiEval.clone()
Subgroups