mirror_plane_from_pairs — SHAPESTAT symmetry op

• Datenarten: points → matrix

• Aufruf: import fullseye as fs; fs.ledger.mirror_plane_from_pairs(landmarks, pairs=None, midline=None) (die Implementierung direkt: import shapestats; shapestats.mirror_plane_from_pairs(landmarks, pairs=None, midline=None); aus dem Register: opsshapestat.get("mirror_plane_from_pairs"))

Verwendung

Bestimmt die Medianebene aus korrespondierenden linken/rechten Landmarken. → (2, 3) (Zeile 1 = Punkt, Zeile 2 = Normale).

Die Mittelpunkte der Links-rechts-Paare (i, j) liegen alle auf der Mediansagittalebene. Es genügt also, an diese Mittelpunktmenge eine Ebene anzupassen -- entscheidend ist, dass die Ebene unabhängig vom Ausmaß der Deformation bestimmt wird; sie ist etwas anderes als die Ebene, die das Residuum minimiert (symmetry3d.detect_reflection_symmetry).

★ Messung vom 2026-09-06: Bei einer einseitigen Deformation von 6.4 mm wich die residuumsoptimale Ebene von der wahren Mediansagittalebene um 2.92 mm / 1.72 Grad ab und löschte 46 % der Asymmetrie (Verstärkung 0.54). Mit dieser Landmarkenebene beträgt die Verstärkung 1.03. Zum Finden die residuumsoptimale Ebene, zum Beziffern diese hier.

*midline* sind die Indizes von Landmarken auf der Mittellinie (die kein Paar bilden). Werden sie angegeben, kommen sie zur Mittelpunktmenge hinzu und stabilisieren die Ebenenanpassung.

pairs=None ist die Konvention, die erste Hälfte mit der zweiten Hälfte zu paaren (i und i + N//2). In der Morphometrie ist das Speicherformat üblich, erst alle linken Landmarken und dann die rechten in derselben Reihenfolge aufzuführen, und daran ist dies angepasst. Eine ungerade Punktzahl wird abgewiesen -- schneidet man eine nicht halbierbare Reihenfolge stillschweigend ab, verschieben sich die Paare um je 1, und bei allen kehrt sich das Vorzeichen um.

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 matrix als Eingabe)

—

Gleiche Kategorie (symmetry)

landmark_asymmetry


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

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