Changelog#
Version history for pyfli, and currently open issues pulled live from
GitHub. Version numbers and dates below follow the releases published on
PyPI.
Open issues#
Loading open issues from GitHub…
Release history#
0.1.20 — 2026-10-14#
Features added:
weightingoption for NLSF ("irls"default,"none","neyman"), for MLE ("poisson"default,"pearson","neyman","none") and for GPU NLSFIteratively reweighted least squares (IRLS): NLSF now gives the same result as Poisson MLE for photon-count data
Gate-integrated forward model:
h_shiftis a true, smooth sub-gate onset shift (zero before onset, earlier curve for negative shifts); CPU, GPU and reconstruction use the same modelCVPlot: log-space and count-weighted fitting of the ideal1/√Ntrend.New examples: NLSF & MLE fitting for mono- and bi-exponential data
PicoQuant
.ptufile loading (load_ptu_file, frames integrated, channel selectable; adds theptufiledependency)Robust (sandwich) NLSF uncertainties for
weighting="none", and column-scaled Jacobian for numerically stable errorsGlobal fitter passes
weighting/max_iterto the super-pixel fitNew metrics in
pyfli.solver:poisson_deviance,expected_poisson_deviance,reduced_poisson_deviance,pearson_chi_square,compute_pearson_statspyfli.plot_style: darker colour palettes and legends outside the axes across analysis anddata_vnpplotsPhasorAdditionalPlots.multidata_phasor_plotpyfli.simulator.calibration: calibrate the simulator (priors, IRF, detector noise) to experimental datapyfli.analysis.precision: Cramér-Rao bounds, fit-free lifetimes and Monte Carlo precision studiesphasor_clustering: phasor PCA, clustering and LDA (scikit-learn)phasor_lifetime: normal and apparent phasor lifetimes (PhasorAnalyzer.compute_normal_lifetime,compute_apparent_lifetimes)ModelSelector/ModelSelectorPlotter: per-pixel mono- vs bi-exponential model selection (F-test + AICc) and figurespyfli.bayes_utils: posterior MAD (unc), credible-interval (trustworthiness_CrI) and goodness-of-fit (trustworthiness_gof) trustworthiness maps
Changes that affect results:
photon_count_mapis now the number of photons (previously photons × gate width, about 20× smaller)NLSF default weighting changed from Neyman to IRLS, so NLSF lifetimes differ from earlier versions (
weighting="neyman"reproduces them)use_weightsis deprecated; useweightingmax_iternow limits the MLE optimizerReported
Red.χ²/reduced_chi2_mapis now the Poisson deviance divided by its expected value (≈ 1 for a correct fit at any photon count;chi2_mapis the deviance); the former Pearson values are kept aspearson_chi2_map/pearson_reduced_chi2_mapRemoved
pyfli.phasor.phasorSEPLand its top-level re-exports; usepyfli.phasor.phasorS.MonoLocusLicense changed from CC BY-NC-ND 4.0 to AGPL-3.0
Fit initial guesses: amplitude is now the photon count (was the peak value) and
h_shiftstarts at half a gate (was 0)SimGeneratordefault IRF shift rangea_rangeis now (-20, 20) (was (-20, 100))Removed
pyfli.simulator.calibration_engine(FLICalibrator) andpyfli.simulator.sim_stat_test; usepyfli.simulator.calibration
Bugs Fixed:
Fixed a sign error in the truncated-window phasor locus
Fixed NLSF parameter uncertainties not being reordered with τ1/τ2 when bi-exponential lifetimes were swapped
Fixed phasor math: acquisition loci, colour bar, harmonic lifetimes, two-component fractions and per-bin kernels
0.1.19 — 2026-08-31#
⚡ A major refactor in the library
Features added:
Expanded simulator functionality
Additional image generation features
Detailed Phasor example
Synthetic IRF simulator
Time-of-flight offset
Updated IRF aligner
KDE support in Phasor analysis
Gate signal and truncated signal Phasor
Elaborated plotting and processed-data comparison against underlying properties
Elaborated examples of Simulator and Phasor analysis
Bugs Fixed:
Continuous and discrete simulators being dropped
0.1.18 — 2026-06-25#
Features added:
(add notes for this release)
Bugs Fixed:
(add notes for this release)
0.1.17 — 2026-06-03#
Features added:
Simulator
Detailed Phasor Method
NLSF, MLE, and plotting methods
Bugs Fixed:
Subplotting placement error