boundary_vertices — 3D `mesh_process` op

• 資料種類:mesh → indices

• 呼叫: import fullseye as fs; fs.ledger.boundary_vertices(mesh) -> 'np.ndarray'(要直接呼叫實作,import mesh_props; mesh_props.boundary_vertices(mesh) -> 'np.ndarray';從台帳取用則 ops3d.get("boundary_vertices"))

用法

位於開放邊緣(邊界)上的頂點 index → (K,)。

收集並回傳無向邊中恰好只被 1 個面使用的邊（邊界邊）的端點。封閉流形則為空陣列 —— 也就是說 len(boundary_vertices(mesh)) == 0 即可作為 水密性(watertight)的判定。補洞、體積計算、曲率都會因有無邊界而改變含義，所以先看這裡。

Args:

mesh: (vertices (N,3), faces (M,3)) 的元組。

Returns:

遞增、無重複的 (K,) int64。若無邊界則 shape == (0,)。

Raises:

ValueError: mesh 不是 (vertices, faces) 這 2 個元素、形狀不正確、

座標非有限、index 非整數、越界、為空時。

限制(honest): 回傳的是頂點集合，而不是邊緣的迴圈（環繞順序）。即使有多個孔也會合併為 1 個陣列，所以若要依孔分開，需要自己追蹤連通元件（尚無擷取迴圈的 op）。被 3 個以上面共用的非流形邊不會出現在這裡（見 mesh_edge_stats 的 non_manifold_edges）。

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

• blender_interop — 與 Blender 搭配使用 —— 在 Blender 中建形、用 fullseye 量測(座標軸、單位、真值資料的陷阱)

參考(範例資料、文獻)

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

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

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

• mesh_decimate — py -3.11 examples_3d/mesh_decimate.py

• mesh_props — py -3.11 examples_3d/mesh_props.py

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

fuse_to_voxel

同類別(`mesh_process`)

laplacian_smooth · taubin_smooth · decimate_qem · face_normals · vertex_normals · mesh_area · vertex_curvature · face_areas

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

boundary_vertices — 3D mesh_process op

用法