classe Histogram – objeto Histogram

O objeto histograma é retornado por Image.get_histogram(). O nome da classe subjacente é histogram.

Para imagens em escala de cinza, o histograma possui um único canal de bins. Para imagens RGB565, o histograma possui três canais que cobrem os eixos L, A e B do CIE-LAB. Em ambos os casos, cada canal é normalizado de modo que seus bins somem 1.0.

As listas de bins por canal são expostas tanto como métodos vinculados (hist.bins()) quanto por meio da notação de subscrito (hist[0]). As reduções de alto nível get_percentile(), get_threshold() e get_statistics() retornam as attrtuples Percentile, Threshold e Statistics correspondentes.

class image.histogram

Chame Image.get_histogram() para criar este objeto. Ele não possui construtor público.

bins() → list[float]

Retorna a lista de bins de um histograma em escala de cinza. Cada entrada está no intervalo de 0.0 a 1.0 e as entradas somam 1.0.

Equivalente a histogram[0].

l_bins() → list[float]

Retorna a lista de bins do canal L do LAB de um histograma RGB565. Cada entrada está no intervalo de 0.0 a 1.0 e as entradas somam 1.0.

Equivalente a histogram[0].

a_bins() → list[float]

Retorna a lista de bins do canal A do LAB de um histograma RGB565. Cada entrada está no intervalo de 0.0 a 1.0 e as entradas somam 1.0.

Equivalente a histogram[1].

b_bins() → list[float]

Retorna a lista de bins do canal B do LAB de um histograma RGB565. Cada entrada está no intervalo de 0.0 a 1.0 e as entradas somam 1.0.

Equivalente a histogram[2].

get_percentile(percentile: float) → image.percentile

Calcula a CDF de cada canal do histograma e retorna o valor do bin no percentile solicitado (um float em 0.0 – 1.0).

Útil para encontrar o mínimo/máximo de uma distribuição de cor ignorando outliers (get_percentile(0.05) e get_percentile(0.95) fornecem um mínimo/máximo robusto).

Retorna uma attrtuple Percentile.

get_threshold() → image.threshold

Usa o Método de Otsu em cada canal para encontrar o valor de limiar que melhor divide a distribuição de cada canal em uma metade de “fundo” e uma de “primeiro plano”. Os limiares retornados são bem adequados para alimentar diretamente Image.binary() ou qualquer outro método que receba limiares de cor LAB L/A/B.

Retorna uma attrtuple Threshold.

get_statistics() → image.statistics

Calcula a média, a mediana, a moda, o desvio padrão, o mínimo, o máximo, o quartil inferior e o quartil superior de cada canal do histograma.

Retorna uma attrtuple Statistics.

get_stats() → image.statistics

Alias para get_statistics().

statistics() → image.statistics

Alias para get_statistics().