measure_with — IMGMETRICS `report` op

• 数据种类:metrics × image2d × image2d → metrics

• 调用: import fullseye as fs; fs.ledger.measure_with(report, a, b, ms=False)(要直接调用实现,import imgmetrics; imgmetrics.measure_with(report, a, b, ms=False);从台账取用则 opsimgmetrics.get("measure_with"))

用法

在与上一次完全相同的条件下测量另一组。

接收 compare_images 的返回值(含 contract),原样使用其中记录的 data_range / bins / ncd_levels 重新测量。

之所以需要它,是因为本 repo 实际发生过这样的事故类型 —— 只把数值抄到图注或表格上,条件就消失了。把分别测得的 2 个 PSNR 并列时, 若一方是 data_range=1.0、另一方是 255,48.13 dB 的差就会看起来像“改进”。只要把条件带在身上,根本就不会产生无法比较的组合。

同时,它也是 metrics 类型的消费方。只有 compare_images 产出 metrics 而没人消费的状态,正是本 repo 反复踩到的 “有入口却没有消费 op 的类型”(在 2026-09-02 的检查中发现)。

Parameters

report : dict

compare_images 的返回值,或 contract 本身。

a, b : array_like

要重新测量的 2 幅图。

Returns

dict

同样形式的报告。contract 与接收到的完全相同。

详细使用指南

• image_difference_metrics 族使用指南

参考(示例数据、文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

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

可运行的示例(实际调用该算子并已验证的样例)

• image_quality_metrics — py -3.11 examples/image_quality_metrics.py

类型可衔接的下一个算子(可接受 `metrics` 作为输入)

luma_limited_u8 · rank_data · tid2013_index · metrics_table

同类别(`report`)

compare_images · metrics_table · data_range_of

*Provenance: imgmetrics.py — IMGMETRICS 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

measure_with — IMGMETRICS report op

用法