class Histogram – Histogram-objekti

Histogrammiobjektin palauttaa Image.get_histogram(). Taustalla olevan luokan nimi on histogram.

Harmaasävykuvilla histogrammissa on yksittäinen lokerokanava. RGB565-kuvilla histogrammissa on kolme kanavaa, jotka kattavat CIE-LAB-akselit L, A ja B. Molemmissa tapauksissa kukin kanava normalisoidaan niin, että sen lokeroiden summa on 1.0.

Kanavakohtaiset lokerolistat ovat saatavilla sekä sidottuina metodeina (hist.bins()) että alaviite-merkinnällä (hist[0]). Korkean tason redusoinnit get_percentile(), get_threshold() ja get_statistics() palauttavat vastaavat Percentile-, Threshold- ja Statistics -attrtuplet.

class image.histogram

Luo tämä objekti kutsumalla Image.get_histogram(). Sillä ei ole julkista konstruktoria.

bins() → list[float]

Palauta harmaasävyhistogrammin lokerolista. Jokainen alkio on välillä 0.0 – 1.0 ja alkioiden summa on 1.0.

Vastaa histogram[0].

l_bins() → list[float]

Palauta RGB565-histogrammin LAB-L-kanavan lokerolista. Jokainen alkio on välillä 0.0 – 1.0 ja alkioiden summa on 1.0.

Vastaa histogram[0].

a_bins() → list[float]

Palauta RGB565-histogrammin LAB-A-kanavan lokerolista. Jokainen alkio on välillä 0.0 – 1.0 ja alkioiden summa on 1.0.

Vastaa histogram[1].

b_bins() → list[float]

Palauta RGB565-histogrammin LAB-B-kanavan lokerolista. Jokainen alkio on välillä 0.0 – 1.0 ja alkioiden summa on 1.0.

Vastaa histogram[2].

get_percentile(percentile: float) → image.percentile

Laske jokaisen histogrammikanavan kertymäfunktio (CDF) ja palauta lokeroarvo pyydetyssä percentile-kohdassa (liukuluku välillä 0.0 – 1.0).

Hyödyllinen väridistribuution minimin/maksimin etsimiseen poikkeamat ohittaen (get_percentile(0.05) ja get_percentile(0.95) antavat robustin minimin/maksimin).

Palauttaa Percentile -attrtuplen.

get_threshold() → image.threshold

Käytä Otsun menetelmää jokaisella kanavalla löytääksesi kynnysarvon, joka parhaiten jakaa kunkin kanavan distribuution ”tausta”- ja ”etuala”-puoliskoihin. Palautetut kynnysarvot soveltuvat hyvin syötettäväksi suoraan Image.binary()-kutsulle tai mihin tahansa muuhun metodiin, joka ottaa LAB-L/A/B-värikynnysarvot.

Palauttaa Threshold -attrtuplen.

get_statistics() → image.statistics

Laske jokaisen histogrammikanavan keskiarvo, mediaani, moodi, keskihajonta, minimi, maksimi, alaneljännes ja yläneljännes.

Palauttaa Statistics -attrtuplen.

get_stats() → image.statistics

Alias metodille get_statistics().

statistics() → image.statistics

Alias metodille get_statistics().