erlab.interactive.imagetool.manager

Manager for multiple ImageTool windows.

This module provides a GUI application for managing multiple ImageTool windows. The application can be started by running the script itool-manager from the command line in the environment where the package is installed.

Python scripts communicate with the manager using a socket connection with the default port number 45555. The port number can be changed by setting the environment variable ITOOL_MANAGER_PORT.

Functions

is_running()	Check whether an instance of ImageToolManager is active.
load_in_manager(paths, loader_name, ...)	Load and display data in the ImageToolManager.
main([execute])	Start the ImageToolManager application.
replace_data(index, data)	Replace data in existing ImageTool windows.
show_in_manager(data, **kwargs)	Create and display ImageTool windows in the ImageToolManager.

Classes

ImageToolManager()

The ImageToolManager window.

class erlab.interactive.imagetool.manager.ImageToolManager

Bases: QMainWindow

The ImageToolManager window.

This class implements a GUI application for managing multiple ImageTool windows.

Users do not need to create an instance of this class directly. Instead, use the command line script itool-manager or the function main to start the application.

Signals:

sigLinkersChanged() – Signal emitted when the linker state is changed.

about()

Show the about dialog.

add_tool(tool, activate=False)

Add a new ImageTool window to the manager and show it.

Parameters:

• tool (ImageTool) – ImageTool object to be added.

• activate (bool, default: False) – Whether to focus on the window after adding, by default False.

Returns:

int – Index of the added ImageTool window.

Return type:

int

add_widget(widget)

Save a reference to an additional window widget.

This is mainly used for handling tool windows such as goldtool and dtool opened from child ImageTool windows. This way, they can stay open even when the ImageTool that opened them is archived or removed.

All additional windows are closed when the manager is closed.

Only pass widgets that are not associated with a parent widget.

Parameters:

widget (QWidget) – The widget to add.

archive_selected()

Archive selected ImageTool windows.

property cache_dir: str

Name of the cache directory where archived data are stored.

closeEvent(event)

Handle proper termination of resources before closing the application.

color_for_linker(linker)

Get the color that should represent the given linker.

concat_selected()

Concatenate the selected data using xarray.concat().

dragEnterEvent(event)

Handle drag-and-drop operations entering the window.

dropEvent(event)

Handle drag-and-drop operations dropping files into the window.

duplicate_selected()

Duplicate selected ImageTool windows.

duplicate_tool(index)

Duplicate the ImageTool window corresponding to the given index.

Parameters:

index (int) – Index of the ImageTool window to duplicate.

Returns:

int – Index of the newly created ImageTool window.

Return type:

int

ensure_console_initialized()

Ensure that the console window is initialized.

ensure_explorer_initialized()

Ensure that the data explorer window is initialized.

eventFilter(obj=None, event=None)

Event filter that intercepts select all and copy shortcuts.

For some operating systems, shortcuts are often intercepted by actions in the menu bar. This filter ensures that the shortcuts work as expected when the target widget has focus.

garbage_collect()

Run garbage collection to free up memory.

get_tool(index, unarchive=True)

Get the ImageTool object corresponding to the given index.

Parameters:

• index (int) – Index of the ImageTool window to retrieve.

• unarchive (bool, default: True) – Whether to unarchive the tool if it is archived, by default True. If set to False, an error will be raised if the tool is archived.

Returns:

ImageTool – The ImageTool object corresponding to the index.

Return type:

ImageTool

hide_all()

Hide all ImageTool windows.

hide_selected()

Hide selected ImageTool windows.

label_of_tool(index)

Get the label of the ImageTool window corresponding to the given index.

link_selected(link_colors=True, deselect=True)

Link selected ImageTool windows.

link_tools(*indices, link_colors=True)

Link the ImageTool windows corresponding to the given indices.

load(*, native=True)

Load the state of the manager from a file.

Parameters:

native (bool, default: True) – Whether to use the native file dialog, by default True. This option is used when testing the application to ensure reproducibility.

name_of_tool(index)

Get the name of the ImageTool window corresponding to the given index.

property next_idx: int

Index for the next ImageTool window.

property ntools: int

Number of ImageTool windows being handled by the manager.

open(*, native=True)

Open files in a new ImageTool window.

Parameters:

native (bool, default: True) – Whether to use the native file dialog, by default True. This option is used when testing the application to ensure reproducibility.

open_multiple_files(queued, try_workspace=False)

Open multiple files in the manager.

reload_selected()

Reload data in selected ImageTool windows.

remove_all_tools()

Remove all ImageTool windows.

remove_selected()

Discard selected ImageTool windows.

remove_tool(index)

Remove the ImageTool window corresponding to the given index.

rename_selected()

Rename selected ImageTool windows.

rename_tool(index, new_name)

Rename the ImageTool window corresponding to the given index.

save(*, native=True)

Save the current state of the manager to a file.

Parameters:

native (bool, default: True) – Whether to use the native file dialog, by default True. This option is used when testing the application to ensure reproducibility.

show_explorer()

Show data explorer window.

show_selected()

Show selected ImageTool windows.

store_selected()

toggle_console()

Toggle the console window.

unarchive_selected()

Unarchive selected ImageTool windows.

unlink_selected(deselect=True)

Unlink selected ImageTool windows.

erlab.interactive.imagetool.manager.is_running()

Check whether an instance of ImageToolManager is active.

Returns:

bool – True if an instance of ImageToolManager is running, False otherwise.

Return type:

bool

erlab.interactive.imagetool.manager.load_in_manager(paths, loader_name, **load_kwargs)

Load and display data in the ImageToolManager.

Parameters:

• paths (Iterable[str | PathLike]) – List of paths containing the data to be displayed in the ImageTool window.

• loader_name (str) – Name of the loader to use to load the data. The loader must be registered in erlab.io.loaders.

• **load_kwargs – Additional keyword arguments passed onto the load method of the loader.

erlab.interactive.imagetool.manager.main(execute=True)

Start the ImageToolManager application.

Running itool-manager from a shell will invoke this function.

erlab.interactive.imagetool.manager.replace_data(index, data)

Replace data in existing ImageTool windows.

Parameters:

• index (int | Collection[int]) – Index or indices of the ImageTool windows to replace data in. If data corresponds to a single ImageTool window, for instance a single DataArray, index is allowed to be a single integer. If data corresponds to multiple ImageTool windows, for instance a list of DataArrays, index must be a list of integers with the same length as data. All indices must be valid indices of existing ImageTool windows.

• data (Collection[DataArray | ndarray[tuple[int, ...], dtype[TypeVar(_ScalarType_co, bound= generic, covariant=True)]]] | DataArray | ndarray[tuple[int, ...], dtype[TypeVar(_ScalarType_co, bound= generic, covariant=True)]] | Dataset | DataTree) – Data to replace the existing data in the ImageTool windows. See itool for more information.

erlab.interactive.imagetool.manager.show_in_manager(data, **kwargs)

Create and display ImageTool windows in the ImageToolManager.

Parameters:

• data (Collection[DataArray | ndarray[tuple[int, ...], dtype[TypeVar(_ScalarType_co, bound= generic, covariant=True)]]] | DataArray | ndarray[tuple[int, ...], dtype[TypeVar(_ScalarType_co, bound= generic, covariant=True)]] | Dataset | DataTree) – The data to be displayed in the ImageTool window. See itool for more information.

• link – Whether to enable linking between multiple ImageTool windows, by default False.

• link_colors – Whether to link the color maps between multiple linked ImageTool windows, by default True.

• **kwargs – Keyword arguments passed onto ImageTool.