inner_box3 — 3D `regionprops` op

• 資料種類:voxel → primitive

• 呼叫: import fullseye as fs; fs.ledger.inner_box3(vol) -> 'dict'(要直接呼叫實作,import regionprops3d; regionprops3d.inner_box3(vol) -> 'dict';從台帳取用則 ops3d.get("inner_box3"))

用法

完全內接於二值體素區域的最大軸對齊盒(2-D inner_rectangle1 的 3-D 版)。

嚴格解:對於任意深度區間 [z0, z1],盒子必須位於切片 z0..z1 的邏輯與 (在所有切片中都是前景的體素)之內。該交集中的最大內接 2-D 矩形(直方圖法 = 與 inner_rectangle1 相同的核心)× 區間長度即為候選盒子,對全部區間取最大即為嚴格的最大內接盒子。O(D^2 * H * W)。

Returns

dict

依 (depth,row,col) 軸順序的 min / max 角點、center(+ cd/cr/cc)、

全寬 size、以體素數表示的 volume。

Raises

ValueError

非 3-D 輸入,或前景為零的區域(沒有內接盒子)。

補充:

• min / max 是包含兩端的體素索引(float 陣列)。size = max - min + 1,volume = prod(size)。center 為 (min + max) / 2,可能帶 .5。2-D 側的註冊名為 r2_inner_rectangle1。

• 對每個深度區間用 Python 迴圈尋找最大矩形,O(D²·H·W)。交集變空時即終止該 z0 的搜尋。大體積資料上較慢。

• 存在多個同體積候選時,回傳先找到的那個(z0 較小,其中 z1 較小)。

• 輸入以 0 以外為前景轉為 bool(NaN 也是前景)。軸順序為 (depth, row, col)。

• 典型:先用 largest_component 將對象縮減為 1 個再呼叫(混有多個元件時,不一定是最大元件的盒子)。

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

• measurement_uncertainty — 量測不確定度與校正知識 —— 為了能主張「量得準」

參考(範例資料、文獻)

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

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

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

• inner_box_inspection — py -3.11 examples_3d/inner_box_inspection.py

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

fuse_to_voxel · angle_between_lines · angle_between_planes · angle_line_plane · distance_point_plane · distance_point_line · distance_line_line · distance_segment_segment

同類別(`regionprops`)

label_components · region_props · largest_component · filter_by_volume · vol_label · vol_region_props

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

inner_box3 — 3D regionprops op

用法