specular_free_transform — SPECULAR dichromatic op

• Data kinds: rgbimage → rgbimage

• Call: import fullseye as fs; fs.ledger.specular_free_transform(image_rgb, illuminant_rgb=(1.0, 1.0, 1.0)) (implementation को सीधे call करना हो तो import specularity; specularity.specular_free_transform(image_rgb, illuminant_rgb=(1.0, 1.0, 1.0)), registry से लेना हो तो opsspecular.get("specular_free_transform"))

उपयोग

illuminant की दिशा को project करके हटाता है: image का वह भाग जिसे highlight छू नहीं सकता। → (H, W, 3)।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

I - (I.G) G for the unit illuminant colour G. Under the dichromatic model the interface term is m_s * G, so it lies entirely in the removed direction and the result is invariant to any specular term whatsoever — exactly, for any lobe shape, any strength, any spatial pattern. That is the specular-invariant subspace of Mallick et al. (2005); this operator is the projection itself, with no rotation into named channels, so it stays in RGB and composes with the rest of the family.

Use it when the *shape* of the specular lobe is unknown or the surface is textured — feature matching, edge detection and correlation all work in this subspace without any of the assumptions specular_diffuse_split needs.

This is a projection, not a picture. The result loses one of three degrees of freedom (its component along G is exactly zero everywhere) and, for an image with negative values after black-level subtraction, keeps them. It is not a displayable "highlight-removed photo" and does not claim to be; for that, use specular_diffuse_split.

Raises ValueError: *image_rgb* is not a valid (H, W, 3) linear RGB image (see specular_diffuse_split); *illuminant_rgb* is not a non-zero 3-vector.

उपयोग की विस्तृत guide

• specular_photometric family guide

संदर्भ (sample data, साहित्य)

• 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 के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• poc_leaf_disease_area — py -3.11 examples/poc_leaf_disease_area.py

• specular_photometric — py -3.11 examples/specular_photometric.py

वे अगले ops जिनसे type जुड़ता है (rgbimage को input के रूप में लेते हैं)

specular_diffuse_split · specular_coefficient_map · illuminant_from_dichromatic_planes

इसी category के (dichromatic)

specular_diffuse_split · specular_coefficient_map · illuminant_from_dichromatic_planes


*Provenance: specularity.py — SPECULAR operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.