GUI

GUI entry for XRayLabTool.

This package provides a lightweight Qt-based desktop interface for running single-material and multi-material X-ray optical property calculations and plotting results using PyQtGraph.

Main Window

class xraylabtool.gui.main_window.Toast(parent)

Bases: QLabel

Lightweight, non-blocking toast overlay.

Parameters:

parent (QWidget)

__init__(parent)

Parameters:

parent (QWidget)

Return type:

None

show_toast(message, kind='info', duration_ms=None)

Return type:

None

Parameters:

• message (str)

• kind (str)

• duration_ms (int | None)

staticMetaObject = PySide6.QtCore.QMetaObject("Toast" inherits "QLabel": )

class xraylabtool.gui.main_window.MainWindow(theme_manager=None)

Bases: QMainWindow

Parameters:

theme_manager (Any | None)

__init__(theme_manager=None)

Parameters:

theme_manager (Any | None)

Return type:

None

threadpool: QThreadPool | None

resizeEvent(event)

Return type:

None

Parameters:

event (Any)

staticMetaObject = PySide6.QtCore.QMetaObject("MainWindow" inherits "QMainWindow": )

Services

Helper utilities for the GUI layer.

class xraylabtool.gui.services.EnergyConfig(start_kev=8.0, end_kev=12.0, points=50, logspace=False)

Bases: object

Parameters:

• start_kev (float)

• end_kev (float)

• points (int)

• logspace (bool)

start_kev: float = 8.0

end_kev: float = 12.0

points: int = 50

logspace: bool = False

to_array()

Return type:

ndarray

__init__(start_kev=8.0, end_kev=12.0, points=50, logspace=False)

Parameters:

• start_kev (float)

• end_kev (float)

• points (int)

• logspace (bool)

Return type:

None

xraylabtool.gui.services.compute_single(formula, density, energy_cfg)

Parameters:

• formula (str)

• density (float)

• energy_cfg (EnergyConfig)

xraylabtool.gui.services.compute_multiple(formulas, densities, energy_cfg, progress_cb=None)

Parameters:

• formulas (Iterable[str])

• densities (Iterable[float])

• energy_cfg (EnergyConfig)

• progress_cb (Callable[[int], None] | None)

xraylabtool.gui.services.linear_absorption_cm(inv_length_cm)

Return type:

float | None

Parameters:

inv_length_cm (float | None)

Theme Manager

class xraylabtool.gui.theme_manager.ThemeManager(app)

Bases: QObject

Manages application theme state and persistence.

Parameters:

app (QApplication)

theme_changed

__init__(app)

Parameters:

app (QApplication)

Return type:

None

property current_palette: ColorPalette

Get the active ColorPalette object.

set_theme(mode)

Set the active theme mode.

Return type:

None

Parameters:

mode (str)

get_theme()

Get current theme mode string.

Return type:

str

toggle_theme()

Toggle between light and dark modes.

Return type:

None

apply(app_instance)

Apply current theme to application and global resources.

Return type:

None

Parameters:

app_instance (QApplication)

staticMetaObject = PySide6.QtCore.QMetaObject("ThemeManager" inherits "QObject": Methods:   #4 type=Signal, signature=theme_changed(QString), parameters=QString )

Workers

Threaded workers for GUI calculations.

class xraylabtool.gui.workers.WorkerSignals

Bases: QObject

finished

error

progress

staticMetaObject = PySide6.QtCore.QMetaObject("WorkerSignals" inherits "QObject": Methods:   #4 type=Signal, signature=finished(PyObject), parameters=PyObject   #5 type=Signal, signature=error(QString), parameters=QString   #6 type=Signal, signature=progress(int), parameters=int )

class xraylabtool.gui.workers.CalculationWorker(fn, *args, **kwargs)

Bases: QRunnable

Parameters:

• fn (Callable[..., Any])

• args (Any)

• kwargs (Any)

__init__(fn, *args, **kwargs)

Parameters:

• fn (Callable[[...], Any])

• args (Any)

• kwargs (Any)

Return type:

None

run()

Return type:

None

Protocols

class xraylabtool.gui.protocols.ThemeProtocol(*args, **kwargs)

Bases: Protocol

Interface for the Theme Manager.

set_theme(mode)

Switch the application theme.

Return type:

None

Parameters:

mode (Literal['light', 'dark'])

get_theme()

Get the current active theme.

Return type:

Literal['light', 'dark']

toggle_theme()

Toggle between light and dark modes.

Return type:

None

apply(app_instance)

Apply the current theme stylesheet to the QApplication.

Return type:

None

Parameters:

app_instance (Any)

__init__(*args, **kwargs)

class xraylabtool.gui.protocols.PlotThemeProtocol(*args, **kwargs)

Bases: Protocol

Interface for Plot Theme Integration.

apply_to_figure(figure, mode)

Update a plot figure to match the theme.

Return type:

None

Parameters:

• figure (Any)

• mode (Literal['light', 'dark'])

__init__(*args, **kwargs)

Logging Filters

xraylabtool.gui.logging_filters.suppress_qt_noise()

Filter noisy Qt offscreen stderr lines (e.g., propagateSizeHints).

Keeps other stderr intact so real warnings still surface.

Return type:

Generator[None, None, None]

xraylabtool.gui.logging_filters.enable_offscreen_quiet_env()

Set env vars that quiet common Qt offscreen noise without muting real warnings.

Prefers the quieter “minimal” platform when available, otherwise falls back to “offscreen”. Does not override an explicit user choice.

Return type:

None

xraylabtool.gui.logging_filters.suggest_quiet_platforms()

Return optional platform plugins that can be quieter offscreen (opt-in).

Return type:

list[str]

Widgets

Custom widgets for the XRayLabTool GUI.

xraylabtool.gui.widgets.current_palette()

Detect the active palette by checking the application background color.

Return type:

ColorPalette

xraylabtool.gui.widgets.apply_palette_to_widget(pw, palette)

Apply background and foreground colors from palette to a PlotWidget.

Return type:

None

Parameters:

• pw (Any)

• palette (ColorPalette)

xraylabtool.gui.widgets.apply_palette_to_item(pi, palette)

Apply background/foreground colors from palette to a PlotItem.

Return type:

None

Parameters:

• pi (Any)

• palette (ColorPalette)