Proxy objects (cdl.proxy)#

Remote proxy#

The remote proxy is used when DataLab is started from a different process than the proxy. In this case, the proxy connects to DataLab XML-RPC server.

class cdl.proxy.RemoteProxy(autoconnect: bool = True)[source]#

DataLab remote proxy class.

This class provides access to DataLab features from a proxy class. This is the remote version of proxy, which is used when DataLab is started from a different process than the proxy.

Paramètres:

autoconnect (bool) – Automatically connect to DataLab XML-RPC server.

Lève:

• ConnectionRefusedError – Unable to connect to DataLab

• ValueError – Invalid timeout (must be >= 0.0)

• ValueError – Invalid number of retries (must be >= 1)

Note

The proxy object also allows to access DataLab computing methods exposed by the processor classes (see Calling processor methods using proxy objects).

Exemples

Here is a simple example of how to use RemoteProxy in a Python script or in a Jupyter notebook:

>>> from cdl.proxy import RemoteProxy
>>> proxy = RemoteProxy()
Connecting to DataLab XML-RPC server...OK (port: 28867)
>>> proxy.get_version()
'1.0.0'
>>> proxy.add_signal("toto", np.array([1., 2., 3.]), np.array([4., 5., -1.]))
True
>>> proxy.get_object_titles()
['toto']
>>> proxy["toto"]  # from title
<cdl.core.model.signal.SignalObj at 0x7f7f1c0b4a90>
>>> proxy[1]  # from number
<cdl.core.model.signal.SignalObj at 0x7f7f1c0b4a90>
>>> proxy[1].data
array([1., 2., 3.])
>>> proxy.set_current_panel("image")

add_annotations_from_items(items: list, refresh_plot: bool = True, panel: str | None = None) → None#

Add object annotations (annotation plot items).

Paramètres:

• items – annotation plot items

• refresh_plot – refresh plot. Defaults to True.

• panel – panel name (valid values: « signal », « image »). If None, current panel is used.

add_group(title: str, panel: str | None = None, select: bool = False) → None#

Add group to DataLab.

Paramètres:

• title – Group title

• panel – Panel name (valid values: « signal », « image »). Defaults to None.

• select – Select the group after creation. Defaults to False.

add_image(title: str, data: ndarray, xunit: str | None = None, yunit: str | None = None, zunit: str | None = None, xlabel: str | None = None, ylabel: str | None = None, zlabel: str | None = None) → bool#

Add image data to DataLab.

Paramètres:

• title – Image title

• data – Image data

• xunit – X unit. Defaults to None.

• yunit – Y unit. Defaults to None.

• zunit – Z unit. Defaults to None.

• xlabel – X label. Defaults to None.

• ylabel – Y label. Defaults to None.

• zlabel – Z label. Defaults to None.

Renvoie:

True if image was added successfully, False otherwise

Lève:

ValueError – Invalid data dtype

add_label_with_title(title: str | None = None, panel: str | None = None) → None#

Add a label with object title on the associated plot

Paramètres:

• title – Label title. Defaults to None. If None, the title is the object title.

• panel – panel name (valid values: « signal », « image »). If None, current panel is used.

add_object(obj: SignalObj | ImageObj) → None#

Add object to DataLab.

Paramètres:

obj – Signal or image object

add_signal(title: str, xdata: ndarray, ydata: ndarray, xunit: str | None = None, yunit: str | None = None, xlabel: str | None = None, ylabel: str | None = None) → bool#

Add signal data to DataLab.

Paramètres:

• title – Signal title

• xdata – X data

• ydata – Y data

• xunit – X unit. Defaults to None.

• yunit – Y unit. Defaults to None.

• xlabel – X label. Defaults to None.

• ylabel – Y label. Defaults to None.

Renvoie:

True if signal was added successfully, False otherwise

Lève:

• ValueError – Invalid xdata dtype

• ValueError – Invalid ydata dtype

calc(name: str, param: DataSet | None = None) → None#

Call compute function name in current panel’s processor.

Paramètres:

• name – Compute function name

• param – Compute function parameter. Defaults to None.

Lève:

ValueError – unknown function

close_application() → None#

Close DataLab application

