procrustes_align — SHAPESTAT `procrustes` op

• Datenarten: points × points → points

• Aufruf: import fullseye as fs; fs.ledger.procrustes_align(source, target, scaling: 'bool' = True, reflection: 'bool' = False) (die Implementierung direkt: import shapestats; shapestats.procrustes_align(source, target, scaling: 'bool' = True, reflection: 'bool' = False); aus dem Register: opsshapestat.get("procrustes_align"))

Verwendung

> Für diesen Operator gibt es noch keine Übersetzung. Es folgt der Originaltext unverändert.

*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`。

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie shape_statistics

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• shapestat_landmark_tour — py -3.11 examples/shapestat_landmark_tour.py

Typkompatible Folge-Operatoren (nehmen `points` als Eingabe)

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

Gleiche Kategorie (`procrustes`)

procrustes_fit · procrustes_distance · generalized_procrustes · shape_mean

*Provenance: shapestats.py — SHAPESTAT Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

procrustes_align — SHAPESTAT procrustes op