quat_image_multiply — QUAT algebra op

資料種類:qimage × qimageqimage

呼叫:import quatimage; quatimage.quat_image_multiply(qimage, other, side) -> 'np.ndarray'(或 opsquat.get("quat_image_multiply"))

用法

四元數影像與一個四元數或一個場的 Hamilton 積。→ (H, W, 4)。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

`side="left" computes other * qimage; side="right"` computes

`qimage * other. **There is no default** — see :func:_require_side`. The

two results are genuinely different objects, not a sign convention: measured

on a standard-normal `(32, 32, 4)` field against a unit rotor,

`max|left - right| = 3.143 and mean|left - right| = 0.4948` on data

whose own extreme is 3.372 — that is, the two answers differ by as much as

the data itself. Neither raises, neither is NaN, and both look like a

perfectly good quaternion image.

*other* is either a single quaternion (a `(4,)` array-like) or a full

`(H, W, 4)` field of the same shape; anything else is refused rather than

broadcast, because NumPy would happily broadcast a `(H, 4)` array along the

wrong axis and produce an image-shaped answer to a different question.

Raises `ValueError`: either input is not a valid quaternion field;

*other* is neither `(4,) nor exactly qimage`'s shape; *side* is not

`'left' / 'right'`.

詳細使用指南

quaternion_monogenic 族使用指南

參考(範例資料・文獻)

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

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

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

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

quaternion_monogenicpy -3.11 examples/quaternion_monogenic.py

型別可銜接的下一個運算子(可接受 qimage 作為輸入)

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

同類別(algebra)

quat_conjugate_image · quat_normalize_image


*Provenance: quatimage.py — QUAT 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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