connect(port: str | None = None, timeout: float | None = None, retries: int | None = None) → None#

Try to connect to DataLab XML-RPC server.

Paramètres:

• port – XML-RPC port to connect to. If not specified, the port is automatically retrieved from DataLab configuration.

• timeout – Timeout in seconds. Defaults to 5.0.

• retries – Number of retries. Defaults to 10.

Lève:

• ConnectionRefusedError – Unable to connect to DataLab

• ValueError – Invalid timeout (must be >= 0.0)

• ValueError – Invalid number of retries (must be >= 1)

context_no_refresh() → Generator[None, None, None]#

Return a context manager to temporarily disable auto refresh.

Renvoie:

Context manager

Exemple

>>> with proxy.context_no_refresh():
...     proxy.add_image("image1", data1)
...     proxy.compute_fft()
...     proxy.compute_wiener()
...     proxy.compute_ifft()
...     # Auto refresh is disabled during the above operations

delete_metadata(refresh_plot: bool = True, keep_roi: bool = False) → None#

Delete metadata of selected objects

Paramètres:

• refresh_plot – Refresh plot. Defaults to True.

• keep_roi – Keep ROI. Defaults to False.

disconnect() → None#

Disconnect from DataLab XML-RPC server.

get_current_panel() → str#

Return current panel name.

Renvoie:

« signal », « image », « macro »))

Type renvoyé:

Panel name (valid values

get_group_titles_with_object_infos() → tuple[list[str], list[list[str]], list[list[str]]]#

Return groups titles and lists of inner objects uuids and titles.

Renvoie:

groups titles, lists of inner objects uuids and titles

Type renvoyé:

Tuple

get_method_list() → list[str]#

Return list of available methods.

get_object(nb_id_title: int | str | None = None, panel: str | None = None) → SignalObj | ImageObj#

Get object (signal/image) from index.

Paramètres:

• nb_id_title – Object number, or object id, or object title. Defaults to None (current object).

• panel – Panel name. Defaults to None (current panel).

Renvoie:

Object

Lève:

KeyError – if object not found

get_object_shapes(nb_id_title: int | str | None = None, panel: str | None = None) → list#

Get plot item shapes associated to object (signal/image).

Paramètres:

• nb_id_title – Object number, or object id, or object title. Defaults to None (current object).

• panel – Panel name. Defaults to None (current panel).

Renvoie:

List of plot item shapes

get_object_titles(panel: str | None = None) → list[str]#

Get object (signal/image) list for current panel. Objects are sorted by group number and object index in group.

Paramètres:

panel – panel name (valid values: « signal », « image », « macro »). If None, current data panel is used (i.e. signal or image panel).

Renvoie:

List of object titles

Lève:

ValueError – if panel not found

get_object_uuids(panel: str | None = None, group: int | str | None = None) → list[str]#

Get object (signal/image) uuid list for current panel. Objects are sorted by group number and object index in group.

Paramètres:

• panel – panel name (valid values: « signal », « image »). If None, current panel is used.

• group – Group number, or group id, or group title. Defaults to None (all groups).

Renvoie:

List of object uuids

Lève:

ValueError – if panel not found

classmethod get_public_methods() → list[str]#

Return all public methods of the class, except itself.

Renvoie:

List of public methods

get_sel_object_uuids(include_groups: bool = False) → list[str]#

Return selected objects uuids.

Paramètres:

include_groups – If True, also return objects from selected groups.

Renvoie:

List of selected objects uuids.

get_version() → str#

Return DataLab public version.

Renvoie:

DataLab version

import_h5_file(filename: str, reset_all: bool | None = None) → None#

Open DataLab HDF5 browser to Import HDF5 file.

Paramètres:

• filename – HDF5 file name

• reset_all – Reset all application data. Defaults to None.

import_macro_from_file(filename: str) → None#

Import macro from file

Paramètres:

filename – Filename.

is_connected() → bool#

Return True if connected to DataLab XML-RPC server.

load_from_directory(path: str) → None#

Open objects from directory in current panel (signals/images).

Paramètres:

path – directory path

load_from_files(filenames: list[str]) → None#

Open objects from files in current panel (signals/images).

Paramètres:

filenames – list of file names

open_h5_files(h5files: list[str] | None = None, import_all: bool | None = None, reset_all: bool | None = None) → None#

Open a DataLab HDF5 file or import from any other HDF5 file.

Paramètres:

• h5files – List of HDF5 files to open. Defaults to None.

• import_all – Import all objects from HDF5 files. Defaults to None.

• reset_all – Reset all application data. Defaults to None.

raise_window() → None#

Raise DataLab window

reset_all() → None#

Reset all application data

run_macro(number_or_title: int | str | None = None) → None#

Run macro.

Paramètres:

number_or_title – Macro number, or macro title. Defaults to None (current macro).

Lève:

ValueError – if macro not found

save_to_h5_file(filename: str) → None#

Save to a DataLab HDF5 file.

Paramètres:

filename – HDF5 file name

select_groups(selection: list[int | str] | None = None, panel: str | None = None) → None#

Select groups in current panel.

Paramètres:

• selection – List of group numbers (1 to N), or list of group uuids, or None to select all groups. Defaults to None.

• panel – panel name (valid values: « signal », « image »). If None, current panel is used. Defaults to None.

select_objects(selection: list[int | str], panel: str | None = None) → None#

Select objects in current panel.

Paramètres:

• selection – List of object numbers (1 to N) or uuids to select

• panel – panel name (valid values: « signal », « image »). If None, current panel is used. Defaults to None.

set_current_panel(panel: str) → None#

Switch to panel.

Paramètres:

panel – Panel name (valid values: « signal », « image », « macro »))

