model op• Datenarten: shapemodel → signal
• Aufruf: import fullseye as fs; fs.ledger.shape_explained_variance(model) (die Implementierung direkt: import shapestats; shapestats.shape_explained_variance(model); aus dem Register: opsshapestat.get("shape_explained_variance"))
Anteil der erklärten Varianz je Hauptkomponente (Summe 1). → (k,).
Formel: variance / total_variance. Der Nenner ist model["total_variance"] (die Gesamtvarianz, die shape_pca aus allen Singulärwerten berechnet hat), sonst variance.sum().
• model: Rückgabewert von shape_pca. Fehlt ein Pflichtschlüssel, ValueError.
• Rückgabewert: (k,) float64, jedes Element in [0, 1]. Bei shape_pca(n_components=0) (alle Komponenten) ist die Summe 1. Bei einem mit n_components abgeschnittenen Modell ist die Summe kleiner als 1 (es fehlt der Anteil der abgeschnittenen Komponenten) -- um abzulesen, "wie viel die obersten k Komponenten erklären", ist das sogar richtig.
• Ist die Gesamtvarianz 0 (alle Individuen haben dieselbe Form), werden alle Elemente 0 zurückgegeben (keine Division durch 0).
Die Varianz von shape_pca ist die Stichprobenvarianz (geteilt durch K-1), daher blähen sich bei wenigen Individuen die absoluten Eigenwerte auf, doch diese Größe ist als Verhältnis kaum betroffen. Mit der kumulativen Summe (cumsum) bestimmen, "wie viele Komponenten für 99 % nötig sind", und an cumulative von shape_mahalanobis oder n_modes von shape_synthesize übergeben.
• Leitfaden zur Familie shape_statistics
• 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.
• shapestat_landmark_tour — py -3.11 examples/shapestat_landmark_tour.py
signal als Eingabe)model)shape_pca · shape_project · shape_reconstruct · shape_mahalanobis · shape_synthesize
*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.