polarization_stokes — SPECULAR polarization op

資料種類:polsweepstokes

呼叫:import specularity; specularity.polarization_stokes(images, angles_deg=(0.0, 45.0, 90.0, 135.0), max_violation_frac=0.0)(或 opsspecular.get("polarization_stokes"))

用法

偏振片旋轉序列的場景積分 Stokes 向量。→ (4,),可直接交給 :func:optics.stokes_analyze

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

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 :func: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 :func:polarization_separate is exactly

the condition for it. That is why `optics.stokes_analyze` accepts the

output without a further test.

Raises `ValueError: as :func:polarization_separate`.

詳細使用指南

specular_photometric 族使用指南

參考(範例資料・文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

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

可執行的範例(實際呼叫該運算子並已驗證的樣例)

specular_photometricpy -3.11 examples/specular_photometric.py

型別可銜接的下一個運算子(可接受 stokes 作為輸入)

同類別(polarization)

polarization_render · polarization_separate · polarization_dolp_map


*Provenance: specularity.py — SPECULAR 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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