rgb_to_quaternion — QUAT convert op

• データ種: rgbimage → qimage

• 呼び出し: import fullseye as fs; fs.ledger.rgb_to_quaternion(image_rgb) -> 'np.ndarray' (実装を直接呼ぶなら import quatimage; quatimage.rgb_to_quaternion(image_rgb) -> 'np.ndarray'、台帳から引くなら opsquat.get("rgb_to_quaternion"))

使い方

カラー画像を純四元数 0 + R i + G j + B k として埋め込む。→ (H, W, 4)。

> 以下の詳細説明は原文のままです —— 要約と見出しは訳出済み。

Sangwine's 1996 encoding, and the entry point of the whole colour half of this module: once a pixel is a quaternion, q x conj(q) rotates its colour

and qft2 transforms the three channels as one hypercomplex signal instead of three unrelated real ones.

The scalar (w) component is set to exactly zero — a *pure* quaternion — because that is what makes the conjugation a 3-D rotation. Values are not

clamped: linear RGB after black-level subtraction legitimately goes negative, and clipping it would change the colour direction, which is the quantity every operator downstream reads.

Raises ValueError: *image_rgb* is not a finite (H, W, 3) numeric array, is complex / bool / string-typed / masked, or exceeds MAX_PIXELS.

詳しい使い方ガイド

• quaternion_monogenic ファミリ ガイド

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

• サンプルデータ カタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。

• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。

• アルゴリズムの正典(著者・年)と用途は上記ファミリ使い方ガイドに記載。

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

• quaternion_monogenic — py -3.11 examples/quaternion_monogenic.py

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

quaternion_to_rgb · quat_norm · quat_conjugate_image · quat_normalize_image · quat_image_multiply · monogenic_amplitude · monogenic_phase · monogenic_orientation

同カテゴリ(convert)

quaternion_to_rgb · quat_norm


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

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