Image.stats#

property Image.stats: dict[str, Any][source]#

Pixel value statistics

Returns:: statistics dictionary; for greyscale keys are min, max, mean, sdev, median, nnan, ninf; for color images returns a dictionary mapping plane name to that same dictionary
Return type:: dict

Example:

>>> from machinevisiontoolbox import Image
>>> img = Image.Read('street.png')
>>> img.stats
{'min': 0.0, 'max': 255.0, 'mean': 92.4314767552879, 'sdev': 70.33978422421328, 'median': 65.0, 'nnan': 0, 'ninf': 0}
>>> img = Image.Read('flowers1.png')
>>> img.stats
{'R': {'min': 0.0, 'max': 255.0, 'mean': 103.67999926643192, 'sdev': 74.34565672923452, 'median': 80.0, 'nnan': 0, 'ninf': 0}, 'G': {'min': 0.0, 'max': 255.0, 'mean': 112.02408670774648, 'sdev': 50.0397464829291, 'median': 105.0, 'nnan': 0, 'ninf': 0}, 'B': {'min': 0.0, 'max': 255.0, 'mean': 100.68556338028169, 'sdev': 65.61383674272099, 'median': 85.0, 'nnan': 0, 'ninf': 0}}

Note

Returns statistics as a dictionary and does not print.
NaN values are ignored for scalar statistics and reported via nnan and ninf counts.

Seealso:: printstats hist min max mean std median