class Histogram – Objeto Histograma

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

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

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

class image.histogram

Utilize Image.get_histogram() para criar este objeto. Não tem construtor público.

bins() → list[float]

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

Equivalente a histogram[0].

l_bins() → list[float]

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

Equivalente a histogram[0].

a_bins() → list[float]

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

Equivalente a histogram[1].

b_bins() → list[float]

Devolve a lista de bins para o canal B LAB de um histograma RGB565. Cada entrada está no intervalo 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 devolve o valor do bin no percentile pedido (um float em 0.0 – 1.0).

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

Devolve um 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 numa metade de «fundo» e outra de «primeiro plano». Os limiares devolvidos são adequados para alimentar diretamente Image.binary() ou qualquer outro método que aceite limiares de cor LAB L/A/B.

Devolve um attrtuple Threshold.

get_statistics() → image.statistics

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

Devolve um attrtuple Statistics.

get_stats() → image.statistics

Alias para get_statistics().

statistics() → image.statistics

Alias para get_statistics().