color_transfer — COLORTRANSPORT matching op

• Datenarten: rgbimage × rgbimage → rgbimage

• Aufruf: import fullseye as fs; fs.ledger.color_transfer(src, ref, method='reinhard', space='lab') (die Implementierung direkt: import colortransport; colortransport.color_transfer(src, ref, method='reinhard', space='lab'); aus dem Register: opscolortransport.get("color_transfer"))

Verwendung

Verschiebt den Farbstich von src in Richtung ref.

Parameters

src, ref : array_like

(..., 3) sRGB (float in [0, 1] oder ganzzahliger dtype).

Die Größen dürfen sich unterscheiden (es werden nur Statistiken verwendet).

method : {"reinhard", "gaussian", "histogram"}

• "reinhard" —— gleicht nur Mittelwert und Standardabweichung jedes Kanals an (Reinhard, Ashikhmin, Gooch & Shirley, IEEE CG&A 21(5), 2001). Dabei wirkt die Annahme, dass jeder Kanal unimodal normalverteilt ist. Bei einem bimodalen Bild mit klar getrenntem Vorder- und Hintergrund stimmen Mittelwert und Varianz, doch es entsteht eine Farbe, die keinen der beiden Gipfel trifft (es wird keine Ausnahme ausgelöst).

• "gaussian" —— Monge-Abbildung, die die Kovarianz mitträgt. Die Korrelation bleibt erhalten.

• "histogram" —— exakter Histogrammabgleich pro Kanal. Die Randverteilungen stimmen exakt überein, aber die Korrelation zwischen den Kanälen geht verloren.

space : {"lab", "rgb"}

Raum, in dem die Statistiken gebildet werden. Der Standard lab nutzt die Implementierung aus imgmetrics.

Returns

ndarray

sRGB [0, 1] mit derselben Form wie src (Werte außerhalb des Farbraums werden abgeschnitten).

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 rgbimage als Eingabe)

—

Gleiche Kategorie (matching)

histogram_match · gaussian_transport_map


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