specular_free_transform — SPECULAR dichromatic op

資料種類:rgbimagergbimage

呼叫: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_photometricpy -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 自動產生(請勿手動編輯)。*

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