photon_uncertainty — PHOTON `counting` op

• Datenarten: image2d → image2d

• Aufruf: import photoncount; photoncount.photon_uncertainty(counts, relative=False, zero_floor=0.0) (oder opsphoton.get("photon_uncertainty"))

Verwendung

Poisson-Fehlerbalken pro Pixel eines Photonenzählbildes.

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

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).

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie photon_timeresolved

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• photon_timeresolved — py -3.11 examples/photon_timeresolved.py

Typkompatible Folge-Operatoren (nehmen `image2d` als Eingabe)

photon_sample · photon_statistics · anscombe_transform · anscombe_inverse

Gleiche Kategorie (`counting`)

photon_sample · photon_statistics

*Provenance: photoncount.py — PHOTON Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

photon_uncertainty — PHOTON counting op