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個のビンにグループ化されます。したがって、IおよびFモードの画像には、最大で255のmean、median、およびrmsがあり、extremaの最大値が255を超えることはありません。

• mask – オプションのマスク。

property count: list[int]

画像内の各バンドのピクセルの総数。

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

画像内の各バンドの最小値/最大値。

注記

これはhistogram()メソッドに依存しており、使用された低ビンと高ビンを返すだけです。これは、チャネルあたり8ビットの画像では正しいですが、IやFなどの他のモードでは失敗します。代わりに、画像のバンドごとの極値を返すには、getextrema()を使用してください。非8ビットモードの場合、ヒストグラムメソッドは使用するビンを決定するためにgetextrema()を使用するため、これはより正確で効率的です。

property mean: list[float]

画像の各バンドの平均（算術平均）ピクセルレベル。

property median: list[int]

画像の各バンドの中央値ピクセルレベル。

property rms: list[float]

画像の各バンドのRMS（二乗平均平方根）。

property stddev: list[float]

画像の各バンドの標準偏差。

property sum: list[float]

画像の各バンドのすべてのピクセルの合計。

property sum2: list[float]

画像の各バンドのすべてのピクセルの二乗和。

property var: list[float]

画像の各バンドの分散。