joint_entropy — IMGMETRICS `information` op

• 資料種類:image2d × image2d → scalar

• 呼叫: import fullseye as fs; fs.ledger.joint_entropy(a, b, bins=64, data_range=None)(要直接呼叫實作,import imgmetrics; imgmetrics.joint_entropy(a, b, bins=64, data_range=None);從台帳取用則 opsimgmetrics.get("joint_entropy"))

用法

聯合熵 H(A, B) [bit]。

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

式: `-sum(p log2 p) を joint_histogram(a, b, bins, data_range)` の全セル

(`p > 0` のみ)について取る。

• `a, b: 同じ形、有限。dtype と data_range の扱いは joint_histogram`

と同じ(float は `[0, 1]` 以外なら明示必須)。

• `bins: 2 以上の整数。**値はビン数に依存する** ―― 上限は 2 log2(bins)`

(既定 64 で 12 bit)。他所の数値と比べるときは `bins と data_range` を揃える。

• 返り値: Python の `float、単位 bit、0` 以上。2 枚とも一様なら 0。

`H(A) + H(B) - H(A, B) が相互情報量(mutual_information`)。

• 失敗(`MetricContractError): 形が違う / 空 / 非有限 / bins < 2` /

`data_range` を推定できない。

位置合わせ(レジストレーション)の目的関数として、`mutual_information` /

`normalized_mutual_information` と併せて使う。

詳細使用指南

• 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

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

—

同類別(`information`)

image_entropy · mutual_information · normalized_mutual_information · joint_histogram

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

joint_entropy — IMGMETRICS information op

用法