class Histogram – объект Histogram

Объект histogram возвращается методом Image.get_histogram(). Имя базового класса – histogram.

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

Списки бинов по каждому каналу доступны как через связанные методы (hist.bins()), так и через индексную нотацию (hist[0]). Высокоуровневые свёртки get_percentile(), get_threshold() и get_statistics() возвращают соответствующие attrtuple 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() или любой другой метод, принимающий цветовые пороги L/A/B пространства LAB.

Возвращает attrtuple Threshold.

get_statistics() → image.statistics

Вычисляет среднее, медиану, моду, стандартное отклонение, минимум, максимум, нижний квартиль и верхний квартиль каждого канала гистограммы.

Возвращает attrtuple Statistics.

get_stats() → image.statistics

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

statistics() → image.statistics

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