class Histogram – obiect Histogram

Obiectul histogramă este returnat de Image.get_histogram(). Numele clasei subiacente este histogram.

Pentru imaginile în tonuri de gri, histograma are un singur canal de intervale (bins). Pentru imaginile RGB565, histograma are trei canale care acoperă axele CIE-LAB L, A și B. În ambele cazuri, fiecare canal este normalizat astfel încât intervalele sale să însumeze 1.0.

Listele de intervale per canal sunt expuse atât ca metode legate (hist.bins()), cât și prin notația cu indice (hist[0]). Reducerile de nivel înalt get_percentile(), get_threshold() și get_statistics() returnează attrtuplurile corespunzătoare Percentile, Threshold și Statistics.

class image.histogram

Apelați Image.get_histogram() pentru a crea acest obiect. Nu are un constructor public.

bins() → list[float]

Returnează lista de intervale pentru o histogramă în tonuri de gri. Fiecare intrare este în intervalul de la 0.0 la 1.0, iar intrările însumează 1.0.

Echivalent cu histogram[0].

l_bins() → list[float]

Returnează lista de intervale pentru canalul LAB L al unei histograme RGB565. Fiecare intrare este în intervalul de la 0.0 la 1.0, iar intrările însumează 1.0.

Echivalent cu histogram[0].

a_bins() → list[float]

Returnează lista de intervale pentru canalul LAB A al unei histograme RGB565. Fiecare intrare este în intervalul de la 0.0 la 1.0, iar intrările însumează 1.0.

Echivalent cu histogram[1].

b_bins() → list[float]

Returnează lista de intervale pentru canalul LAB B al unei histograme RGB565. Fiecare intrare este în intervalul de la 0.0 la 1.0, iar intrările însumează 1.0.

Echivalent cu histogram[2].

get_percentile(percentile: float) → image.percentile

Calculează CDF-ul fiecărui canal al histogramei și returnează valoarea intervalului la percentile solicitat (un float în 0.0 – 1.0).

Util pentru găsirea valorilor minime/maxime ale unei distribuții de culoare ignorând valorile aberante (get_percentile(0.05) și get_percentile(0.95) oferă un min/max robust).

Returnează un attrtuplu Percentile.

get_threshold() → image.threshold

Folosește metoda Otsu pe fiecare canal pentru a găsi valoarea de prag care împarte cel mai bine distribuția fiecărui canal într-o jumătate de „fundal” și una de „prim-plan”. Pragurile returnate sunt potrivite pentru a fi transmise direct lui Image.binary() sau oricărei alte metode care acceptă praguri de culoare LAB L/A/B.

Returnează un attrtuplu Threshold.

get_statistics() → image.statistics

Calculează media, mediana, modul, abaterea standard, valoarea minimă, valoarea maximă, cuartila inferioară și cuartila superioară ale fiecărui canal al histogramei.

Returnează un attrtuplu Statistics.

get_stats() → image.statistics

Alias pentru get_statistics().

statistics() → image.statistics

Alias pentru get_statistics().