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() 方法。像素计数被分组到 256 个箱中，即使图像的每个通道超过 8 位。因此 I 和 F 模式图像的最大 mean、median 和 rms 为 255，并且不能有超过 255 的 extrema 最大值。

• 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]

图像每个波段的方差。