voxel_to_mips — 3D transform op

• 資料種類:voxel → images

• 呼叫: import fullseye as fs; fs.ledger.voxel_to_mips(vol)(要直接呼叫實作,import match3d; match3d.voxel_to_mips(vol);從台帳取用則 ops3d.get("voxel_to_mips"))

用法

3D → 正交三方向的最大值投影(MIP)。套用 2D 方法(如 accel 的 2D NCC)的入口。

對輸入 (D,H,W) 回傳 [max(axis=0), max(axis=1), max(axis=2)] 的 list。形狀分別為 (H,W)(壓掉軸 0=D)、(D,W)(壓掉軸 1=H)、(D,H)(壓掉軸 2=W), dtype float64。值就是輸入的最大值(不正規化)。負值也因為是 max 而照樣通過, 密度 0 的背景維持為 0。沒有形狀驗證(2-D 會在 axis=2 處失敗,4-D 以上卻能執行),所以由呼叫端確認維數。match_mip_2d 對這 3 張圖做 2D NCC,冗餘地估計 3D 位置。任意視點的投影用 render_volume_projection(mode="mip")。

參考(範例資料、文獻)

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

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

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

• transforms_repr — py -3.11 examples_3d/transforms_repr.py

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

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

同類別(transform)

points_to_voxel · gaussians_to_voxel · mesh_to_voxel · mesh_to_points · depth_to_points · voxel_to_mesh · tsdf_from_depth · signed_distance_field

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

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