tb_quat_normalize_image — 2D `typed` op

• 資料種類:qimage → qimage

• 呼叫:fullseye.apply(img, "tb_quat_normalize_image", a=0.5, b=0.5)(2-D 的模型是一張圖 + 兩個純量旋鈕 a,b∈[0,1])

tb_quat_normalize_image: input → output

*圖為在 128×128 合成輸入上實際執行的輸出。左為輸入，右為輸出。點雲以俯視散點顯示(亮度 = z)，一維序列為折線，體資料為沿 z 的最大值投影，影片為中間影格，複數影像為振幅；無法成像的回傳值直接顯示數值。*

*旋鈕 a 不改變輸出(實測: 0.1 / 0.5 / 0.9 相同)。*

*旋鈕 b 不改變輸出(實測: 0.1 / 0.5 / 0.9 相同)。*

階段(前置運算子 → 本運算子，由左至右):

▸ tb_quat_normalize_image: stages (docs site)

換別的影像(合成場景 / 照片 / 硬幣。上排為輸入，下排為對應輸出。旋鈕取預設):

▸ tb_quat_normalize_image: other inputs (docs site)

用法

逐像素歸一化為單位模。→ (H, W, 4)。

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

Fail-closed on a zero pixel. A quaternion image routinely contains exact

zeros — a black pixel is `(0,0,0,0)` — so the case is not hypothetical, and

a zero quaternion has no direction to normalise towards. It is refused by

name, with the count and the first offending pixel's row and column in the

message, rather than divided by `norm + eps`: that idiom returns zero, and

a zero used as a rotor becomes the identity rotation with no exception

and no NaN to mark it. (`pose_quat.quat_normalize` did exactly that until

2026-09-01 and now fail-closes too; see :func:quat_color_rotate.)

Raises `ValueError`: any pixel has modulus 0.

Typed bridge of the quat op `quat_normalize_image into the 2-D evolution registry: the same implementation, called under the op(v, a, b) convention. This op has no tunable parameter; a and b` are unused.

參考(範例資料・文獻)

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

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

在 Studio 中試試

下面的程式已確認可以執行(與圖相同的輸入)。在 Studio 說明中，此區塊會變成按鈕，可當場載入並執行。

img_to_rgb 0.50 0.50
tb_rgb_to_quaternion 0.50 0.50
tb_quat_normalize_image 0.50 0.50

▸ Load this pipeline · Load & run

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

下面的範例呼叫的是底層帳本運算子 quat_normalize_image。此橋接運算子只是把同一實作適配為 fn(v, a, b) 慣例，行為完全相同(只是呼叫形式不同)。

• quaternion_monogenic — py -3.11 examples/quaternion_monogenic.py

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

identity · tb_quaternion_to_rgb · tb_quat_norm · tb_quat_conjugate_image · tb_monogenic_amplitude · tb_monogenic_phase · tb_monogenic_orientation · tb_quat_color_rotate

同類別(`typed`)

tb_points_to_voxel · tb_estimate_point_normals · tb_iss_keypoints · tb_project_points · tb_render_point_depth · tb_statistical_outlier_removal · tb_radius_outlier_removal · tb_voxel_grid_downsample

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

tb_quat_normalize_image — 2D typed op

用法