SPECTRAL COLOUR KITv1.0 / 2026

把颜色从光谱
算到屏幕上

一套可审计的 Python 色彩科学与光谱渲染库。含 CIE 数据、同色异谱构造器、路径追踪积分器,以及一套能证明它们算对了的测试。

如果你要找的是生产级光谱渲染器,请直接用 Mitsuba 3(免费,比我强得多)。这套东西解决的是另一个问题——见下面的「先看这三个免费的」。

它解决什么问题

"颜色"是三个数。但那三个数是一次积分的结果:

X = k ∫ S(λ) R(λ) x̄(λ) dλ
Y = k ∫ S(λ) R(λ) ȳ(λ) dλ
Z = k ∫ S(λ) R(λ) z̄(λ) dλ

反射率 R(λ) 是 380–780nm 上的连续函数,按 5nm 采样是 81 个数;积分之后只剩 3 个。这个映射的核有 78 维——无穷多组完全不同的曲线,在三个数上完全相同。

它们在同一个光源下看起来一样,换一盏灯就不一样。这就是同色异谱。

两块样品在 A 光源下明显不同
同一对样品,在 A(白炽灯)下:ΔE₀₀ = 28.05。在 D65 下是 0.0000。

里面有什么

模块作用
colorimetryCMF、16 个标准光源、XYZ/Lab、CIEDE2000、Bradford、sRGB、同色异谱指数
metamer用零空间投影构造精确同色异谱对(不是搜索,是解方程)
spectral81 波长光谱渲染,快慢两条独立路径
integrator路径追踪,含 GGX 多次散射补偿
verify/五个测试:白炉、GGX 白炉、色度学对拍、双路径一致性、白平衡口径对照
data/CIE 1931/1964 CMF(1nm)+ ColorChecker 24 色光谱

不只是代码

附赠为什么它值钱
命令行工具
python -m truth render / metamer / furnace / check
不用写一行 Python 就能看到一张图。买完的第一分钟就有产出。
14 条踩坑清单
docs/TROUBLESHOOTING.md
白炉通过但场景偏暗、GGX 读数 2.0、零空间维度搞错、相机矩阵静默失败…… 每条都是"物理对但结果不对"的真实案例,附症状→原因→修法。这份东西大概能省你几天。
性能基准
examples/04_bench.py
608k 光线/秒、220k 路径/秒、1080p@256spp 约 40 分钟。先知道能不能用于真实项目,再决定要不要投入。
材质球阵列场景
scenes/materials.json
五个粗糙度从 0.10 到 1.00 的金属球 + 面光源。用它看 GGX 补偿前后的差别,一眼就懂。
一键自检
python -m truth check
装好之后跑一条命令,七项检查全部通过才算装对。不用猜。
两份调研档案
docs/BLENDER_ALIGNMENT.md
docs/VERIFICATION_METHODS.md
2400 行,写代码之前做的调研。跨引擎像素级对齐的完整协议(含 Cycles 源码行号)、 渲染正确性验证的方法学(卡方检验、MIS 方差、6 层归因阶梯、24 条陷阱)。 这些是"读源码 + 做实验"得来的,不是整理别人的教程。
网页版检测器
tool/mi-checker.html
包里唯一有界面的东西。双击打开,粘贴两条反射率曲线,选光源, 得到 ΔE、MI 和全光源扫描表,可以导出两页 A4 报告。 不联网、不依赖框架,给不写代码的同事也能用。

它有多准

检查结果
白炉测试(漫反射,三个 albedo)误差 ≤ 8.7e-15
GGX 白炉(含多次散射补偿)误差 ≤ 2.4e-3
不做补偿时的能量损失(α=1)62.5%
与 colour-science 0.4.7 对拍19 / 19
CIEDE2000(500 组随机值)逐位相同
快慢双路径一致性(平坦区)1.5e-4
同色异谱对的三刺激值残差1.4e-14

买之前你可能想核对:每一条都能用附带的 verify/ 脚本复现。安装好依赖、跑一遍,数字对不上可以退款。

跑起来长这样

import sys; sys.path.insert(0, ".")
from truth import metamer as M, colorimetry as C

R1, R2, info = M.design_pair(base=0.5, ref_illum="D65", test_illum="A")
print(info["deltaE_reference"])   # 0.0000   在 D65 下无法区分
print(info["deltaE_test"])        # 28.179   换到 A 灯下
print(C.cie_mi(R1, R2)["MI"])     # 28.179   跨标准光源的最大色差

适合谁

不适合:只想要一个"能算 ΔE 的网页"的人——那种东西免费的有很多。这套东西的价值在于渲染和光谱那一层。

