apply_transport — COLORTRANSPORT plan_use op

• Datenarten: transport_plan × signal → signal

• Aufruf: import fullseye as fs; fs.ledger.apply_transport(plan, target_values) (die Implementierung direkt: import colortransport; colortransport.apply_transport(plan, target_values); aus dem Register: opscolortransport.get("apply_transport"))

Verwendung

Zieht target_values über einen Transportplan auf die Quellpunkte zurück (die baryzentrische Abbildung).

Für jede Zeile (Quelle) wird der mit der transportierten Masse gewichtete Mittelwert der Zielwerte zurückgegeben. Das ist der Einstieg, um "mit dem Plan das Bild zu korrigieren" -- wird ein Plan nur erzeugt und nie verwendet, wird die Ausgabe von sinkhorn zur Sackgasse im Register (die Gestalt des Typs "Einstieg vorhanden, aber keine verbrauchende op", in den dieses repo wiederholt getreten ist).

Eine Zeile mit Masse null hat kein Ziel -- mit 0 aufzufüllen würde stillschweigend "schwarze Pixel" einmischen, daher ValueError.

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

• colorimetry — Farbmetrik und Spektren — Farbe ist nur durch Spektrum × Lichtart × Beobachter bestimmt

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)

• color_transport — py -3.11 examples/color_transport.py

Typkompatible Folge-Operatoren (nehmen signal als Eingabe)

wasserstein_1d · transport_plan_1d · sinkhorn · sinkhorn_distance · sinkhorn_divergence

Gleiche Kategorie (plan_use)

transport_cost


*Provenance: colortransport.py — COLORTRANSPORT 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.