contour_fourier_truncation_energy — SHAPE2D descriptor op

• Datenarten: matrix → table

• Aufruf: import fullseye as fs; fs.ledger.contour_fourier_truncation_energy(spectrum, orders=None) (die Implementierung direkt: import fourierdesc; fourierdesc.contour_fourier_truncation_energy(spectrum, orders=None); aus dem Register: opsshape2d.get("contour_fourier_truncation_energy"))

Verwendung

Der vorhergesagte Fehler je Abbruchordnung (table) — Parsevals exakte Formel.

Für die bei Ordnung K abgeschnittene Rekonstruktion z^K ist der mittlere quadratische Fehler über die Abtastwerte exakt gleich mean|z - z^K|^2 = Σ_{|k| > K} |c_k|^2. Daher lässt sich vorab sagen, "wie viele Terme es bis auf wie viele Pixel ähnlich machen", ohne die Rekonstruktion auch nur 1-mal auszuführen.

★Die Vorhersage ist nur exakt, wenn die Koeffizientenfolge vollständig ist (wenn contour_fourier_complex mit n_harmonics=None aufgerufen wurde). Wird eine abgeschnittene Koeffizientenfolge übergeben, ist die Energie des verworfenen Teils nicht bekannt, daher ist der zurückgegebene Fehler eine untere Schranke —— das steht hier, damit ein zu klein wirkender Fehler nicht "exakt" genannt wird.

Rückgabewert: dict (table)

"order": 1-D der Abschneideordnungen K

"rms_error": vorhergesagter rms-Fehler [Einheiten der Eingabe]

"energy_fraction": Energieanteil der behaltenen Terme (0..1, monoton steigend)

"total_energy": Σ_{k≠0} |c_k|^2 (Formenergie ohne die Lage c_0)

"k_max": höchste Ordnung, die das Spektrum enthält

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)

• poc_one_stroke_epicycles — py -3.11 examples/poc_one_stroke_epicycles.py

Typkompatible Folge-Operatoren (nehmen table als Eingabe)

from_xld

Gleiche Kategorie (descriptor)

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


*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.