fullseye

poisson_blend — COLORTRANSPORT `blend` op

データ種: image2d × image2d × mask → image2d
呼び出し: import fullseye as fs; fs.ledger.poisson_blend(src, dst, mask, offset=(0, 0)) (実装を直接呼ぶなら import colortransport; colortransport.poisson_blend(src, dst, mask, offset=(0, 0))、台帳から引くなら opscolortransport.get("poisson_blend"))
台帳経由の戻り値: fullseye.ledger.poisson_blend(...) は宣言 out 型 image2d の値だけを返す(本体は補助情報も返す)。捨てられた側が要るときは fullseye.ledger.poisson_blend.raw(...)、または colortransport.poisson_blend を直接呼ぶ。

使い方

勾配場を運ぶ継ぎ目なし合成(Pérez, Gangnet & Blake, SIGGRAPH 2003)。

mask の内部で src の勾配を保ちつつ、境界で dst の値に一致する像を解く。よって出力は次の 2 つを構成上満たし、それが正しさの検算になる:

内部のラプラシアンが src のラプラシアンと一致(解の残差ぶんまで)
マスクの外は dst と厳密に一致(1 画素も触らない)

貼った物の色は変わる。 それが目的の処理だが、「貼った物体の色を測る」用途にそのまま流すと測っているのは貼り先の色になる。返り値は (blended, info) で、info["changed_pixels"] と info["max_shift"] が実際にどれだけ動いたかを言う。

Parameters

src : array_like 貼る絵。(H, W) または (H, W, C)。 dst : array_like 貼り先。src 以上の大きさ。 mask : array_like src と同じ (H, W) の真偽値。縁に接していてはいけない (境界条件が取れないため明示的に拒否する)。 offset : (int, int) dst の中で src の左上を置く (row, col)。

Returns

(ndarray, dict)

背景知識ガイド(この op の手前にある物理・規約)

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

参考(サンプルデータ・文献)

サンプルデータカタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。
演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。
アルゴリズムの正典(著者・年)と用途は上記ファミリ使い方ガイドに記載。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

color_transport — py -3.11 examples/color_transport.py

型が繋がる次の op(`image2d` を入力に取れる)

histogram_match

同カテゴリ(`blend`)

—

Provenance: colortransport.py — COLORTRANSPORT operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。

This site is open source. Improve this page.