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.