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

CbwFilterTypes

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

LevDetectorModes

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

DetectorModConfigs

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()

Queries levelmeter data timestamp

Returns

TimeStamp object

Return type

TimeStamp

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