register_shot — 3D `feature_register` op

• 資料種類:points × points → pose

• 呼叫: import fullseye as fs; fs.ledger.register_shot(src, dst, radius=None, normal_k=16, ratio=0.9, ransac_iters=2000, inlier_thr=None, refine_icp=True, max_kp=400, device='cpu', seed=0)(要直接呼叫實作,import feat_shot; feat_shot.register_shot(src, dst, radius=None, normal_k=16, ratio=0.9, ransac_iters=2000, inlier_thr=None, refine_icp=True, max_kp=400, device='cpu', seed=0);從台帳取用則 ops3d.get("register_shot"))

用法

SHOT 描述子的稀疏特徵匹配 + RANSAC 剛體姿態估計(完整管線)。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

初期推定なしに、大回転・部分重なりの 2 点群を対応付けて剛体変換

(回転 R + 並進 t)を返す。密マッチ(NCC/Hough/PCA)と異なり、ISS

キーポイントごとに局所参照フレーム(LRF)を張り、球状分割セルの

法線角度ヒストグラム(SHOT)で記述 → Lowe 比率テスト + 相互最近傍で

マッチ → RANSAC で外れ値に頑健に姿勢推定する。得た姿勢は ICP の

粗初期値(coarse init)供給にも使える。

LRF の符号曖昧性: 距離重み付き共分散の固有ベクトルは符号が定まらない

ため、各軸(x=最大, z=最小固有値)を近傍ベクトル (p_i-p) の投影多数派

へ合わせ(Tombari の符号則)、y=z×x で右手系を構成する。点法線も同則で

近傍質量から離れる向き(局所外向き)に統一するため回転に共変で部分

重なりにも安定。両点群に同一則を適用することで記述子の repeatability を担保。

引数:

src, dst: (N,3)/(M,3) 点群(numpy か torch)。src を dst へ合わせる。

radius: SHOT 支持半径。None なら各点群自身の bbox 対角(小さい方)の 0.15 倍

(結合 bbox は並進で対角が水増しされスケールが狂うため使わない)。

normal_k: 法線推定の knn 数。

ratio: Lowe 比率テスト閾値(小さいほど厳格)。

ransac_iters: RANSAC 反復数。

inlier_thr: RANSAC インライア距離。None なら bbox 対角の 0.03 倍。

refine_icp: True なら得た姿勢を初期値に Trimmed ICP(icp_point2point_3d)で精緻化。

max_kp: キーポイント上限。

device: torch デバイス("cpu" 等)。SVD/ICP をこの上で解く。

seed: RANSAC 乱数種。

返り値:

R: (3,3) numpy。dst ≈ src @ R.T + t を満たす回転(icp と同規約)。

t: (3,) numpy。並進。

info: dict。"n_kp_src","n_kp_dst","n_matches","n_inliers","inlier_ratio",

"icp_rmse"(refine_icp 時),"ok"(True=推定成功; インライア<4 は

信頼不可として False + 単位変換を返す)。

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

• blas_threads_and_memory — 行列分解が遅い理由の知識 — BLAS スレッド・キャッシュ・メモリ配置

參考(範例資料・文獻)

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

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

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

• feature_register — py -3.11 examples_3d/feature_register.py

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

fuse_to_voxel · pose_error · bundle_adjust · mean_reprojection_error · optimize_pose_graph · relative_pose · mean_edge_error · rotation_translation_error

同類別(`feature_register`)

harris3d_keypoints · iss_keypoints · compute_fpfh · shot_descriptor · register_spin · register_fpfh

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

register_shot — 3D feature_register op

用法