class Histogram – objekt Histogram

Objekt histograma vraća Image.get_histogram(). Naziv temeljne klase je histogram.

Za slike u sivim tonovima histogram ima jedan kanal pretinaca. Za RGB565 slike histogram ima tri kanala koja pokrivaju CIE-LAB osi L, A i B. U oba slučaja svaki je kanal normaliziran tako da zbroj njegovih pretinaca iznosi 1.0.

Liste pretinaca po kanalu izložene su i kao vezane metode (hist.bins()) i kroz notaciju indeksiranja (hist[0]). Visokorazinske redukcije get_percentile(), get_threshold() i get_statistics() vraćaju odgovarajuće attrtuple Percentile, Threshold i Statistics.

class image.histogram

Za stvaranje ovog objekta pozovite Image.get_histogram(). Nema javnog konstruktora.

bins() → list[float]

Vraća listu pretinaca za histogram u sivim tonovima. Svaka je vrijednost u rasponu od 0.0 do 1.0, a zbroj vrijednosti iznosi 1.0.

Ekvivalentno histogram[0].

l_bins() → list[float]

Vraća listu pretinaca za LAB kanal L RGB565 histograma. Svaka je vrijednost u rasponu od 0.0 do 1.0, a zbroj vrijednosti iznosi 1.0.

Ekvivalentno histogram[0].

a_bins() → list[float]

Vraća listu pretinaca za LAB kanal A RGB565 histograma. Svaka je vrijednost u rasponu od 0.0 do 1.0, a zbroj vrijednosti iznosi 1.0.

Ekvivalentno histogram[1].

b_bins() → list[float]

Vraća listu pretinaca za LAB kanal B RGB565 histograma. Svaka je vrijednost u rasponu od 0.0 do 1.0, a zbroj vrijednosti iznosi 1.0.

Ekvivalentno histogram[2].

get_percentile(percentile: float) → image.percentile

Izračunava CDF svakog kanala histograma i vraća vrijednost pretinca na traženom percentile (decimalni broj u 0.0 – 1.0).

Korisno za pronalaženje min/max raspodjele boja uz zanemarivanje izdvojenih vrijednosti (get_percentile(0.05) i get_percentile(0.95) daju robustan min/max).

Vraća attrtuple Percentile.

get_threshold() → image.threshold

Koristi Otsuovu metodu na svakom kanalu za pronalaženje vrijednosti praga koja najbolje dijeli raspodjelu svakog kanala na „pozadinsku” i „prednju” polovicu. Vraćeni pragovi prikladni su za izravno prosljeđivanje metodi Image.binary() ili bilo kojoj drugoj metodi koja prima LAB L/A/B pragove boje.

Vraća attrtuple Threshold.

get_statistics() → image.statistics

Izračunava srednju vrijednost, medijan, mod, standardnu devijaciju, min, max, donji kvartil i gornji kvartil svakog kanala histograma.

Vraća attrtuple Statistics.

get_stats() → image.statistics

Alias za get_statistics().

statistics() → image.statistics

Alias za get_statistics().