class Histogram – obiekt Histogram

Obiekt histogram jest zwracany przez Image.get_histogram(). Nazwa klasy bazowej to histogram.

Dla obrazów w skali szarości histogram ma jeden kanał przedziałów. Dla obrazów RGB565 histogram ma trzy kanały obejmujące osie L, A i B przestrzeni CIE-LAB. W obu przypadkach każdy kanał jest znormalizowany tak, że jego przedziały sumują się do 1.0.

Listy przedziałów poszczególnych kanałów są udostępniane zarówno jako metody związane (hist.bins()), jak i poprzez notację indeksową (hist[0]). Wysokopoziomowe redukcje get_percentile(), get_threshold() i get_statistics() zwracają odpowiadające im krotki atrybutów Percentile, Threshold i Statistics.

class image.histogram

Aby utworzyć ten obiekt, wywołaj Image.get_histogram(). Nie ma publicznego konstruktora.

bins() → list[float]

Zwraca listę przedziałów dla histogramu w skali szarości. Każdy wpis mieści się w zakresie od 0.0 do 1.0, a wpisy sumują się do 1.0.

Równoważne histogram[0].

l_bins() → list[float]

Zwraca listę przedziałów dla kanału L przestrzeni LAB histogramu RGB565. Każdy wpis mieści się w zakresie od 0.0 do 1.0, a wpisy sumują się do 1.0.

Równoważne histogram[0].

a_bins() → list[float]

Zwraca listę przedziałów dla kanału A przestrzeni LAB histogramu RGB565. Każdy wpis mieści się w zakresie od 0.0 do 1.0, a wpisy sumują się do 1.0.

Równoważne histogram[1].

b_bins() → list[float]

Zwraca listę przedziałów dla kanału B przestrzeni LAB histogramu RGB565. Każdy wpis mieści się w zakresie od 0.0 do 1.0, a wpisy sumują się do 1.0.

Równoważne histogram[2].

get_percentile(percentile: float) → image.percentile

Oblicza CDF każdego kanału histogramu i zwraca wartość przedziału na żądanym percentile (liczba zmiennoprzecinkowa w zakresie 0.0 – 1.0).

Przydatne do znajdowania min/max rozkładu koloru przy ignorowaniu wartości odstających (get_percentile(0.05) i get_percentile(0.95) dają odporne min/max).

Zwraca krotkę atrybutów Percentile.

get_threshold() → image.threshold

Stosuje metodę Otsu na każdym kanale, aby znaleźć wartość progu, która najlepiej dzieli rozkład każdego kanału na połowę „tła” i „pierwszego planu”. Zwrócone progi dobrze nadają się do bezpośredniego przekazania do Image.binary() lub dowolnej innej metody przyjmującej progi koloru L/A/B przestrzeni LAB.

Zwraca krotkę atrybutów Threshold.

get_statistics() → image.statistics

Oblicza średnią, medianę, modę, odchylenie standardowe, min, max, dolny kwartyl i górny kwartyl każdego kanału histogramu.

Zwraca krotkę atrybutów Statistics.

get_stats() → image.statistics

Alias dla get_statistics().

statistics() → image.statistics

Alias dla get_statistics().