Histogram osztály – Histogram objektum

A histogram objektumot az Image.get_histogram() adja vissza. Az alapul szolgáló osztály neve histogram.

Szürkeárnyalatos képek esetén a hisztogramnak egyetlen csatorna rekeszei vannak. RGB565 képek esetén a hisztogramnak három csatornája van, amelyek a CIE-LAB L, A és B tengelyeket fedik le. Mindkét esetben minden csatorna úgy van normalizálva, hogy a rekeszei összege 1.0 legyen.

A csatornánkénti rekeszlisták kötött metódusokként (hist.bins()) és indexelő jelöléssel (hist[0]) is elérhetők. A magas szintű redukciók – a get_percentile(), a get_threshold() és a get_statistics() – a megfelelő Percentile, Threshold és Statistics attrtuple-öket adják vissza.

class image.histogram

Az objektum létrehozásához hívd meg az Image.get_histogram() metódust. Nincs nyilvános konstruktora.

bins() → list[float]

Visszaadja egy szürkeárnyalatos hisztogram rekeszlistáját. Minden bejegyzés a 0.0 és 1.0 közötti tartományban van, és a bejegyzések összege 1.0.

Egyenértékű a histogram[0] kifejezéssel.

l_bins() → list[float]

Visszaadja egy RGB565 hisztogram LAB L csatornájának rekeszlistáját. Minden bejegyzés a 0.0 és 1.0 közötti tartományban van, és a bejegyzések összege 1.0.

Egyenértékű a histogram[0] kifejezéssel.

a_bins() → list[float]

Visszaadja egy RGB565 hisztogram LAB A csatornájának rekeszlistáját. Minden bejegyzés a 0.0 és 1.0 közötti tartományban van, és a bejegyzések összege 1.0.

Egyenértékű a histogram[1] kifejezéssel.

b_bins() → list[float]

Visszaadja egy RGB565 hisztogram LAB B csatornájának rekeszlistáját. Minden bejegyzés a 0.0 és 1.0 közötti tartományban van, és a bejegyzések összege 1.0.

Egyenértékű a histogram[2] kifejezéssel.

get_percentile(percentile: float) → image.percentile

Kiszámítja minden hisztogramcsatorna eloszlásfüggvényét (CDF), és visszaadja a kért percentile (egy lebegőpontos szám a 0.0 – 1.0 tartományban) helyén lévő rekeszértéket.

Hasznos egy színeloszlás min/max értékének megkereséséhez a kiugró értékek figyelmen kívül hagyásával (a get_percentile(0.05) és a get_percentile(0.95) robusztus min/max értéket ad).

Egy Percentile attrtuple-t ad vissza.

get_threshold() → image.threshold

Otsu módszerét alkalmazza minden csatornán, hogy megtalálja azt a küszöbértéket, amely az egyes csatornák eloszlását a legjobban osztja „háttér” és „előtér” felére. A visszaadott küszöbértékek jól használhatók közvetlenül az Image.binary() metódusnak, vagy bármely más, LAB L/A/B színküszöbértékeket fogadó metódusnak átadva.

Egy Threshold attrtuple-t ad vissza.

get_statistics() → image.statistics

Kiszámítja minden hisztogramcsatorna átlagát, mediánját, móduszát, szórását, minimumát, maximumát, alsó kvartilisét és felső kvartilisét.

Egy Statistics attrtuple-t ad vissza.

get_stats() → image.statistics

A get_statistics() aliasa.

statistics() → image.statistics

A get_statistics() aliasa.