log_zero_crossings — 3D edges op

• 資料種類:voxel → voxel

• 呼叫: import fullseye as fs; fs.ledger.log_zero_crossings(vol, sigma: 'float' = 1.5, rel_thresh: 'float' = 0.001) -> 'np.ndarray'(要直接呼叫實作,import edges3d; edges3d.log_zero_crossings(vol, sigma: 'float' = 1.5, rel_thresh: 'float' = 0.001) -> 'np.ndarray';從台帳取用則 ops3d.get("log_zero_crossings"))

用法

Laplacian-of-Gaussian 的零交叉邊緣。

Parameters

vol : (D,H,W) array

灰階 voxel。

sigma : float

LoG 的標準差(> 0)。

rel_thresh : float

抑制平坦區數值雜訊造成的偽交叉的相對閾值。僅當交叉對的 LoG 差 |a-b|

超過 rel_thresh * max|L| 時才採用。

Returns

edge_mask : (D,H,W) bool

在符號變化的相鄰對中,將 |LoG| 較小的一側(較接近零的一側)設位的 mask。

Notes

在各軸方向上偵測兩種過零點:

(1) 格間交叉 —— 相鄰對 (a,b) 的符號積 a*b < 0(兩側皆非零且符號反轉)。為了抑制厚度,分配給對中 |LoG| 較小一側的 1 個 voxel。

(2) 格點對齊交叉 —— 中央 voxel 嚴格為零(L==0)且兩鄰異號(符號在該 voxel 處通過零)的情況。在 SDF 風格的格點對齊面上,LoG 恰好在格點上為 0 的真實邊緣,a*b 總是 0,(1) 會漏偵測,因此把該 voxel 作為交叉設位。常數零區域兩鄰也為 0,Lm*Lp==0,因而被排除(不會誤偵測)。

兩種情況下,平坦區的數值雜訊都由相對閾值(rel_thresh * max|L|)抑制。

參考(範例資料、文獻)

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

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

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

• edges_3d — py -3.11 examples_3d/edges_3d.py

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

voxel_to_mips · voxel_to_mesh · signed_distance_field · to_points · sobel3d · hessian3d · curvature_maps · edt_jfa

同類別(edges)

gradient3d · canny3d · link_edges · edge_points


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

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