procrustes_align — SHAPESTAT `procrustes` op

• 資料種類:points × points → points

• 呼叫: import fullseye as fs; fs.ledger.procrustes_align(source, target, scaling: 'bool' = True, reflection: 'bool' = False)(要直接呼叫實作,import shapestats; shapestats.procrustes_align(source, target, scaling: 'bool' = True, reflection: 'bool' = False);從台帳取用則 opsshapestat.get("procrustes_align"))

用法

> 該運算子的說明尚無譯文,以下照原文給出。

*source* を *target* に重ねた点。→ `(N, 3)(:func:procrustes_fit` の適用)。

`M = procrustes_fit(source, target, scaling, reflection)` を求め、

`source @ M[:3, :3].T + M[:3, 3]` を返す。変換は重心合わせ + SVD による回転

(+ 任意でスケール)の相似変換で、i 番目どうしが対応していることが前提。

対応の無い点群を渡しても例外は出ず、意味の無い配置が返る(その場合は

ICP 系の登録を使う)。

• `source, target: (N, 3)、同じ N、有限。N = 1` でも通る(並進のみ)。

• `scaling=True: 大きさの違いも吸収する。False` なら剛体変換。

`source` が全点同一(広がり 0)のときスケールは 1 のまま。

• `reflection=False(既定): det(R) = +1 を強制。True` にすると鏡像も

許す ―― 左右非対称性を測る用途では消えてしまうので通常は既定のまま。

• 返り値: `(N, 3) float64。残差を数値で欲しいなら procrustes_distance`、

変換行列そのものは `procrustes_fit`。

• 失敗: `ValueError(形が (N, 3) でない、N` 不一致、非有限)。

多数の形を同時に揃えるなら `generalized_procrustes`。

詳細使用指南

• shape_statistics 族使用指南

參考(範例資料・文獻)

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

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

• 演算法的正典(作者・年份)與用途見上面的族使用指南。

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

• shapestat_landmark_tour — py -3.11 examples/shapestat_landmark_tour.py

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

shape_perturb · procrustes_fit · procrustes_distance · shape_project · shape_mahalanobis · mirror_plane_from_pairs · landmark_asymmetry · signed_surface_distance

同類別(`procrustes`)

procrustes_fit · procrustes_distance · generalized_procrustes · shape_mean

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

procrustes_align — SHAPESTAT procrustes op

用法