pyfli.phasor.phasorSEPL.config#

config.py#

Dataclass-based configuration for phasor acquisitions.

All physical parameters are stored here so that every downstream module receives a single, validated object rather than a loose collection of kwargs.

Units#

Time : nanoseconds (ns) Frequency : MHz (stored as period T in ns) Angles : radians (computed internally)

Classes

AcquisitionConfig([mode, T_ns, harmonic, ...])

Validate and store physical parameters for phasor locus calculations.

AcquisitionMode(*values)

Enumerate phasor acquisition geometries supported by the phasor package.
class AcquisitionMode(*values)[source]#

Bases: Enum

Enumerate phasor acquisition geometries supported by the phasor package. Modes cover continuous, discrete, gated, truncated, and offset acquisition models.

CONTINUOUS = 1#
DISCRETE = 2#
GATED_SINGLE = 3#
GATED_N = 4#
TRUNCATED = 5#
OFFSET = 6#
class AcquisitionConfig(mode=AcquisitionMode.CONTINUOUS, T_ns=12.5, harmonic=1, N_bins=64, gate_width_frac=0.5, N_gates=4, T_rec_frac=0.8, t0_frac=0.1, tau_min_ns=0.0001, tau_max_ns=10.0, n_tau_pts=600)[source]#

Bases: object

Validate and store physical parameters for phasor locus calculations. The dataclass centralizes acquisition mode, laser period, harmonic, bin counts, gate settings, truncation, offset, and lifetime-grid ranges.

Parameters:

  • mode (AcquisitionMode) – Acquisition, fitting, plotting, or simulator mode.

  • T_ns (float) – Laser repetition period in nanoseconds.

  • harmonic (int) – Phasor harmonic index.

  • N_bins (int) – Number of temporal bins in discrete phasor acquisition.

  • gate_width_frac (float) – Gate width as a fraction of the laser period.

  • N_gates (int) – Number of gates in gated acquisition.

  • T_rec_frac (float) – Recorded decay window as a fraction of the laser period.

  • t0_frac (float) – Offset as a fraction of the laser period.

  • tau_min_ns (float) – Minimum lifetime in nanoseconds for locus generation.

  • tau_max_ns (float) – Maximum lifetime in nanoseconds for locus generation.

  • n_tau_pts (int) – Number of lifetime samples in a generated locus.

mode: AcquisitionMode = 1#
T_ns: float = 12.5#
harmonic: int = 1#
N_bins: int = 64#
gate_width_frac: float = 0.5#
N_gates: int = 4#
T_rec_frac: float = 0.8#
t0_frac: float = 0.1#
tau_min_ns: float = 0.0001#
tau_max_ns: float = 10.0#
n_tau_pts: int = 600#
property omega: float#

Angular frequency ω = 2π·n/T (rad/ns).

property frequency_MHz: float#

Fundamental laser repetition frequency in MHz.

property gate_width_ns: float#

Absolute gate width W (ns).

property T_rec_ns: float#

Absolute recording window (ns).

property t0_ns: float#

Absolute IRF offset (ns).

describe()[source]#

Run the describe routine.

Returns:

String path, label, or message produced by describe.

Return type:

str