fullseye

flow_to_rgbimage — REPRCONV flow op

• データ種: flow_dense → rgbimage
• 呼び出し: import fullseye as fs; fs.ledger.flow_to_rgbimage(flow, index=None, scale=None) (実装を直接呼ぶなら import reprconv; reprconv.flow_to_rgbimage(flow, index=None, scale=None)、台帳から引くなら opsreprconv.get("flow_to_rgbimage"))

使い方

密なシーンフローの 1 スライス → 色相=向き・明度=速さの rgbimage。

光学フローの標準的な可視化(色相環)を 3-D フローの z スライスに当てる: hue = atan2(dy, dx)(度で 0-360)、value = |(dy, dx)| / scale、 彩度は 1。dz は捨てる —— 面内成分だけの図であることを明示する (捨てた成分を色に混ぜると「見えている色が何の量か」が誰にも言えなくなる)。

一方向。色相環の凡例は図の側で必ず一緒に焼くこと(色の意味が書いていない フロー図は、綺麗なだけで読めない)。

Args: flow: (3, D, H, W)。 index: 取り出す z スライス(既定 = 中央)。 scale: 明度 1.0 に対応する面内速さ(既定 = そのスライスの最大値。 0 なら全面黒を返す)。 Returns: (H, W, 3) float64、値域 [0, 1]。 Raises: ValueError: 密フローでない / index が範囲外 / scale <= 0。

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

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

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

• representation_conversion — py -3.11 examples/representation_conversion.py

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

—

同カテゴリ(flow)

flow_magnitude · flow_speed · flow_apply

---

Provenance: reprconv.py — REPRCONV 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.