typed op• 数据种类:qimage → qimage
• 调用:fullseye.apply(img, "tb_quat_color_filter", a=0.5, b=0.5)(2-D 的模型是一张图 + 两个标量旋钮 a,b∈[0,1])
*图为在 128×128 合成输入上实际运行的输出。左为输入，右为输出。点云以俯视散点显示(亮度 = z)，一维序列为折线，体数据为沿 z 的最大值投影，视频为中间帧，复数图像为幅值；无法成像的返回值直接显示数值。*
*旋钮 a 不改变输出(实测: 0.1 / 0.5 / 0.9 相同)。*
*旋钮 b 不改变输出(实测: 0.1 / 0.5 / 0.9 相同)。*
阶段(前置算子 → 本算子，从左到右):
▸ tb_quat_color_filter: stages (docs site)
换别的图像(合成场景 / 照片 / 硬币。上排为输入，下排为对应输出。旋钮取默认):
▸ tb_quat_color_filter: other inputs (docs site)
精确地保留或去除某一颜色方向。→ (H, W, 4)。
> 以下的详细说明为原文 —— 摘要与标题已翻译。
`mode="remove" returns v - (v.g) g for the unit RGB direction g`:
the component along `g` is exactly zero everywhere afterwards, to
machine precision (measured max residual 5.8e-16 and 6.5e-16 on two random
colour images — seed-dependent only at the 1e-16 level),
and `remove + keep` reproduces the input to 0.0 exactly.
`mode="keep" returns the complementary (v.g) g`. The scalar part is
passed through untouched in both.
There is no default mode. The two are opposites, both return a valid
picture, and neither raises — so choosing for the caller would be a coin flip
that never announces itself.
Not a new algorithm, and this docstring will not pretend otherwise
-----------------------------------------------------------------
The `remove` branch is the specular-invariant projection of Mallick et
al. (2005), which this repository already implements as
`specularity.specular_free_transform for the rgbimage` sort. Rather
than write the same three lines twice, this operator *delegates* to it — so
agreement between the two sorts is by construction rather than by luck, and a
future fix in one is a fix in both. What is added here is the `keep`
branch (which has no counterpart there) and the `qimage` sort, so the
projection composes with :func:quat_color_rotate and :func:qft2.
What this can do that a channelwise pipeline cannot
---------------------------------------------------
A per-channel filter applies a diagonal matrix, and `I - g g^T` is diagonal
only when `g is a coordinate axis. For g = (1,1,1)/sqrt(3)` — remove
the grey axis, i.e. keep only chromatic content — the *best possible*
diagonal approximation is off by `||P - diag(P)||_2 = 0.666667` in operator
norm. Concretely, a pure red pixel `(1, 0, 0)` must become
`(0.666667, -0.333333, -0.333333)`; the best diagonal filter can only reach
`(0.666667, 0, 0), an error of 0.471405` — it cannot put anything into
the green and blue channels, because it multiplies each channel by a number
and both start at zero. The impossibility is structural, not a tuning gap.
(A full 3x3 colour matrix, of course, does it exactly; see
:func:quat_color_rotate for that half of the accounting.)
Raises `ValueError: *qimage* is not a valid (H, W, 4)` field;
*direction_rgb* is not a finite non-zero 3-vector; *mode* is not
`'remove' / 'keep'`.
Typed bridge of the quat op `quat_color_filter 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 帮助中，此块会变成按钮，可当场加载并运行。
img_to_rgb 0.50 0.50 tb_rgb_to_quaternion 0.50 0.50 tb_quat_color_filter 0.50 0.50
▸ Load this pipeline · Load & run
下面的示例调用的是底层账本算子 quat_color_filter。此桥接算子只是把同一实现适配为 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_quat_normalize_image · tb_monogenic_amplitude · tb_monogenic_phase · tb_monogenic_orientation
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 自动生成(请勿手工编辑)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.