pyfli.phasor.phasorSEPL.plot#

plot.py#

Matplotlib helpers for rendering phasor plots and SEPL comparisons.

All functions return (fig, ax) so callers retain full control.

Color palette mirrors the widget colour scheme; each acquisition mode has a distinct colour defined in PALETTE.

Functions

_draw_lifetime_ticks(ax, g, s, tau, cfg[, ...])

Mark and label selected lifetime values on a SEPL curve.

_draw_universal_semicircle(ax[, alpha])

Overlay the universal semicircle as a dashed grey reference.

_setup_axes(ax[, title])

Apply standard phasor-plot aesthetics to ax.

plot_discrete_N_sweep(base_cfg[, N_values, ...])

Show how the discrete SEPL converges to the universal semicircle as N → ∞.

plot_locus_comparison(cfgs, *[, figsize, ...])

Overlay multiple SEPL curves on a single phasor plot.

plot_phasor(cfg, *[, ax, figsize, ...])

Plot the SEPL (Single-Exponential Phasor Locus) for a single config.
plot_phasor(cfg, *, ax=None, figsize=(7, 5), show_universal=True, show_ticks=True, show_endpoints=True, color=None, label=None, title=None)[source]#

Plot the SEPL (Single-Exponential Phasor Locus) for a single config.

Parameters:

  • cfg (AcquisitionConfig)

  • ax (Axes, optional   — draw into an existing axes.)

  • figsize (tuple            — figure size if *ax* is None.)

  • show_universal (bool             — overlay the universal semicircle.)

  • show_ticks (bool             — mark lifetime values on the SEPL.)

  • show_endpoints (bool             — mark τ→0 and τ→∞ endpoints.)

  • color (str, optional    — override default mode colour.)

  • label (str, optional    — override default legend label.)

  • title (str, optional    — axes title.)

Return type:

fig, ax

plot_locus_comparison(cfgs, *, figsize=(8, 5.5), show_universal=True, show_ticks=True, colors=None, labels=None, title="Phasor SEPL comparison — Michalet 2021", suptitle_note="")[source]#

Overlay multiple SEPL curves on a single phasor plot.

Parameters:

  • cfgs (sequence of AcquisitionConfig)

  • figsize (tuple)

  • show_universal (bool)

  • show_ticks (bool  — only for the first curve to keep the plot readable.)

  • colors (sequence of hex strings (defaults to PALETTE).)

  • labels (sequence of strings (defaults to MODE_LABELS).)

  • title (str)

  • suptitle_note (str   — small subtitle below the title.)

Return type:

fig, ax

plot_discrete_N_sweep(base_cfg, N_values=(4, 8, 16, 64, 256), *, figsize=(8, 5.5))[source]#

Show how the discrete SEPL converges to the universal semicircle as N → ∞.

Parameters:

  • base_cfg (AcquisitionConfig   — mode will be overridden to DISCRETE.)

  • N_values (sequence of int     — bin counts to sweep.)

  • figsize (tuple)

Return type:

fig, ax