evidence_quantile — IMGFORENSICS calibration op

資料種類:measurement × tabletable

呼叫:import imgforensics; imgforensics.evidence_quantile(measurement, null, higher_is_stronger=True)(或 opsimgforensics.get("evidence_quantile"))

用法

證據量落在乾淨分布的什麼位置。不給出判定。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

`null_distribution` の出力を消費する側。返すのは「清浄な組の何 % より

外側か」であって、「改竄されている」ではない ―― 外側に座ることは、

その条件で珍しいことしか意味しない(珍しい清浄画像は存在する)。

Parameters

----------

measurement : float

測った証拠量(`hash_distance` の返り値など)。

null : dict

:func:null_distribution の返り値。

higher_is_stronger : bool

PCE や相関のように大きいほど強い証拠なら `True`。

ハミング距離のように小さいほど強い証拠なら `False`。

既定に頼らず必ず考えること —— ここを間違えると、いちばん証拠の

強い組が「まったく珍しくない」と出る(例外は出ない)。

Returns

-------

dict

`beyond_fraction`(清浄分布のうち、この値より内側にある割合 =

清浄な組の何 % より外側に座るか。`[0, 1]` の連続値)/

`z(標準偏差の何倍か。ばらつき 0 なら None)/ caveats`。

Notes

-----

`beyond_fractionnull が持つ分位点(min` / 5 / 25 / 50 / 75 /

95 / 99 パーセンタイル / `max`)を節として **区分線形に内挿した経験分布

関数**。節の上では厳密、節の間は線形近似で、`min` より内側なら 0、

`max` より外側なら 1 に飽和する(標本の外へは外挿しない)。

`higher_is_stronger=False` なら 1 から引いた側を返す。清浄な値がすべて

同じで節が重なる場合、その値ちょうどは 0.5(中央順位)に置く。

參考(範例資料・文獻)

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

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

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

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

image_forensics_auditpy -3.11 examples/image_forensics_audit.py

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

同類別(calibration)

null_distribution


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

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