typed op• 数据种类:qimage → qimage
• 调用:fullseye.apply(img, "tb_quat_color_filter", a=0.5, b=0.5)(2-D 的模型是一张图 + 两个标量旋钮 a,b∈[0,1])
*无图: 该算子以 qimage 为输入。从图像开始的 Studio 程序无法到达该类型，请参见下方的可运行示例。*
精确地保留或去除某一颜色方向。→ (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。
• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。
• (暂无)
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_angle_3points · tb_project_points · tb_render_point_depth · tb_statistical_outlier_removal · tb_radius_outlier_removal
*Provenance: ops.py — 2D 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.