rgb_to_quaternion — QUAT convert op

• 資料種類:rgbimage → qimage

• 呼叫: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 :func: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

:data:MAX_PIXELS.

詳細使用指南

• quaternion_monogenic 族使用指南

參考(範例資料・文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者・年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• quaternion_monogenic — py -3.11 examples/quaternion_monogenic.py

型別可銜接的下一個運算子(可接受 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 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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