lab_to_rgb — IMGMETRICS colorspace op

• 資料種類:lab → rgbimage

• 呼叫: import fullseye as fs; fs.ledger.lab_to_rgb(lab, white=(0.95047, 1.0, 1.08883))(要直接呼叫實作,import imgmetrics; imgmetrics.lab_to_rgb(lab, white=(0.95047, 1.0, 1.08883));從台帳取用則 opsimgmetrics.get("lab_to_rgb"))

用法

CIE L*a*b* → sRGB [0, 1]。超出色域的顏色會被截斷,因此與 rgb_to_lab 的往返只在色域內一致(有測試固定)。

步驟:把 fy = (L + 16) / 116、fx = fy + a / 500、fz = fy - b / 200 用 xyz_to_lab 的反函數還原為 XYZ(乘以 white),再乘以 XYZ→線性 RGB 的逆矩陣,然後施加 sRGB 的轉移函數。在轉移函數之前把線性 RGB 無提示地截斷到 [0, 1] —— 這就是「色域外被截斷」的實質, 不會拋出例外。

• lab:最後一軸為 3 的任意形狀。

• white:傳入與 rgb_to_lab 所用相同的白點(不做驗證)。

• 回傳值:與輸入同形的 float64,值域 [0, 1] 的帶伽瑪 sRGB。若要 8 bit,由呼叫端乘以 255 後取整。

• 失敗(MetricContractError):最後一軸不是 3。

詳細使用指南

• image_difference_metrics 族使用指南

背景知識指南(該運算子背後的物理與規範)

• colorimetry — 測色與光譜知識 —— 顏色只由「光譜 × 光源 × 觀察者」決定

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• image_quality_metrics — py -3.11 examples/image_quality_metrics.py

型別可銜接的下一個運算子(可接受 rgbimage 作為輸入)

rgb_to_lab · rgb_to_xyz · delta_e_map · luma_limited_u8 · rank_data · tid2013_index · fsimc · fsim_pair

同類別(colorspace)

rgb_to_lab · rgb_to_xyz · xyz_to_lab


*Provenance: imgmetrics.py — IMGMETRICS 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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