color_transfer — COLORTRANSPORT matching op

• 資料種類:rgbimage × rgbimage → rgbimage

• 呼叫: import fullseye as fs; fs.ledger.color_transfer(src, ref, method='reinhard', space='lab')(要直接呼叫實作,import colortransport; colortransport.color_transfer(src, ref, method='reinhard', space='lab');從台帳取用則 opscolortransport.get("color_transfer"))

用法

把 src 的色調向 ref 靠攏。

Parameters

src, ref : array_like

(..., 3) 的 sRGB([0, 1] 的 float,或整數 dtype)。

大小可以不同(只使用統計量)。

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

• "reinhard" —— 只對齊各通道的平均值與標準差(Reinhard, Ashikhmin, Gooch & Shirley, IEEE CG&A 21(5), 2001)。其前提是各通道為單峰常態分布這一假定。在前景與背景明顯分開的雙峰影像上,平均值與變異數雖然一致,得到的卻是哪個峰都對不上的顏色(不會拋出例外)。

• "gaussian" —— 連同共變異數一起搬運的 Monge 映射。相關性得以保持。

• "histogram" —— 逐通道的精確直方圖匹配。邊際分布完全一致,但通道間的相關性會被破壞。

space : {"lab", "rgb"}

計算統計量的空間。預設的 lab 使用 imgmetrics 中的實作。

Returns

ndarray

與 src 形狀相同的 sRGB [0, 1](色域外的值會被截斷)。

背景知識指南(該運算子背後的物理與規範)

• colorimetry — 測色與光譜知識 —— 顏色只由「光譜 × 光源 × 觀察者」決定

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• color_transport — py -3.11 examples/color_transport.py

型別可銜接的下一個運算子(可接受 rgbimage 作為輸入)

—

同類別(matching)

histogram_match · gaussian_transport_map


*Provenance: colortransport.py — COLORTRANSPORT 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.