mpylab.device.vlisn module

Compatibility imports for the former V-LISN base-driver module.

class mpylab.device.vlisn.LISN(SearchPaths=None)

Bases: DRIVER

Base class for line impedance stabilization network drivers.

Concrete V- and T-type devices derive from VLISN and TLISN, respectively.

Parameters:

SearchPaths (sequence of path-like, optional) – Directories searched for device INI files and referenced DAT files.

GetChannels()

Return available correction-data channel names.

Returns:

(0, channels) with an immutable sequence of names.

Return type:

tuple

GetData(what)

Return interpolated correction data at the current frequency.

Parameters:

what (str) – Channel name. Matching ignores case and spaces.

Returns:

(status, value); (-1, None) indicates an unknown channel or an unset frequency.

Return type:

tuple

GetDescription()

Return the configured device description.

Returns:

(0, description).

Return type:

tuple

GetFilter()

Return the internal filter-state flag.

Returns:

(0, filter_enabled).

Return type:

tuple

GetFreq()

Return the interpolation frequency.

Returns:

(0, frequency) with a value in hertz, or None before the first call to SetFreq().

Return type:

tuple

GetPath()

Return the selected LISN conductor path.

Returns:

(0, path).

Return type:

tuple

GetVirtual()

Return the runtime virtual-mode flag.

Returns:

(0, virtual).

Return type:

tuple

Init(ini=None, channel=None, ignore_bus=None)

Initialize LISN state and load correction-data channels.

Parameters:

• ini (path-like or file-like) – LISN configuration source.

• channel (int or str, optional) – Initial logical channel passed to the base driver.

• ignore_bus (bool or None, optional) – Skip communication-bus initialization. None selects the passive LISN default of True.

Returns:

Device status; zero indicates success.

Return type:

int

Quit()

Close the LISN driver state.

Returns:

Device status; zero indicates success.

Return type:

int

SetFilter(state)

Set the internal filter-state flag.

Parameters:

state (bool or str) – Value accepted by mpylab.tools.configuration.strbool().

Returns:

(0, filter_enabled).

Return type:

tuple

SetFreq(freq)

Set the interpolation frequency.

Parameters:

freq (float) – Frequency in hertz; it must be finite and non-negative.

Returns:

(0, frequency).

Return type:

tuple

SetVirtual(virtual)

Set the runtime virtual-mode flag.

Parameters:

virtual (bool or str) – Value accepted by mpylab.tools.configuration.strbool().

Returns:

Device status; zero indicates success.

Return type:

int

conftmpl = {'channel_%d': {'file': <function _file_source>, 'interpolation': <class 'str'>, 'name': <class 'str'>, 'unit': <class 'str'>}, 'description': {'description': <class 'str'>, 'deviceid': <class 'str'>, 'driver': <class 'str'>, 'serialnr': <class 'str'>, 'type': <class 'str'>, 'vendor': <class 'str'>}, 'init_value': {'filter': <function strbool>, 'fstart': <class 'float'>, 'fstep': <class 'float'>, 'fstop': <class 'float'>, 'nr_of_channels': <class 'int'>, 'path': <class 'str'>, 'unit': <class 'str'>, 'virtual': <function strbool>, 'visa': <class 'str'>}}

class mpylab.device.vlisn.TLISN(SearchPaths=None)

Bases: LISN

Base class for T-type LISN drivers.

conftmpl = {'channel_%d': {'file': <function _file_source>, 'interpolation': <class 'str'>, 'name': <class 'str'>, 'unit': <class 'str'>}, 'description': {'description': <class 'str'>, 'deviceid': <class 'str'>, 'driver': <class 'str'>, 'serialnr': <class 'str'>, 'type': <class 'str'>, 'vendor': <class 'str'>}, 'init_value': {'filter': <function strbool>, 'fstart': <class 'float'>, 'fstep': <class 'float'>, 'fstop': <class 'float'>, 'nr_of_channels': <class 'int'>, 'path': <class 'str'>, 'unit': <class 'str'>, 'virtual': <function strbool>, 'visa': <class 'str'>}}

class mpylab.device.vlisn.VLISN(SearchPaths=None)

Bases: LISN

Base class for V-type LISN drivers.

SetPath(path)

Select a V-LISN conductor path after operator confirmation.

Parameters:

path ({"L", "L1", "L2", "L3", "N"}) – Conductor path, matched case-insensitively.

Returns:

(0, path) after the operator confirms manual switching.

Return type:

tuple

conftmpl = {'channel_%d': {'file': <function _file_source>, 'interpolation': <class 'str'>, 'name': <class 'str'>, 'unit': <class 'str'>}, 'description': {'description': <class 'str'>, 'deviceid': <class 'str'>, 'driver': <class 'str'>, 'serialnr': <class 'str'>, 'type': <class 'str'>, 'vendor': <class 'str'>}, 'init_value': {'filter': <function strbool>, 'fstart': <class 'float'>, 'fstep': <class 'float'>, 'fstop': <class 'float'>, 'nr_of_channels': <class 'int'>, 'path': <class 'str'>, 'unit': <class 'str'>, 'virtual': <function strbool>, 'visa': <class 'str'>}}