deflectometry_phase_to_slope — SPECULAR `deflectometry` op

• Data kinds: image2d × image2d → normalmap

• Call: import fullseye as fs; fs.ledger.deflectometry_phase_to_slope(phase_x, phase_y, rig=None, period_mm=10.0, z_ref=0.0) (to call the implementation directly, import deflectometry; deflectometry.deflectometry_phase_to_slope(phase_x, phase_y, rig=None, period_mm=10.0, z_ref=0.0); from the registry, opsspecular.get("deflectometry_phase_to_slope"))

Usage

Two absolute screen phases (fringes along u and v) → a normal map (H, W, 3) on the surface grid.

> The detailed description below is the original text — the summary and the headings are translated.

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 が不正。

Detailed usage guide

• specular_photometric family guide

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

• poc_phase_measuring_deflectometry — py -3.11 examples/poc_phase_measuring_deflectometry.py

Ops the type connects to (they accept `normalmap` as input)

brdf_blinn_phong · brdf_microfacet · dichromatic_render · slope_to_curvature

Same category (`deflectometry`)

deflectometry_rig · deflectometry_screen_pattern · deflectometry_render · slope_to_curvature · deflectometry_sensitivity

*Provenance: deflectometry.py — SPECULAR operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

deflectometry_phase_to_slope — SPECULAR deflectometry op