Fenêtre principale#

Le module cdl.core.gui.main fournit la fenêtre principale du projet DataLab (CDL).

class cdl.core.gui.main.CDLMainWindow(console=None, hide_on_close=False)[source]#

Fenêtre principale de DataLab

Paramètres:

console – activer la console interne
hide_on_close – True pour masquer la fenêtre à la fermeture

static get_instance(console=None, hide_on_close=False)[source]#: Retourne l’instance singleton

static xmlrpc_server_started(port)[source]#: Le serveur XML-RPC a démarré, écriture du port de communication dans le fichier de configuration

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

Retourne les titres des groupes et les listes des uuids et titres des objets internes.

Renvoie:: Groups titles, lists of inner objects uuids and titles

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

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 is unknown

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
TypeError – if index_id_title type is invalid

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

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 is unknown

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

Return selected objects uuids.

Paramètres:: include_groups – If True, also return objects from selected groups.
Renvoie:: List of selected objects uuids.

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

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.

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

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.

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

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.

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

Delete metadata of selected objects

Paramètres:

refresh_plot – Refresh plot. Defaults to True.
keep_roi – Keep ROI. Defaults to False.

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 – annotation plot items
refresh_plot – refresh plot. Defaults to True.
panel – panel name (valid values: « signal », « image »). If None, current panel is used.

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

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.

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

Run macro.

Paramètres:: number – Number of the macro (starting at 1). Defaults to None (run current macro, or does nothing if there is no macro).

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

Stop macro.

Paramètres:: number – Number of the macro (starting at 1). Defaults to None (stop current macro, or does nothing if there is no macro).

import_macro_from_file(filename: str) → None[source]#

Import macro from file

Paramètres:: filename – Filename.

property panels: tuple[AbstractPanel, ...]#

Return the tuple of implemented panels (signal, image)

Renvoie:: Tuple of panels

confirm_memory_state() → bool[source]#

Check memory warning state and eventually show a warning dialog

Renvoie:: True if memory state is ok

check_stable_release() → None[source]#: Check if this is a stable release

check_for_previous_crash() → None[source]#: Check for previous crash

execute_post_show_actions() → None[source]#: Execute post-show actions

take_screenshot(name: str) → None[source]#: Take main window screenshot

take_menu_screenshots() → None[source]#: Take menu screenshots

setup(console: bool = False) → None[source]#

Setup main window

Paramètres:: console – True to setup console

set_process_isolation_enabled(state: bool) → None[source]#

Enable/disable process isolation

Paramètres:: state – True to enable process isolation

get_current_panel() → str[source]#

Return current panel name

Renvoie:: « signal », « image », « macro »)
Type renvoyé:: Panel name (valid values

set_current_panel(panel: str) → None[source]#

Switch to panel.

Paramètres:: panel – panel name (valid values: « signal », « image », « macro »)
Lève:: ValueError – unknown panel

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

has_objects() → bool[source]#: Return True if sig/ima panels have any object

set_modified(state: bool = True) → None[source]#: Set mainwindow modified state

repopulate_panel_trees() → None[source]#: Repopulate all panel trees

toggle_show_titles(state: bool) → None[source]#

Toggle show annotations option

Paramètres:: state – state

toggle_auto_refresh(state: bool) → None[source]#

Toggle auto refresh option

Paramètres:: state – state

toggle_show_first_only(state: bool) → None[source]#

Toggle show first only option

Paramètres:: state – state

reset_all() → None[source]#: Reset all application data

save_to_h5_file(filename=None) → None[source]#

Save to a DataLab HDF5 file

Paramètres:: filename – HDF5 filename. If None, a file dialog is opened.
Lève:: IOError – if filename is invalid or file cannot be saved.

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

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

Paramètres:

h5files – HDF5 filenames (optionally with dataset name, separated by « : »)
import_all – Import all datasets from HDF5 files
reset_all – Reset all application data before importing

browse_h5_files(filenames: list[str], reset_all: bool) → None[source]#

Browse HDF5 files

Paramètres:

filenames – HDF5 filenames
reset_all – Reset all application data before importing

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

Import HDF5 file into DataLab

Paramètres:

filename – HDF5 filename (optionally with dataset name,
" (separated by) – « )
reset_all – Delete all DataLab signals/images before importing data

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

Add object - signal or image

Paramètres:: obj – object to add (signal or image)

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

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

Paramètres:: filenames – list of filenames

load_from_directory(path: str) → None[source]#

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

Paramètres:: path – directory path

get_version() → str[source]#

Return DataLab public version.

Renvoie:: DataLab version

close_application() → None[source]#: Close DataLab application

raise_window() → None[source]#: Raise DataLab window

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 – 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

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

play_demo() → None[source]#: Play demo

show_tour() → None[source]#: Show tour

static test_segfault_error() → None[source]#: Generate errors (both fault and traceback)

show() → None[source]#: Reimplement QMainWindow method

close_properly() → bool[source]#

Close properly

Renvoie:: True if closed properly, False otherwise

closeEvent(event: QCloseEvent) → None[source]#: Reimplement QMainWindow method