levelmeter¶
List of supported commands:
-
class
nardascripting.base.scpi.levelmeter.
ScpiLevelmeter
(com: nardascripting.base.comm.CommBase)¶ SignalShark LEVelmeter SCPI subsystem class.
-
get_cbw
()¶ Queries the channel bandwidth for levelmeter
- Returns
Channel Bandwidth in Hz
- Return type
float
-
get_cbw_filter_type
()¶ Queries the levelmeter CBW filter type
- Returns
Filter type (Channel, MIL, CISPR)
- Return type
-
get_cbw_list
()¶ Queries a list of possible CBW settings
- Returns
List of CBWs
- Return type
list
-
get_cbw_oversampling
()¶ Queries the levelmeter oversampling state
- Returns
Oversampling
- Return type
bool
-
get_data_afc
()¶ Queries AFC data values
- Returns
FTune correction in Hz; Offset frequency in Hz
- Return type
float, float
-
get_data_detector
(number: int)¶ Queries the levelmeter detector value (PPk, CPk, RMS, CRMS, MPk, Smp, Avg, CAvg)
- Parameters
number (int) – Detector Number 1…3
- Returns
Detector value; Detector min/max value
- Return type
float, float
-
get_data_detector_modulation
()¶ Queries the levelmeter modulation detector values (AM_PPk, AM_MPk, AM_PPdiv2, AM_RMS, FM_PPk, FM_MPk, FM_PPdiv2, FM_RMS, PM_PPk, PM_MPk, PM_PPdiv2, PM_RMS)
- Returns
ModDetValue
- Return type
list
-
get_data_update
(scan_number=-1, timeout=3.0)¶ Synchronization command, that waits for new levelmeter results.
- Parameters
scan_number (Integer number) – ScanNumber of last queried measurement data. The command forces an update, if not set.
timeout (Float number) – Timeout value for update data in seconds
- Returns
ScanNumber of current measurement data or -1 if error.
- Return type
Integer number
note:: Update is only available in RUN and HOLD state!
-
get_data_update_stop
(scan_number=-1, timeout=3.0)¶ Synchronization command, that waits for new bearing results and stops measurement if new bearing results are available.
- Parameters
scan_number (Integer number) – ScanNumber of last queried measurement data. The command forces an update, if not set.
timeout (Float number) – Timeout value for update data in seconds
- Returns
ScanNumber of current measurement data or -1 if error.
- Return type
Integer number
note:: Update is only available in RUN and HOLD state!
-
get_detector
(number: int)¶ Queries the detector configuration
- Parameters
number (int) – Detector Number 1…3
- Returns
Detector1 (Off, PPk, CPk), Detector2 (Off, RMS, CRMS), Detector3 (Off, MPk, Smp, Avg, CAvg)
- Return type
-
get_detector_infinite
()¶ Queries the infinite min max detector state
- Returns
Infinite state
- Return type
bool
-
get_detector_modulation
()¶ Queries the modulation detector configuration
- Returns
Detector mode (Off, AM, FM, PM, PPk, MPk, PPdiv2, RMS)
- Return type
-
get_detector_modulation_Unit_string
(mod_detector: nardascripting.base.scpi.enums.ModDetectors) → str¶ Returns the unit string of the given modulation detector.
- Parameters
mod_detector – The modulation detector
- Returns
Returns the unit as string or an empty string.
-
get_frequency_tune
()¶ Queries the levelmeter tune frequency
- Returns
Tune frequency in Hz
- Return type
float
-
get_frequency_tune_center_coupling
()¶ Queries the coupling state of Ftune and Fcent
- Returns
Coupling state
- Return type
bool
-
get_frequency_tune_step
()¶ Queries the tune frequency step for levelmeter
- Returns
Tune frequency step in Hz
- Return type
float
-
get_measurement_time
()¶ Queries the measurement time for levelmeter
- Returns
Measurement time in s
- Return type
float
-
get_post_avg
()¶ Queries the post averaging time
- Returns
Post averaging time in s
- Return type
float
-
get_pre_avg
()¶ Queries the pre averaging time
- Returns
Pre averaging time in s, 0 = OFF
- Return type
float
-
get_scan_count
()¶ Queries the levelmeter scan count
- Returns
Scan count
- Return type
int
-
get_scan_number
()¶ Queries the levelmeter scan number
- Returns
Scan number
- Return type
int
-
get_tstamp_raw
()¶ Queries levelmeter data timestamp
- Returns
Timestamp Sync Flag; Seconds since 1.1.1970 0:00 Greenwich Mean Time; Nanoseconds fractional part
- Return type
bool, int, int
-
set_cbw
(value: float)¶ Sets the channel bandwidth for levelmeter
- Parameters
value (float) – Channel Bandwidth (Hz)
-
set_cbw_filter_type
(value: nardascripting.base.scpi.enums.CbwFilterTypes)¶ Sets the levelmeter CBW filter type
- Parameters
value (CbwFilterTypes) – Filter type (Channel, MIL, CISPR)
-
set_cbw_oversampling
(value: bool)¶ Sets the levelmeter oversampling state
- Parameters
value (bool) – Oversampling
-
set_detector
(number: int, mode: nardascripting.base.scpi.enums.LevDetectorModes)¶ Detector configuration
- Parameters
number (int) – Detector Number 1…3
mode (LevDetectorModes) – Detector1 (Off, PPk, CPk), Detector2 (Off, RMS, CRMS), Detector3 (Off, MPk, Smp, Avg, CAvg)
-
set_detector_infinite
(value: bool)¶ Sets the infinite min max detector state
- Parameters
value (bool) – Infinite state
-
set_detector_modulation
(mode: nardascripting.base.scpi.enums.DetectorModConfigs)¶ Modulation detector configuration
- Parameters
mode (DetectorModConfigs) – Detector mode (Off, AM, FM, PM, PPk, MPk, PPdiv2, RMS)
-
set_frequency_tune
(value: float)¶ Sets the levelmeter tune frequency
- Parameters
value (float) – Tune frequency (Hz)
-
set_frequency_tune_center_coupling
(value: bool)¶ Automatic coupling of Ftune and Fcent
- Parameters
value (bool) – Coupling state
-
set_frequency_tune_step
(value: float)¶ Tune frequency step for levelmeter
- Parameters
value (float) – Tune frequency step (Hz)
-
set_measurement_time
(value: float)¶ Sets the measurement time for levelmeter
- Parameters
value (float) – Measurement time (s)
-
set_post_avg
(value: float)¶ Sets the post averaging time for levelmeter
- Parameters
value (float) – Post averaging time (s)
-
set_pre_avg
(value: float)¶ Sets the pre averaging time for levelmeter
- Parameters
value (float) – Pre averaging time (s), 0 = OFF
-
set_scan_count
(value: int)¶ Sets the levelmeter scan count
- Parameters
value (int) – Scan count
-