quat_image_multiply — QUAT algebra op

• 資料種類:qimage × qimage → qimage

• 呼叫: import fullseye as fs; fs.ledger.quat_image_multiply(qimage, other, side) -> 'np.ndarray'(要直接呼叫實作,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 _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_monogenic — py -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.