specular_coefficient_map — SPECULAR dichromatic op

• Data kinds: rgbimage → image2d

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

उपयोग

dichromatic model का scalar interface (specular) coefficient। → (H, W)।

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

The same decomposition as specular_diffuse_split, returning the scalar m_s(x) instead of the coloured image m_s(x) * G. That scalar is what an inspection routine thresholds: it is the amount of light the surface reflected *as a mirror does*, in the units of the input radiance, and it is zero wherever the surface behaved as a Lambertian body.

specular_coefficient_map(...) * illuminant_unit equals the second return value of specular_diffuse_split exactly, by construction — the two operators share one core.

Arguments, guards and honest limits are identical to specular_diffuse_split — including the fact that the two guards bound gross violations only.

Raises ValueError: exactly the same conditions as specular_diffuse_split (invalid image, invalid illuminant, identically zero image, body colour parallel to the illuminant, either guard firing, fewer than 3 pixels on the uniform-body route, invalid *body_rgb*).

उपयोग की विस्तृत 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 करते हैं)

• specular_photometric — py -3.11 examples/specular_photometric.py

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

polarization_render

इसी category के (dichromatic)

specular_diffuse_split · specular_free_transform · 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.