tcspc_irf_convolve — PHOTON tcspc op

数据种类:countscounts

调用:import photoncount; photoncount.tcspc_irf_convolve(hist, bin_ps=100.0, irf_fwhm_ps=200.0, truncate=4.0)(或 opsphoton.get("tcspc_irf_convolve"))

用法

用仪器响应(定时抖动)模糊到达时间直方图。

> 以下的详细说明为原文 —— 摘要与标题已翻译。

The temporal analogue of a PSF convolution: a detector's timing uncertainty

(SPAD jitter + TDC quantisation + laser pulse width) smears every arrival

time by the instrument response function, here a Gaussian of full width at

half maximum *irf_fwhm_ps*. The kernel is the exact bin integral of that

Gaussian (erf differences), normalised to sum 1, truncated at

`+-truncate*sigma` and forced to odd length so the convolution is centred.

Ground truth: convolving a unit spike in the middle of a 256-bin window with

`irf_fwhm_ps = 500 at bin_ps = 50` leaves the centroid exactly

where it was (measured shift 0.0 ps — the kernel is symmetric) and gives a

profile whose measured FWHM is 501.22 ps. That 0.24% excess over 500 is the

*measurement*, not the kernel: :func:tcspc_stats finds the half-maximum

crossings by linear interpolation between bins, which slightly overestimates

the width of a Gaussian.

Total counts are preserved *except* at the window edges, where

`mode='same'` discards the tail that falls outside — measured loss exactly

0 for that centred spike, but a genuine loss for a pulse within a few sigma

of either end.

Returns a float64 1-D histogram of the same length as *hist*.

Raises `ValueError`: negative, non-finite or non-1-D *hist*, a

non-positive *bin_ps* / *irf_fwhm_ps* / *truncate*, an IRF sigma below

1e-3 bins (the kernel would be a delta and the op a no-op — say so instead

of pretending to blur), and a kernel that would be longer than the

:data:MAX_BINS cap.

详细使用指南

photon_timeresolved 族使用指南

参考(示例数据・文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者・年份)与用途见上面的族使用指南

可运行的示例(实际调用该算子并已验证的样例)

photon_timeresolvedpy -3.11 examples/photon_timeresolved.py

类型可衔接的下一个算子(可接受 counts 作为输入)

tcspc_coates_correct · tcspc_background_subtract · tcspc_stats · dtof_depth · lifetime_fit · lifetime_phasor

同类别(tcspc)

tcspc_simulate · tcspc_background_subtract · tcspc_stats


*Provenance: photoncount.py — PHOTON 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.