stop_macro(number_or_title: int | str | None = None) → None#

Stop macro.

Paramètres:

number_or_title – Macro number, or macro title. Defaults to None (current macro).

Lève:

ValueError – if macro not found

toggle_auto_refresh(state: bool) → None#

Toggle auto refresh state.

Paramètres:

state – Auto refresh state

toggle_show_titles(state: bool) → None#

Toggle show titles state.

Paramètres:

state – Show titles state

Local proxy#

The local proxy is used when DataLab is started from the same process as the proxy. In this case, the proxy is directly connected to DataLab main window instance. The typical use case is high-level scripting.

class cdl.proxy.LocalProxy(cdl: CDLMainWindow | ServerProxy | None = None)[source]#

DataLab local proxy class.

This class provides access to DataLab features from a proxy class. This is the local version of proxy, which is used when DataLab is started from the same process as the proxy.

Paramètres:

cdl (CDLMainWindow) – CDLMainWindow instance.

Note

The proxy object also allows to access DataLab computing methods exposed by the processor classes (see Calling processor methods using proxy objects).

add_signal(title: str, xdata: ndarray, ydata: ndarray, xunit: str | None = None, yunit: str | None = None, xlabel: str | None = None, ylabel: str | None = None) → bool[source]#

Add signal data to DataLab.

Paramètres:

• title (str) – Signal title

• xdata (numpy.ndarray) – X data

• ydata (numpy.ndarray) – Y data

• xunit (str | None) – X unit. Defaults to None.

• yunit (str | None) – Y unit. Defaults to None.

• xlabel (str | None) – X label. Defaults to None.

• ylabel (str | None) – Y label. Defaults to None.

Renvoie:

True if signal was added successfully, False otherwise

Type renvoyé:

bool

Lève:

• ValueError – Invalid xdata dtype

• ValueError – Invalid ydata dtype

add_image(title: str, data: ndarray, xunit: str | None = None, yunit: str | None = None, zunit: str | None = None, xlabel: str | None = None, ylabel: str | None = None, zlabel: str | None = None) → bool[source]#

Add image data to DataLab.

Paramètres:

• title (str) – Image title

• data (numpy.ndarray) – Image data

• xunit (str | None) – X unit. Defaults to None.

• yunit (str | None) – Y unit. Defaults to None.

• zunit (str | None) – Z unit. Defaults to None.

• xlabel (str | None) – X label. Defaults to None.

• ylabel (str | None) – Y label. Defaults to None.

• zlabel (str | None) – Z label. Defaults to None.

Renvoie:

True if image was added successfully, False otherwise

Type renvoyé:

bool

Lève:

