normalize — SHAPE2D descriptor op

• Datenarten: efdmodel → matrix

• Aufruf: import fullseye as fs; fs.ledger.normalize(model, size_invariant=True) (die Implementierung direkt: import fourierdesc; fourierdesc.normalize(model, size_invariant=True); aus dem Register: opsshape2d.get("normalize"))

Verwendung

Wandelt EFD-Koeffizienten in die Koeffizienten der "kanonischen Pose" um (ausgerichtet an der 1. Harmonischen).

Kanonisierung nach Kuhl–Giardina: (1) Beliebigkeit des Startpunkts über die Phase der 1. Harmonischen entfernen, (2) die lange Achse der 1. Ellipse auf die Bezugsachse drehen und so die Orientierung angleichen, (3) durch die Länge der langen Achse der 1. Harmonischen teilen und so die Größe angleichen. Gedacht für "Rekonstruktion in kanonischer Pose", etwa das Überlagern oder Mitteln mehrerer Formen.

Achtung (honest): Bei Formen, deren 1. Harmonische nahezu kreisförmig ist (lange Achse ≈ kurze Achse), ist die Phase (theta/psi) schlecht konditioniert und instabil. Für invariantes Matching nicht diese Funktion, sondern invariants / descriptor_distance (singulärwertbasiert) verwenden.

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie shape_description_2d

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)

• piv_flow_from_particles — py -3.11 examples/piv_flow_from_particles.py

• poc_exoplanet_transit — py -3.11 examples/poc_exoplanet_transit.py

Typkompatible Folge-Operatoren (nehmen matrix als Eingabe)

contour_epicycle_chain · contour_fourier_truncation_energy

Gleiche Kategorie (descriptor)

elliptic_fourier · reconstruct · invariants · descriptor_distance · fourier_smooth · from_xld · contour_fourier_complex · contour_epicycle_chain


*Provenance: fourierdesc.py — SHAPE2D 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.