photon_uncertainty — PHOTON counting op

• Data kinds: image2d → image2d

• Call: import fullseye as fs; fs.ledger.photon_uncertainty(counts, relative=False, zero_floor=0.0) (implementation को सीधे call करना हो तो import photoncount; photoncount.photon_uncertainty(counts, relative=False, zero_floor=0.0), registry से लेना हो तो opsphoton.get("photon_uncertainty"))

उपयोग

photon-count frame का हर pixel का Poisson error bar।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

For a Poisson variable the variance *equals* the mean, so the one-sigma uncertainty of a single measurement N is sqrt(N) — no calibration, no noise model to fit. With relative=True the returned map is the relative uncertainty 1/sqrt(N) instead (its reciprocal is the per-pixel SNR).

*zero_floor* replaces counts below it before the square root. It exists because N = 0 gives sqrt(0) = 0, i.e. "this pixel is exactly zero with no uncertainty", which is wrong: the 95% Poisson upper limit for a single observed zero is about 3 photons. Set zero_floor=1.0 for the common "one-count prior" convention. It is not applied silently — the default is 0.0 and the absolute map really does return 0 there.

Returns a float64 (H, W) image.

Raises ValueError: negative, non-finite or non-2-D *counts*, a negative *zero_floor*, and — instead of returning inf — relative=True with any pixel at 0 after the floor (that is the division 1/sqrt(0); pass zero_floor > 0 to say what a zero should mean).

उपयोग की विस्तृत guide

• photon_timeresolved family guide

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• photon_timeresolved — py -3.11 examples/photon_timeresolved.py

• poc_thermal_radiometry — py -3.11 examples/poc_thermal_radiometry.py

वे अगले ops जिनसे type जुड़ता है (image2d को input के रूप में लेते हैं)

photon_sample · photon_statistics · anscombe_transform · anscombe_inverse

इसी category के (counting)

photon_sample · photon_statistics


*Provenance: photoncount.py — PHOTON operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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