ImageStat 模組

ImageStat 模組計算影像的全域統計資料，或影像的區域統計資料。

class PIL.ImageStat.Stat(image_or_list: Image | list[int], mask: Image | None = None)

__init__(image_or_list: Image | list[int], mask: Image | None = None) → None

計算給定影像的統計資料。如果包含遮罩，則只會在統計資料中包含該遮罩涵蓋的區域。您也可以傳入先前計算的直方圖。

參數:

• image –

  PIL 影像或預先計算的直方圖。

  注意

  對於 PIL 影像，計算依賴於 histogram() 方法。即使影像每個通道超過 8 位元，像素計數也會分組到 256 個 bin 中。因此，I 和 F 模式影像的最大 mean、median 和 rms 為 255，且 extrema 最大值不能超過 255。

• mask – 可選的遮罩。

property count: list[int]

影像中每個帶區的像素總數。

property extrema: list[tuple[int, int]]

影像中每個帶區的最小值/最大值。

注意

這依賴於 histogram() 方法，並且只會傳回所使用的低 bin 和高 bin。這對於每個通道具有 8 位元的影像而言是正確的，但對於其他模式 (例如 I 或 F) 則會失敗。請改用 getextrema() 來傳回影像的每個帶區的極值。這更正確且有效率，因為對於非 8 位元模式，直方圖方法會使用 getextrema() 來判斷所使用的 bin。

property mean: list[float]

影像中每個帶區的平均 (算術平均值) 像素級別。

property median: list[int]

影像中每個帶區的中位數像素級別。

屬性 rms: 列表[浮點數]

影像中每個頻帶的均方根 (RMS)。

屬性 stddev: 列表[浮點數]

影像中每個頻帶的標準差。

屬性 sum: 列表[浮點數]

影像中每個頻帶所有像素的總和。

屬性 sum2: 列表[浮點數]

影像中每個頻帶所有像素的平方總和。

屬性 var: 列表[浮點數]

影像中每個頻帶的變異數。