class Histogram – objet Histogram

L’objet histogram est renvoyé par Image.get_histogram(). Le nom de la classe sous-jacente est histogram.

Pour les images en niveaux de gris, l’histogramme comporte un seul canal d’intervalles. Pour les images RGB565, l’histogramme comporte trois canaux couvrant les axes CIE-LAB L, A et B. Dans les deux cas, chaque canal est normalisé de sorte que ses intervalles totalisent 1.0.

Les listes d’intervalles par canal sont exposées à la fois sous forme de méthodes liées (hist.bins()) et via la notation par indice (hist[0]). Les réductions de haut niveau get_percentile(), get_threshold() et get_statistics() renvoient respectivement les attrtuples Percentile, Threshold et Statistics.

class image.histogram

Veuillez appeler Image.get_histogram() pour créer cet objet. Il n’a pas de constructeur public.

bins() → list[float]

Renvoie la liste des intervalles pour un histogramme en niveaux de gris. Chaque entrée est dans la plage 0.0 à 1.0 et les entrées totalisent 1.0.

Équivalent à histogram[0].

l_bins() → list[float]

Renvoie la liste des intervalles pour le canal LAB L d’un histogramme RGB565. Chaque entrée est dans la plage 0.0 à 1.0 et les entrées totalisent 1.0.

Équivalent à histogram[0].

a_bins() → list[float]

Renvoie la liste des intervalles pour le canal LAB A d’un histogramme RGB565. Chaque entrée est dans la plage 0.0 à 1.0 et les entrées totalisent 1.0.

Équivalent à histogram[1].

b_bins() → list[float]

Renvoie la liste des intervalles pour le canal LAB B d’un histogramme RGB565. Chaque entrée est dans la plage 0.0 à 1.0 et les entrées totalisent 1.0.

Équivalent à histogram[2].

get_percentile(percentile: float) → image.percentile

Calcule la CDF de chaque canal de l’histogramme et renvoie la valeur d’intervalle au percentile demandé (un flottant dans 0.0 – 1.0).

Utile pour trouver le min/max d’une distribution de couleurs en ignorant les valeurs aberrantes (get_percentile(0.05) et get_percentile(0.95) donnent un min/max robuste).

Renvoie un attrtuple Percentile.

get_threshold() → image.threshold

Utilise la méthode d’Otsu sur chaque canal pour trouver la valeur de seuil qui sépare le mieux la distribution de chaque canal en une moitié « arrière-plan » et une moitié « premier plan ». Les seuils renvoyés sont bien adaptés pour être passés directement à Image.binary() ou à toute autre méthode qui prend des seuils de couleur LAB L/A/B.

Renvoie un attrtuple Threshold.

get_statistics() → image.statistics

Calcule la moyenne, la médiane, le mode, l’écart-type, le min, le max, le quartile inférieur et le quartile supérieur de chaque canal de l’histogramme.

Renvoie un attrtuple Statistics.

get_stats() → image.statistics

Alias de get_statistics().

statistics() → image.statistics

Alias de get_statistics().