tid2013_evaluate — IMGMETRICS iqa op

• 資料種類:any × any → table

• 呼叫: import fullseye as fs; fs.ledger.tid2013_evaluate(root, fn: 'Callable[[np.ndarray, np.ndarray], float]', *, subset=None, luma: 'str' = 'limited_u8', index: 'Optional[dict]' = None) -> 'dict'(要直接呼叫實作,import iqatid; iqatid.tid2013_evaluate(root, fn: 'Callable[[np.ndarray, np.ndarray], float]', *, subset=None, luma: 'str' = 'limited_u8', index: 'Optional[dict]' = None) -> 'dict';從台帳取用則 opsimgmetrics.get("tid2013_evaluate"))

用法

將自己的指標 fn(ref, dist) -> float 套用於 TID2013 的影像對,回傳與 MOS 的等級相關。

luma = "limited_u8"(傳入作者約定的 Y′ uint8 (H, W),與 psnr.txt / ssim.txt 比較時)/ "rgb"(把 uint8 (H, W, 3) 原樣傳入,與 psnrc.txt 比較時)。subset = None(全部 3000 組)/ 個數(台帳的前 n 個)/ 名稱列表(忽略大小寫, 副檔名可有可無)。參考影像 25 張只讀一次。

回傳值:values (n,)、mos (n,)、idx(台帳的列號)、names、srocc、krocc(τ_b)、n、n_inf、luma、seconds。fn 回傳 inf 是正當的(PSNR 完全一致)。在 TID2013 中,失真 18「彩度變化」的 125 組裡,有 106 組 Y′ 與參考連 1 個像素都沒有變化,作者在 psnr.txt 中把這些列寫成 100000.0,ssim.txt 為 1.0(tid2013_compare 的 inf_as)。秩相關中把 inf 視為最大的秩。Raises ValueError:luma 未知、fn 回傳的不是數或 ±inf(拒絕 nan)、subset 不合法。

詳細使用指南

• image_difference_metrics 族使用指南

參考(範例資料、文獻)

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

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

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

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

• poc_iqa_fsim_gmsd_vif — py -3.11 examples/poc_iqa_fsim_gmsd_vif.py

• poc_iqa_tid2013 — py -3.11 examples/poc_iqa_tid2013.py

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

luma_limited_u8 · rank_data · tid2013_index · tid2013_by_distortion

同類別(iqa)

luma_limited_u8 · rank_data · rank_spearman · rank_kendall_b · tid2013_published · tid2013_root · tid2013_index · tid2013_metric_values


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

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