class Histogram – oggetto Histogram

L’oggetto histogram viene restituito da Image.get_histogram(). Il nome della classe sottostante è histogram.

Per le immagini in scala di grigi l’istogramma ha un singolo canale di bin. Per le immagini RGB565 l’istogramma ha tre canali che coprono gli assi CIE-LAB L, A e B. In entrambi i casi ogni canale è normalizzato in modo che i suoi bin sommino a 1.0.

Le liste di bin per canale sono esposte sia come metodi associati (hist.bins()) sia tramite la notazione a indice (hist[0]). Le riduzioni di alto livello get_percentile(), get_threshold() e get_statistics() restituiscono le attrtuple corrispondenti Percentile, Threshold e Statistics.

class image.histogram

Chiamare Image.get_histogram() per creare questo oggetto. Non ha un costruttore pubblico.

bins() → list[float]

Restituisce la lista di bin per un istogramma in scala di grigi. Ogni voce è nell’intervallo da 0.0 a 1.0 e le voci sommano a 1.0.

Equivalente a histogram[0].

l_bins() → list[float]

Restituisce la lista di bin per il canale LAB L di un istogramma RGB565. Ogni voce è nell’intervallo da 0.0 a 1.0 e le voci sommano a 1.0.

Equivalente a histogram[0].

a_bins() → list[float]

Restituisce la lista di bin per il canale LAB A di un istogramma RGB565. Ogni voce è nell’intervallo da 0.0 a 1.0 e le voci sommano a 1.0.

Equivalente a histogram[1].

b_bins() → list[float]

Restituisce la lista di bin per il canale LAB B di un istogramma RGB565. Ogni voce è nell’intervallo da 0.0 a 1.0 e le voci sommano a 1.0.

Equivalente a histogram[2].

get_percentile(percentile: float) → image.percentile

Calcola la CDF di ogni canale dell’istogramma e restituisce il valore del bin al percentile richiesto (un float in 0.0 – 1.0).

Utile per trovare il min/max di una distribuzione di colore ignorando gli outlier (get_percentile(0.05) e get_percentile(0.95) forniscono un min/max robusto).

Restituisce un’attrtuple Percentile.

get_threshold() → image.threshold

Usa il metodo di Otsu su ogni canale per trovare il valore di soglia che meglio divide la distribuzione di ciascun canale in una metà «sfondo» e una metà «primo piano». Le soglie restituite sono adatte a essere passate direttamente a Image.binary() o a qualsiasi altro metodo che accetta soglie di colore LAB L/A/B.

Restituisce un’attrtuple Threshold.

get_statistics() → image.statistics

Calcola media, mediana, moda, deviazione standard, minimo, massimo, quartile inferiore e quartile superiore di ogni canale dell’istogramma.

Restituisce un’attrtuple Statistics.

get_stats() → image.statistics

Alias di get_statistics().

statistics() → image.statistics

Alias di get_statistics().