color_transfer — COLORTRANSPORT matching op

데이터 종류: rgbimage × rgbimagergbimage

호출: 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 は :mod:imgmetrics` の実体を使う。

Returns

-------

ndarray

`src と同じ形の sRGB [0, 1]`(色域外は切り詰められる)。

배경 지식 가이드(이 연산자 앞에 있는 물리·규약)

colorimetry — 測色と分光の知識 — 色は「分光 × 光源 × 観測者」でしか決まらない

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

color_transportpy -3.11 examples/color_transport.py

타입이 이어지는 다음 연산자(rgbimage 를 입력으로 받는 것)

같은 카테고리(matching)

histogram_match · gaussian_transport_map


*Provenance: colortransport.py — COLORTRANSPORT 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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