specular_free_transform — SPECULAR `dichromatic` op

• 数据种类:rgbimage → rgbimage

• 调用:import specularity; specularity.specular_free_transform(image_rgb, illuminant_rgb=(1.0, 1.0, 1.0))(或 opsspecular.get("specular_free_transform"))

用法

投影掉光源方向:高光碰不到的那部分图像。→ (H, W, 3)。

> 以下的详细说明为原文 —— 摘要与标题已翻译。

`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

:func: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 :func:specular_diffuse_split.

Raises `ValueError: *image_rgb* is not a valid (H, W, 3)` linear

RGB image (see :func:specular_diffuse_split); *illuminant_rgb* is not a

non-zero 3-vector.

详细使用指南

• specular_photometric 族使用指南

参考(示例数据・文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者・年份)与用途见上面的族使用指南。

可运行的示例(实际调用该算子并已验证的样例)

• specular_photometric — py -3.11 examples/specular_photometric.py

类型可衔接的下一个算子(可接受 `rgbimage` 作为输入)

specular_diffuse_split · specular_coefficient_map · illuminant_from_dichromatic_planes

同类别(`dichromatic`)

specular_diffuse_split · specular_coefficient_map · illuminant_from_dichromatic_planes

*Provenance: specularity.py — SPECULAR 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

specular_free_transform — SPECULAR dichromatic op

用法