клас Histogram – об’єкт Histogram

Об’єкт гістограми повертається Image.get_histogram(). Назва базового класу – histogram.

Для зображень у відтінках сірого гістограма має один канал бінів. Для зображень RGB565 гістограма має три канали, що охоплюють осі CIE-LAB L, A та B. В обох випадках кожен канал нормалізується так, щоб суми його бінів дорівнювала 1.0.

Списки бінів для кожного каналу доступні як через зв’язані методи (hist.bins()), так і через індексацію (hist[0]). Високорівневі зведення get_percentile(), get_threshold() та get_statistics() повертають відповідні attrtuples Percentile, Threshold та Statistics.

class image.histogram

Для створення цього об’єкта викличте Image.get_histogram(). Публічного конструктора немає.

bins() → list[float]

Повертає список бінів для гістограми у відтінках сірого. Кожен запис знаходиться в діапазоні від 0.0 до 1.0, а сума записів дорівнює 1.0.

Еквівалент histogram[0].

l_bins() → list[float]

Повертає список бінів для каналу L LAB гістограми RGB565. Кожен запис знаходиться в діапазоні від 0.0 до 1.0, а сума записів дорівнює 1.0.

Еквівалент histogram[0].

a_bins() → list[float]

Повертає список бінів для каналу A LAB гістограми RGB565. Кожен запис знаходиться в діапазоні від 0.0 до 1.0, а сума записів дорівнює 1.0.

Еквівалент histogram[1].

b_bins() → list[float]

Повертає список бінів для каналу B LAB гістограми RGB565. Кожен запис знаходиться в діапазоні від 0.0 до 1.0, а сума записів дорівнює 1.0.

Еквівалент histogram[2].

get_percentile(percentile: float) → image.percentile

Обчислює CDF кожного каналу гістограми та повертає значення бінів при заданому percentile (число з плаваючою точкою в діапазоні 0.0 – 1.0).

Корисно для знаходження мінімуму/максимуму розподілу кольорів без урахування викидів (get_percentile(0.05) та get_percentile(0.95) дають надійний мінімум/максимум).

Повертає attrtuple Percentile.

get_threshold() → image.threshold

Використовує метод Оцу для кожного каналу, щоб знайти порогове значення, яке найкраще розділяє розподіл кожного каналу на «фон» і «передній план». Отримані пороги добре підходять для безпосередньої передачі до Image.binary() або будь-якого іншого методу, що приймає кольорові пороги LAB L/A/B.

Повертає attrtuple Threshold.

get_statistics() → image.statistics

Обчислює середнє, медіану, моду, стандартне відхилення, мінімум, максимум, нижній та верхній квартилі для кожного каналу гістограми.

Повертає attrtuple Statistics.

get_stats() → image.statistics

Псевдонім для get_statistics().

statistics() → image.statistics

Псевдонім для get_statistics().