fill_holes — 3D depth_denoise op

資料種類:depthdepth

呼叫: import fullseye as fs; fs.ledger.fill_holes(depth: 'np.ndarray', max_radius: 'float', *, invalid: 'float | None' = 0.0, max_iter: 'int | None' = None, rel_tol: 'float' = 1e-06) -> 'np.ndarray'(要直接呼叫實作,import depth_bilateral; depth_bilateral.fill_holes(depth: 'np.ndarray', max_radius: 'float', *, invalid: 'float | None' = 0.0, max_iter: 'int | None' = None, rel_tol: 'float' = 1e-06) -> 'np.ndarray';從台帳取用則 ops3d.get("fill_holes"))

用法

用調和(拉普拉斯)鬆弛由鄰近有效像素插補無效像素(空洞)。→ float64 (H,W)。

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

各穴画素の最寄り有効画素までの距離が max_radius 以下なら補間対象、超える深い穴は補間せず NaN で残す

(fail-closed)。補間は 4 近傍平均の反復(Dirichlet 境界=元の有効画素)で、線形場(平面)は離散

調和関数の不動点なので反復収束とともに平面を厳密復元する。初期値は最寄り有効画素値(EDT)。

max_iter 既定は穴サイズに応じて自動設定、rel_tol は深度スケール相対の収束判定。全画素無効の入力は

補間の足場が無いため ValueError(fail-closed)。

背景知識指南(該運算子背後的物理與規範)

blender_interop — Blender との併用 — 形を作って fullseye で測る(軸・単位・正解データの罠)

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

參考(範例資料・文獻)

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

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

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

depth_denoisepy -3.11 examples_3d/depth_denoise.py

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

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

同類別(depth_denoise)

bilateral_filter_depth · joint_bilateral


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

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