fullseye

sinkhorn — COLORTRANSPORT transport op

• データ種: signal × signal × matrix → transport_plan
• 呼び出し: import fullseye as fs; fs.ledger.sinkhorn(a, b, cost, reg=0.05, n_iter=2000, tol=1e-09) (実装を直接呼ぶなら import colortransport; colortransport.sinkhorn(a, b, cost, reg=0.05, n_iter=2000, tol=1e-09)、台帳から引くなら opscolortransport.get("sinkhorn"))

使い方

エントロピー正則化つき最適輸送の計画(Cuturi, NIPS 2013)。

厳密解ではない。 reg を小さくすると厳密解に近づくが、同時に 数値的に不安定になる(指数がアンダーフローする)。reg を下げると 厳密解との差が縮むこと自体をテストで固定してある。

Returns

ndarray (n, m) の輸送計画。行和・列和は a / b に一致する (tol まで)。収束しなければ RuntimeError ―― 収束しないまま 最後の反復を返すと、行和が合っていない計画が黙って下流へ流れる。

背景知識ガイド(この 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(transport_plan を入力に取れる)

transport_cost · apply_transport

同カテゴリ(transport)

wasserstein_1d · transport_plan_1d · sinkhorn_distance · sinkhorn_divergence

---

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

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

This site is open source. Improve this page.