plane_sweep_depth — 3D `plane_sweep_stereo` op

• Datenarten: image2d × image2d → depth

• Aufruf: import fullseye as fs; fs.ledger.plane_sweep_depth(img_ref: 'np.ndarray', img_src: 'np.ndarray', K: 'np.ndarray', R: 'np.ndarray', t: 'np.ndarray', depth_candidates, window: 'int' = 1, normal=(0.0, 0.0, 1.0)) -> 'np.ndarray' (die Implementierung direkt: import plane_sweep; plane_sweep.plane_sweep_depth(img_ref: 'np.ndarray', img_src: 'np.ndarray', K: 'np.ndarray', R: 'np.ndarray', t: 'np.ndarray', depth_candidates, window: 'int' = 1, normal=(0.0, 0.0, 1.0)) -> 'np.ndarray'; aus dem Register: ops3d.get("plane_sweep_depth"))

Verwendung

Schätzt eine dichte Tiefenkarte per Plane-Sweep-Stereo. → (H,W) Tiefe.

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

各深度平面で src を ref へワープし、photo-consistency 最小の候補深度を画素ごとに選ぶ

(winner-take-all)。全候補で視野外の画素は NaN。fail-closed(空/非 2D/shape 不一致/非正深度)。

• `img_ref / img_src: 同形状の (H,W) グレースケール float。基準カメラは [I|0]`、source は

`P_src = K [R|t](X_src = R X_ref + t`)。

• `K: 共通の (3,3) 内部行列(特異なら ValueError`)。

• `depth_candidates`: 基準カメラ座標での正の有限な深度列(D 個)。返る深度は必ずこの中の

どれかで、量子化誤差は候補間隔程度。候補は近距離を細かく(逆深度で等間隔)取るのが常道。

• `window`: コストの box 集約サイズ(既定 1 = 画素ごとの絶対差)。2 以上で窓内 SAD を有効画素数で

正規化した値になり、テクスチャの乏しい領域で安定するが段差はぼける。1 未満は `ValueError`。

• `normal`: 掃引平面の法線(既定 (0,0,1) = フロント平行)。

返り値は (H,W) float。全候補で src の視野外に写った画素(コスト ∞)は NaN。輝度が一定の領域では

全候補のコストが同点になり `argmin` が先頭候補を返すので、信頼度の無い深度が混じる。

コスト体 (D,H,W) そのものが要るときは同モジュールの `cost_volume` を使う。得られた深度は

`depth_to_points` で点群化できる。

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)

• plane_sweep_depth — py -3.11 examples_3d/plane_sweep_depth.py

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

depth_to_points · tsdf_from_depth · to_points · fuse_to_voxel · depth_to_organized_points · normals_from_depth · occlusion_edges · bearing_angle_image

Gleiche Kategorie (`plane_sweep_stereo`)

warp_by_plane

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

plane_sweep_depth — 3D plane_sweep_stereo op