class Histogram – objeto Histogram

El objeto histogram es devuelto por Image.get_histogram(). El nombre de la clase subyacente es histogram.

Para imágenes en escala de grises el histograma tiene un único canal de bins. Para imágenes RGB565 el histograma tiene tres canales que cubren los ejes L, A y B de CIE-LAB. En ambos casos cada canal está normalizado de modo que sus bins suman 1.0.

Las listas de bins por canal se exponen tanto como métodos vinculados (hist.bins()) como mediante notación de subíndice (hist[0]). Las reducciones de alto nivel get_percentile(), get_threshold() y get_statistics() devuelven los attrtuples correspondientes Percentile, Threshold y Statistics.

class image.histogram

Llama a Image.get_histogram() para crear este objeto. No tiene constructor público.

bins() → list[float]

Devuelve la lista de bins para un histograma en escala de grises. Cada entrada está en el rango de 0.0 a 1.0 y las entradas suman 1.0.

Equivalente a histogram[0].

l_bins() → list[float]

Devuelve la lista de bins para el canal L de LAB de un histograma RGB565. Cada entrada está en el rango de 0.0 a 1.0 y las entradas suman 1.0.

Equivalente a histogram[0].

a_bins() → list[float]

Devuelve la lista de bins para el canal A de LAB de un histograma RGB565. Cada entrada está en el rango de 0.0 a 1.0 y las entradas suman 1.0.

Equivalente a histogram[1].

b_bins() → list[float]

Devuelve la lista de bins para el canal B de LAB de un histograma RGB565. Cada entrada está en el rango de 0.0 a 1.0 y las entradas suman 1.0.

Equivalente a histogram[2].

get_percentile(percentile: float) → image.percentile

Calcula la CDF de cada canal del histograma y devuelve el valor del bin en el percentile solicitado (un flotante en 0.0 – 1.0).

Útil para encontrar el mínimo/máximo de una distribución de color ignorando los valores atípicos (get_percentile(0.05) y get_percentile(0.95) proporcionan un mínimo/máximo robusto).

Devuelve un attrtuple Percentile.

get_threshold() → image.threshold

Usa el método de Otsu en cada canal para encontrar el valor de umbral que mejor divide la distribución de cada canal en una mitad de «fondo» y otra de «primer plano». Los umbrales devueltos son idóneos para pasarlos directamente a Image.binary() o a cualquier otro método que tome umbrales de color L/A/B de LAB.

Devuelve un attrtuple Threshold.

get_statistics() → image.statistics

Calcula la media, la mediana, la moda, la desviación estándar, el mínimo, el máximo, el cuartil inferior y el cuartil superior de cada canal del histograma.

Devuelve un attrtuple Statistics.

get_stats() → image.statistics

Alias de get_statistics().

statistics() → image.statistics

Alias de get_statistics().