describe — 3D shape_descriptor op

• 資料種類:points → descriptor

• 呼叫: import fullseye as fs; fs.ledger.describe(points, bins: 'int' = 64, seed: 'int' = 0) -> 'np.ndarray'(要直接呼叫實作,import descriptors3d; descriptors3d.describe(points, bins: 'int' = 64, seed: 'int' = 0) -> 'np.ndarray';從台帳取用則 ops3d.get("describe"))

用法

把 D2 + A3 + extent 串接成的全域形狀描述子。

長度為 2*bins + 3 的 1 維 float64 向量。排列為 [d2(bins), a3(bins), extent(3)]。各子區塊已分別正規化為總和 1,因此用 L1 距離比較時 3 個指標以大致相等的權重起作用。

Parameters

points : array_like, shape (N, 3)

點雲。需要 N >= 3。

bins : int

D2 / A3 各自的 bin 數。

seed : int

D2 / A3 的隨機抽樣種子(兩者傳入相同的 seed)。

Returns

np.ndarray, shape (2*bins + 3,)

參考(範例資料、文獻)

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

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

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

• denoise_evolution — py -3.11 examples_3d/denoise_evolution.py

• shape_desc_pose — py -3.11 examples_3d/shape_desc_pose.py

• shape_retrieval — py -3.11 examples_3d/shape_retrieval.py

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

fuse_to_voxel · shape_distance

同類別(shape_descriptor)

d2_distribution · a3_distribution · extent_signature · shape_distance


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

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