specular_coefficient_map — SPECULAR `dichromatic` op

• Datenarten: rgbimage → image2d

• Aufruf: 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) (oder opsspecular.get("specular_coefficient_map"))

Verwendung

Der skalare Grenzflächen-(Glanz-)Koeffizient des dichromatischen Modells. → (H, W).

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

The same decomposition as :func: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 :func:specular_diffuse_split exactly, by construction — the two

operators share one core.

Arguments, guards and honest limits are identical to

:func:specular_diffuse_split — including the fact that the two guards

bound gross violations only.

Raises `ValueError`: exactly the same conditions as

:func: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*).

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie specular_photometric

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• specular_photometric — py -3.11 examples/specular_photometric.py

Typkompatible Folge-Operatoren (nehmen `image2d` als Eingabe)

polarization_render

Gleiche Kategorie (`dichromatic`)

specular_diffuse_split · specular_free_transform · illuminant_from_dichromatic_planes

*Provenance: specularity.py — SPECULAR Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

specular_coefficient_map — SPECULAR dichromatic op