matrix_to_descriptor — REPRCONV `descriptor` op

• Datenarten: matrix → descriptor

• Aufruf: import fullseye as fs; fs.ledger.matrix_to_descriptor(matrix) (die Implementierung direkt: import reprconv; reprconv.matrix_to_descriptor(matrix); aus dem Register: opsreprconv.get("matrix_to_descriptor"))

Verwendung

matrix → Deskriptor. Die Umkehrung von descriptor_to_matrix.

Eine 1-zeilige Matrix (1, n) wird zu (n,) zurückgeführt (weil das der ursprüngliche 1-D-Deskriptor ist). 2 oder mehr Zeilen bleiben unverändert. Diese Asymmetrie ist beabsichtigt: Ohne sie würde der Hin- und Rückweg descriptor -> matrix -> descriptor die Form still von (n,) zu (1,n) ändern = eine Typlüge in Reinform.

★ Ein gemessener und belassener irreversibler Punkt: Im Gegenzug wird ein Deskriptor, der ursprünglich 2-D (1, n) war, nach dem Hin- und Rückweg zu 1-D (n,) -- eine (1,n)-Matrix kann "einen eingepackten 1-D-Deskriptor" nicht von "einem Deskriptorbündel mit nur 1 Zeile" unterscheiden, daher lässt sich nur dieser 1 Fall grundsätzlich nicht wiederherstellen. Alle Werte bleiben erhalten, der Verlust ist also nur die Metainformation "es gab 1 Zeile". Vor die Wahl gestellt, welche Seite irreversibel wird, wurde die überwältigende Mehrheit von descriptor (gemessen: 12 von 14 Producern sind 1-D) auf die exakte Seite gelegt. tests/test_reprconv.py::test_one_row_descriptor_ambiguity_is_documented fixiert dieses Loch, ohne es zu stopfen (versteckt man es, ändert sich die Form eines Tages stillschweigend).

Args:

matrix: (m, n) reelles Array.

Returns:

(n,) bei m == 1, sonst (m, n).

Raises:

ValueError: nicht 2-D / nicht endlich.

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)

• representation_conversion — py -3.11 examples/representation_conversion.py

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

descriptor_to_matrix · descriptor_to_table

Gleiche Kategorie (`descriptor`)

descriptor_to_matrix · descriptor_to_table

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

matrix_to_descriptor — REPRCONV descriptor op