measure_with — IMGMETRICS `report` op

• Data kinds: metrics × image2d × image2d → metrics

• Call: import imgmetrics; imgmetrics.measure_with(report, a, b, ms=False) (or opsimgmetrics.get("measure_with"))

Usage

Measure another pair under exactly the same conditions as the previous measurement.

> The detailed description below is the original text — the summary and the headings are translated.

:func: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

:func:compare_images の返り値、または `contract` そのもの。

a, b : array_like

測り直す 2 枚。

Returns

-------

dict

同じ形の報告。`contract` は受け取ったものと同一。

Detailed usage guide

• image_difference_metrics family guide

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

• image_quality_metrics — py -3.11 examples/image_quality_metrics.py

Ops the type connects to (they accept `metrics` as input)

metrics_table

Same category (`report`)

compare_images · metrics_table · data_range_of

*Provenance: imgmetrics.py — IMGMETRICS operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

measure_with — IMGMETRICS report op