d2_distribution — 3D shape_descriptor op

• 資料種類:points → descriptor

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

用法

隨機點對之間歐氏距離的分布(Osada 2002 的 D2)。

從 N 個點中隨機抽取 samples 組互不相同的點對 (i, j),統計其距離。距離除以平均距離進行正規化,因此對旋轉、平移、尺度不變。回傳固定範圍 [0, _D2_MAX] 的正規化直方圖 (bins,)(總和 1)。

Parameters

points : array_like, shape (N, 3)

點雲。需要 N >= 2。

bins : int

直方圖的 bin 數。

samples : int

隨機抽取的點對數。越多變異數越小(抽樣誤差 ~ 1/sqrt(samples))。

seed : int

亂數種子。相同 seed、相同點雲則決定性地相同。

Returns

np.ndarray, shape (bins,)

正規化距離直方圖。

參考(範例資料、文獻)

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

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

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

• shape_desc_pose — py -3.11 examples_3d/shape_desc_pose.py

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

fuse_to_voxel · shape_distance

同類別(shape_descriptor)

a3_distribution · extent_signature · describe · shape_distance

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

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