ValueError – Invalid data dtype

add_object(obj: SignalObj | ImageObj) → None[source]#

Add object to DataLab.

Paramètres:

obj (SignalObj | ImageObj) – Signal or image object

calc(name: str, param: DataSet | None = None) → None[source]#

Call compute function name in current panel’s processor.

Paramètres:

• name – Compute function name

• param – Compute function parameter. Defaults to None.

Lève:

ValueError – unknown function

get_object(nb_id_title: int | str | None = None, panel: str | None = None) → SignalObj | ImageObj[source]#

Get object (signal/image) from index.

Paramètres:

• nb_id_title – Object number, or object id, or object title. Defaults to None (current object).

• panel – Panel name. Defaults to None (current panel).

Renvoie:

Object

Lève:

KeyError – if object not found

get_object_shapes(nb_id_title: int | str | None = None, panel: str | None = None) → list[source]#

Get plot item shapes associated to object (signal/image).

Paramètres:

• nb_id_title – Object number, or object id, or object title. Defaults to None (current object).

• panel – Panel name. Defaults to None (current panel).

Renvoie:

List of plot item shapes

add_annotations_from_items(items: list, refresh_plot: bool = True, panel: str | None = None) → None[source]#

Add object annotations (annotation plot items).

Paramètres:

• items (list) – annotation plot items

• refresh_plot (bool | None) – refresh plot. Defaults to True.

• panel (str | None) – panel name (valid values: « signal », « image »). If None, current panel is used.

add_group(title: str, panel: str | None = None, select: bool = False) → None#

Add group to DataLab.

Paramètres:

• title – Group title

• panel – Panel name (valid values: « signal », « image »). Defaults to None.

• select – Select the group after creation. Defaults to False.

add_label_with_title(title: str | None = None, panel: str | None = None) → None#

Add a label with object title on the associated plot

Paramètres:

• title – Label title. Defaults to None. If None, the title is the object title.

• panel – panel name (valid values: « signal », « image »). If None, current panel is used.

close_application() → None#

Close DataLab application

context_no_refresh() → Generator[None, None, None]#

Return a context manager to temporarily disable auto refresh.

Renvoie:

Context manager

Exemple

>>> with proxy.context_no_refresh():
...     proxy.add_image("image1", data1)
...     proxy.compute_fft()
...     proxy.compute_wiener()
...     proxy.compute_ifft()
...     # Auto refresh is disabled during the above operations

delete_metadata(refresh_plot: bool = True, keep_roi: bool = False) → None#

Delete metadata of selected objects

Paramètres:

• refresh_plot – Refresh plot. Defaults to True.

• keep_roi – Keep ROI. Defaults to False.

get_current_panel() → str#

Return current panel name.

Renvoie:

« signal », « image », « macro »))

Type renvoyé:

