synthesize_fringes — 3D `structured_light` op

• Datenarten: image2d → images

• Aufruf: import fullseye as fs; fs.ledger.synthesize_fringes(height, n_steps=4, freq=1.0, phase_gain=1.0, bias=0.5, amplitude=0.5, axis=1, noise=0.0, seed=None, return_phase=False) (die Implementierung direkt: import fringe; fringe.synthesize_fringes(height, n_steps=4, freq=1.0, phase_gain=1.0, bias=0.5, amplitude=0.5, axis=1, noise=0.0, seed=None, return_phase=False); aus dem Register: ops3d.get("synthesize_fringes"))

• Rückgabewert über das Register: fullseye.ledger.synthesize_fringes(...) liefert **nur den Wert des deklarierten Out-Typs images** (die zugrunde liegende Funktion gibt zusätzlich Hilfsinformationen zurück). Wird das Verworfene gebraucht, nutze fullseye.ledger.synthesize_fringes.raw(...) oder rufe fringe.synthesize_fringes direkt auf.

Verwendung

Synthetisiert aus einer bekannten Höhenkarte eine N-Schritt-phasenverschobene Streifenbildserie (für Tests und Beispielerzeugung).

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

モデル: 総位相 φ(x,y) = φ_carrier + phase_gain·height。搬送波 φ_carrier は視野を横切る線形

ランプ(freq 周期)。各フレームは I_n = bias + amplitude·cos(φ - δ_n), δ_n = 2πn/N。

この符号規約により wrapped_phase(...) は総位相 φ をそのまま復元する。

height: 2D 配列(計測対象の高さ場、任意単位)。

n_steps: 位相シフト枚数 N(>=3)。

freq: 視野幅を横切る搬送波の周期数(縞本数)。0 なら搬送波なし(height のみ)。

phase_gain: 高さ→位相の変換ゲイン(rad/単位)。復号側の較正 k = 1/phase_gain に対応。

bias: 平均輝度 a(既定 0.5)。

amplitude: 縞振幅 b(既定 0.5)。bias±amplitude が [0,1] に収まると自然。

axis: 搬送波の方向(1 = 列方向 x に沿う既定、0 = 行方向 y)。

noise: 付加ガウスノイズの標準偏差(0 で無ノイズ)。

seed: ノイズ用乱数シード。

return_phase: True なら (images, total_phase) を返す(テスト・デバッグ用)。

返り値: (N, H, W) float 配列(値域 [0,1] にクリップ)。return_phase=True なら位相も。

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

• depth_sensors — 深度センサの知識 — 測距原理・実機の値・欠測の出方

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.

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

• structured_light — py -3.11 examples_3d/structured_light.py

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

fuse_to_voxel · photometric_stereo · wrapped_phase · graycode_decode · decode_fringe · carve · visual_hull

Gleiche Kategorie (`structured_light`)

wrapped_phase · unwrap_phase_2d · graycode_decode · decode_fringe · absolute_phase · triangulate_column

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

synthesize_fringes — 3D structured_light op