polarization_stokes — SPECULAR polarization op

• Datenarten: polsweep → stokes

• Aufruf: import fullseye as fs; fs.ledger.polarization_stokes(images, angles_deg=(0.0, 45.0, 90.0, 135.0), max_violation_frac=0.0) (die Implementierung direkt: import specularity; specularity.polarization_stokes(images, angles_deg=(0.0, 45.0, 90.0, 135.0), max_violation_frac=0.0); aus dem Register: opsspecular.get("polarization_stokes"))

Verwendung

Der szenenintegrierte Stokes-Vektor eines Polarisatordurchlaufs. → (4,), direkt für optics.stokes_analyze.

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

Stokes parameters are linear in radiance, so the spatial mean of the frames has a Stokes vector that is the mean of the per-pixel ones — the vector a non-imaging polarimeter looking at the whole field would report. Fitting I(t) = 0.5 (S0 + S1 cos 2t + S2 sin 2t) gives (S0, S1, S2) directly.

S3 is always exactly 0, and that is a limitation, not a measurement. A set of linear analysers cannot see circular polarisation; a quarter-wave plate is needed. The returned vector is therefore the linear part of the truth, and optics.stokes_analyze will report handedness="linear" for it no matter what the scene actually did. Returning an invented S3 would be worse, and returning a 3-vector would break the Stokes contract the optics family is built on.

The result satisfies that contract by construction — S0 >= sqrt(S1^2 + S2^2 + S3^2), i.e. degree of polarisation at most 1 — because the same non-negativity check that guards polarization_separate is exactly the condition for it. That is why optics.stokes_analyze accepts the output without a further test.

Raises ValueError: as polarization_separate.

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie specular_photometric

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)

• poc_polarization_specular — py -3.11 examples/poc_polarization_specular.py

• polarization_camera_pipeline — py -3.11 examples/polarization_camera_pipeline.py

• specular_photometric — py -3.11 examples/specular_photometric.py

Typkompatible Folge-Operatoren (nehmen stokes als Eingabe)

—

Gleiche Kategorie (polarization)

polarization_render · polarization_separate · polarization_dolp_map


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

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