Panel name (valid values

get_group_titles_with_object_infos() → tuple[list[str], list[list[str]], list[list[str]]]#

Return groups titles and lists of inner objects uuids and titles.

Renvoie:

groups titles, lists of inner objects uuids and titles

Type renvoyé:

Tuple

get_object_titles(panel: str | None = None) → list[str]#

Get object (signal/image) list for current panel. Objects are sorted by group number and object index in group.

Paramètres:

panel – panel name (valid values: « signal », « image », « macro »). If None, current data panel is used (i.e. signal or image panel).

Renvoie:

List of object titles

Lève:

ValueError – if panel not found

get_object_uuids(panel: str | None = None, group: int | str | None = None) → list[str]#

Get object (signal/image) uuid list for current panel. Objects are sorted by group number and object index in group.

Paramètres:

• panel – panel name (valid values: « signal », « image »). If None, current panel is used.

• group – Group number, or group id, or group title. Defaults to None (all groups).

Renvoie:

List of object uuids

Lève:

ValueError – if panel not found

classmethod get_public_methods() → list[str]#

Return all public methods of the class, except itself.

Renvoie:

List of public methods

get_sel_object_uuids(include_groups: bool = False) → list[str]#

Return selected objects uuids.

Paramètres:

include_groups – If True, also return objects from selected groups.

Renvoie:

List of selected objects uuids.

get_version() → str#

Return DataLab public version.

Renvoie:

DataLab version

import_h5_file(filename: str, reset_all: bool | None = None) → None#

Open DataLab HDF5 browser to Import HDF5 file.

Paramètres:

• filename – HDF5 file name

• reset_all – Reset all application data. Defaults to None.

import_macro_from_file(filename: str) → None#

Import macro from file

Paramètres:

filename – Filename.

load_from_directory(path: str) → None#

Open objects from directory in current panel (signals/images).

Paramètres:

path – directory path

load_from_files(filenames: list[str]) → None#

Open objects from files in current panel (signals/images).

Paramètres:

filenames – list of file names

open_h5_files(h5files: list[str] | None = None, import_all: bool | None = None, reset_all: bool | None = None) → None#

Open a DataLab HDF5 file or import from any other HDF5 file.

Paramètres:

• h5files – List of HDF5 files to open. Defaults to None.

• import_all – Import all objects from HDF5 files. Defaults to None.

• reset_all – Reset all application data. Defaults to None.

raise_window() → None#

Raise DataLab window

reset_all() → None#

Reset all application data

run_macro(number_or_title: int | str | None = None) → None#

Run macro.

Paramètres:

number_or_title – Macro number, or macro title. Defaults to None (current macro).

Lève:

ValueError – if macro not found

save_to_h5_file(filename: str) → None#

Save to a DataLab HDF5 file.

Paramètres:

filename – HDF5 file name

select_groups(selection: list[int | str] | None = None, panel: str | None = None) → None#

Select groups in current panel.

Paramètres:

• selection – List of group numbers (1 to N), or list of group uuids, or None to select all groups. Defaults to None.

• panel – panel name (valid values: « signal », « image »). If None, current panel is used. Defaults to None.

select_objects(selection: list[int | str], panel: str | None = None) → None#

Select objects in current panel.

Paramètres:

• selection – List of object numbers (1 to N) or uuids to select

• panel – panel name (valid values: « signal », « image »). If None, current panel is used. Defaults to None.

set_current_panel(panel: str) → None#

Switch to panel.

Paramètres:

panel – Panel name (valid values: « signal », « image », « macro »))

stop_macro(number_or_title: int | str | None = None) → None#

Stop macro.

Paramètres:

number_or_title – Macro number, or macro title. Defaults to None (current macro).

Lève:

ValueError – if macro not found

toggle_auto_refresh(state: bool) → None#

Toggle auto refresh state.

Paramètres:

state – Auto refresh state

toggle_show_titles(state: bool) → None#

Toggle show titles state.

Paramètres:

state – Show titles state

Proxy context manager#

The proxy context manager is a convenient way to handle proxy creation and destruction. It is used as follows:

with proxy_context("local") as proxy:
    proxy.add_signal(...)

The proxy type can be « local » or « remote ». For remote proxy, the port can be specified as « remote:port ».

cdl.proxy.proxy_context(what: str) → Generator[LocalProxy | RemoteProxy, None, None][source]#

Context manager handling CDL proxy creation and destruction.

Paramètres:

what (str) – proxy type (« local » or « remote ») For remote proxy, the port can be specified as « remote:port »

Yields:

Generator[LocalProxy | RemoteProxy, None, None] –

proxy

LocalProxy if what == « local » RemoteProxy if what == « remote » or « remote:port »

Exemple

with proxy_context(« local ») as proxy:

proxy.add_signal(…)

Calling processor methods using proxy objects#

All the proxy objects provide access to the DataLab computing methods exposed by the processor classes:

• cdl.core.gui.processor.signal.SignalProcessor

• cdl.core.gui.processor.image.ImageProcessor

There are two ways to call a processor method:

1. Using the calc() method of the proxy object:

# Call a method without parameter
proxy.calc("compute_average")

# This is equivalent to:
proxy.calc("average")

# Call a method with parameters
p = cdl.param.MovingAverageParam.create(n=30)
proxy.calc("compute_moving_average", p)

2. Directly calling the processor method from the proxy object:

# Call a method without parameter
proxy.compute_average()

# Call a method with parameters
p = cdl.param.MovingAverageParam.create(n=30)
proxy.compute_moving_average(p)