pyfli.data_vnp.data_viewer#

Render FLI maps, fit summaries, and selected-pixel traces.

This module belongs to pyfli.data_vnp and is part of PyFLI visualization, normalization, plotting, and mono-versus-bi-exponential comparison tools. Public API includes classes DataViewer.

Classes

DataViewer([save_path, fig_name])

Render fitted parameter maps, raw decay traces, IRF traces, and selected-pixel summaries.
class DataViewer(save_path=None, fig_name=None)[source]#

Bases: object

Render fitted parameter maps, raw decay traces, IRF traces, and selected-pixel summaries. The class is aimed at interactive inspection and publication-style diagnostic figures.

Parameters:

  • save_path (str | None) – Output path used when saving generated masks, figures, or data.

  • fig_name (str | None) – Figure name or output stem used by plotting helpers.

display_data(data_list, structure=(1, 1), coord=None, data_names=None, cmaps=None, v_ranges=None, figsize=None, normalize=False, yscale='linear')[source]#

Display data.

Parameters:

  • data_list (np.ndarray) – List of data arrays displayed by the viewer.

  • structure (tuple[int, ]) – Layout structure that controls how data arrays are displayed.

  • coord (Any | None) – Pixel coordinate highlighted or summarized by the plot.

  • data_names (np.ndarray | None) – Labels assigned to displayed data arrays.

  • cmaps (np.ndarray | None) – Matplotlib colormap used by the visualization.

  • v_ranges (np.ndarray | None) – Per-map display ranges used by the viewer.

  • figsize (np.ndarray | None) – Figure size passed to Matplotlib.

  • normalize (bool) – Whether data are normalized before comparison or plotting.

  • yscale (str) – Scale used for the y-axis.

Returns:

Tuple containing displayed data handles and summary values.

Return type:

tuple[Any, ]

plot_pyfli_fit_summary(data, pixel=None, title='FLI Fit Summary', mode=('decay', 'irf', 'fit', 'residuals'), esp=1e0)[source]#

Plot pyfli fit summary.

Parameters:

  • data (np.ndarray) – Data array or mapping processed by the routine.

  • pixel (np.ndarray | None) – Selected pixel coordinate.

  • title (str) – Title displayed on the generated plot.

  • mode (tuple[str, ]) – Mode selector used by the fitting, loading, or plotting routine.

  • esp (float) – Small epsilon used to stabilize divisions and comparisons.

Returns:

Object produced by plot pyfli fit summary.

Return type:

Any

plot_fli_px(data_list, pixel=None, title='FLI Data Viewer', mode=None, mode2=None, names=None, esp=1e0, cmap='viridis')[source]#

Plot FLI px.

Parameters:

  • data_list (np.ndarray) – List of data arrays displayed by the viewer.

  • pixel (np.ndarray | None) – Selected pixel coordinate.

  • title (str) – Title displayed on the generated plot.

  • mode (str | None) – Mode selector used by the fitting, loading, or plotting routine.

  • mode2 (Any | None) – Secondary display mode used by the pixel viewer.

  • names (Any | None) – Dataset names used in summaries and plots.

  • esp (float) – Small epsilon used to stabilize divisions and comparisons.

  • cmap (str) – Colormap used for the image panels.

Returns:

Tuple containing the pixel plot handles and extracted pixel values.

Return type:

tuple[Any, ]