poisson_blend — COLORTRANSPORT `blend` op

• Datenarten: image2d × image2d × mask → image2d

• Aufruf: import colortransport; colortransport.poisson_blend(src, dst, mask, offset=(0, 0)) (oder opscolortransport.get("poisson_blend"))

Verwendung

Nahtloses Compositing, das das Gradientenfeld überträgt (Pérez, Gangnet & Blake, SIGGRAPH 2003).

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

`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)

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

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

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 `image2d` als Eingabe)

histogram_match

Gleiche Kategorie (`blend`)

—

*Provenance: colortransport.py — COLORTRANSPORT Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

poisson_blend — COLORTRANSPORT blend op