先看这三个免费的

买之前,请先看这三样。它们都免费,而且其中两样比这套东西更强。看完还想要,再往下读。

项目它有什么它没有什么
PBRT 第四版
pbr-book.org,全文免费
渲染理论的完整推导,比这套深十倍;配套源码是工业级参考实现 英文、学术写法、从渲染方程开始,第 300 页才谈颜色
Mitsuba 3
GitHub,免费开源
光谱渲染、偏振、体积散射、JIT 加速,性能是 numpy 的几十倍 几十万行 C++,读不完;没有同色异谱的构造工具
colour-science
BSD 许可,免费
色度学的完整实现,数据比我导出的全,比我的实现成熟 只做色度学,不做渲染;没有"造一对同色异谱样品"的功能

那么这套东西剩下的价值是什么?

三样,按重要性排:

  1. 同色异谱构造器——给定两个光源,造出一对在 D65 下精确同色、在 A 下差 28 的样品。公开库里我没找到现成实现。
  2. 读得完——约 2000 行 Python,一个周末能读完每个文件。Mitsuba 读到第三个文件就放弃了。
  3. 踩坑清单——14 条真实的"物理对但结果不对"的案例。Mitsuba 有测试,但它不会告诉你为什么你的白炉过了场景还是暗的。

什么情况下不要买

你的情况建议
要上生产、要 GPU、要跑大场景不要买,用 Mitsuba 3 或 Cycles
已经写过渲染器,只是想补光谱那块不要买,PBRT 第 4 版讲得更透
只想要一个能算 ΔE 的工具不要买,免费的在线工具有很多
需要偏振、体积散射、折射焦散不要买,这套只有骨架,没做完整
想搞懂"颜色是怎么从光谱算出来的",且希望读得完可以买
要做涂料/纺织/印刷的色彩一致性分析可以买——这块没有别的现成工具
学生、转行、需要一套能跑通的参考实现可以买

买错了对你我都麻烦:你会退货、会觉得被骗;我会收到退款和差评。所以上面这张表请认真看。

入门版
¥0
  • 26 个色度学函数(CMF / Lab / ΔE00 / CAT / MI)
  • 同色异谱对构造器
  • 4 个典型光源(D65 / D50 / A / FL11)+ 两套 CMF + ColorChecker
  • 10 页精简手册 + 2 页报告样例
  • 检测器(单对计算,不可导出)
  • 24 色展示档案 + 60 秒片子
  • 一张 2×2 对比图
下载
完整版
¥79
  • 入门版的全部内容(含 16 个标准光源)
  • 光谱渲染(81 波长,快慢双路径)
  • 路径追踪 + GGX 多次散射补偿
  • 5 个验证脚本(白炉 / GGX / 对拍 / 双路径 / 白平衡)
  • 白标报告:换成你公司名,直接交给客户
  • 检测器完整版(可导 A4 报告)
  • 1135 行跨引擎对齐协议 + 1287 行验证方法学 + 19 个源码片段
  • 14 条踩坑清单 + 性能基准 + 材质球场景
购买
整合版 推荐
¥109
  • 完整版的全部内容
  • + 数据包:16 个标准光源、两套 CMF、29 对样品
  • + CSV 宽表(Excel 双击开)+ JSON
  • + 口径说明(四张表采样不同、怎么复现 2.15e-5)
  • 比分开买省 ¥19
  • 给"既要写代码,又要把数据交给别人"的场景
购买
只要数据
¥49
  • 16 个 CIE 标准光源(CSV / JSON)
  • 1931 2° 与 1964 10° 两套 CMF(1 nm)
  • ColorChecker 24 色反射率
  • 5 对精选样品 + 24 对图鉴
  • 每对的 ΔE00 / MI / 残差
  • 踩过坑的口径说明
看详情
商业授权
¥599
  • 完整版全部内容,可用于产品内嵌
  • 可用于客户交付物、团队内训
联系

当前是预览站:支付链接上架后启用。先看免费版,或点右侧「联系」直接问。
购买后 7 天内不满意可退,不用说明理由。商业授权需要说明使用场景,通常当天回复。
如果你还没看上面那两节(「先看这三个免费的」和「什么情况下不要买」),请先看。

它做不了什么

诚实列出来,省得你买完失望:快路径依赖"均匀环境 + 漫反射",有遮挡时不成立(实测偏差 11%);介质(玻璃)只有骨架,没有完整 Fresnel 分光;只用 CIE 1931 2° 观察者;单一光源。完整清单在 docs/NUMBERS.md 最后一节。