deflectometry_phase_to_slope — SPECULAR deflectometry op

• 資料種類:image2d × image2d → normalmap

• 呼叫: import fullseye as fs; fs.ledger.deflectometry_phase_to_slope(phase_x, phase_y, rig=None, period_mm=10.0, z_ref=0.0)(要直接呼叫實作,import deflectometry; deflectometry.deflectometry_phase_to_slope(phase_x, phase_y, rig=None, period_mm=10.0, z_ref=0.0);從台帳取用則 opsspecular.get("deflectometry_phase_to_slope"))

用法

兩張螢幕絕對相位(u 方向與 v 方向的條紋)→ 被測面網格上的法線圖 (H, W, 3)。

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

phase_x / phase_y: カメラの画素ごとの絶対位相 [rad] (次数を確定したもの。fringe.absolute_phase で粗い縞から決める)。画面の座標は u = φ_x·周期 / 2π、v = φ_y·周期 / 2π (画面の中心が 0)。NaN の画素は無効。

面の格子(deflectometry_render と同じ、視野の中心が原点、間隔 field / (W − 1))の各点 P = (x, y, z_ref) をカメラに投影して位相を双線形に読み、画面の点 S を出して、入射 S→P と反射 P→C から法線を match3d.normal_from_reflection で作る(n ∝ 反射 − 入射)。返り値は photometric と同じ規約(+z が上、x が列、y が行)なので、そのまま photometric.integrate_normals(高さへ)や slope_to_curvature(曲率へ)に流せる。位相が NaN・視野の外の点は NaN。

★高さと傾きの不定性: 面の高さを z_ref(数か (H, W) の配列)と仮定して法線を出す。本当の面が Δz ずれていると、法線は Δz sin θ / d だけ(視野の中心で)傾いて出る —— 1 台のカメラと 1 枚の画面では分けられない(deflectometry_sensitivity が係数を返す)。局所の凹みの形はほぼ影響を受けないが、面全体の傾きと曲がりは位置の不確かさに引きずられる。

Raises: ValueError —— 位相が 2-D でない・形が違う・無限大を含む、周期が正でない、z_ref が有限でない・形が違う、rig が不正。

詳細使用指南

• specular_photometric 族使用指南

參考(範例資料、文獻)

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

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

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

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

• poc_phase_measuring_deflectometry — py -3.11 examples/poc_phase_measuring_deflectometry.py

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

brdf_blinn_phong · brdf_microfacet · dichromatic_render · slope_to_curvature

同類別(deflectometry)

deflectometry_rig · deflectometry_screen_pattern · deflectometry_render · slope_to_curvature · deflectometry_sensitivity


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

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