typed op• Data kinds: qimage → qimage
• Call: fullseye.apply(img, "tb_quat_color_filter", a=0.5, b=0.5) (2-D model = एक image + दो scalar knobs a,b∈[0,1])
*Figure synthetic 128×128 input पर सच में चलाकर मिला output है। बाईं ओर input, दाईं ओर output। Point clouds ऊपर से देखे गए scatter के रूप में (brightness = z), 1-D series line के रूप में, volumes z दिशा में maximum-intensity projection के रूप में, videos बीच के frame के रूप में, complex images amplitude के रूप में, और जो return values चित्र नहीं बन सकते वे स्वयं values के रूप में दिखाए जाते हैं।*
*Knob a output नहीं बदलता (मापा गया: 0.1 / 0.5 / 0.9 पर एक जैसा)।*
*Knob b output नहीं बदलता (मापा गया: 0.1 / 0.5 / 0.9 पर एक जैसा)।*
Stages (पहले आने वाले ops → यह op, बाएँ से क्रम में):
▸ tb_quat_color_filter: stages का figure (docs site)
दूसरी images पर भी (synthetic scene / photo / coins। ऊपर की row में inputs, नीचे की row में उनके outputs। Knobs default पर):
▸ tb_quat_color_filter: दूसरी images पर output (docs site)
एक रंग direction को exact रूप से रखता या हटाता है। → (H, W, 4)।
> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।
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.
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 quat_color_rotate and qft2.
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 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.
• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।
• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।
नीचे का program सच में चलता है, यह जाँचा गया है (figure वाला ही input)। Studio की help में यह block buttons बन जाता है, जिनसे इसे वहीं load करके चलाया जा सकता है।
img_to_rgb 0.50 0.50 tb_rgb_to_quaternion 0.50 0.50 tb_quat_color_filter 0.50 0.50
▸ यह pipeline load करें · Load करके चलाएँ
नीचे के उदाहरण मूल ledger op quat_color_filter को call करते हैं। यह bridge op वही implementation है, बस fn(v, a, b) convention के अनुसार ढाला गया है, इसलिए व्यवहार वैसा ही लागू होता है (केवल call का रूप अलग है)।
• quaternion_monogenic — py -3.11 examples/quaternion_monogenic.py
qimage को input के रूप में लेते हैं)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 operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.