class Histogram – objekt Histogram

Objekt histogram je vracený funkcí Image.get_histogram(). Název podkladové třídy je histogram.

U obrazů ve stupních šedi má histogram jeden kanál košů. U obrazů RGB565 má histogram tři kanály pokrývající osy L, A a B prostoru CIE-LAB. V obou případech je každý kanál normalizován tak, aby součet jeho košů byl 1.0.

Seznamy košů jednotlivých kanálů jsou zpřístupněny jak jako vázané metody (hist.bins()), tak prostřednictvím indexové notace (hist[0]). Vysokoúrovňové redukce get_percentile(), get_threshold() a get_statistics() vracejí odpovídající attrtuple Percentile, Threshold a Statistics.

class image.histogram

Pro vytvoření tohoto objektu zavolejte Image.get_histogram(). Nemá veřejný konstruktor.

bins() → list[float]

Vrací seznam košů pro histogram ve stupních šedi. Každá položka je v rozsahu 0.0 až 1.0 a součet položek je 1.0.

Ekvivalent histogram[0].

l_bins() → list[float]

Vrací seznam košů pro kanál LAB L histogramu RGB565. Každá položka je v rozsahu 0.0 až 1.0 a součet položek je 1.0.

Ekvivalent histogram[0].

a_bins() → list[float]

Vrací seznam košů pro kanál LAB A histogramu RGB565. Každá položka je v rozsahu 0.0 až 1.0 a součet položek je 1.0.

Ekvivalent histogram[1].

b_bins() → list[float]

Vrací seznam košů pro kanál LAB B histogramu RGB565. Každá položka je v rozsahu 0.0 až 1.0 a součet položek je 1.0.

Ekvivalent histogram[2].

get_percentile(percentile: float) → image.percentile

Vypočte CDF každého kanálu histogramu a vrátí hodnotu koše v požadovaném percentilu percentile (číslo s plovoucí desetinnou čárkou v rozsahu 0.0 – 1.0).

Užitečné pro nalezení min/max barevného rozdělení při ignorování odlehlých hodnot (get_percentile(0.05) a get_percentile(0.95) poskytnou robustní min/max).

Vrací attrtuple Percentile.

get_threshold() → image.threshold

Použije Otsuovu metodu na každý kanál k nalezení prahové hodnoty, která nejlépe rozdělí rozdělení každého kanálu na „pozadí“ a „popředí“. Vrácené prahy jsou vhodné k přímému předání do Image.binary() nebo do jakékoli jiné metody, která přijímá barevné prahy LAB L/A/B.

Vrací attrtuple Threshold.

get_statistics() → image.statistics

Vypočte průměr, medián, modus, směrodatnou odchylku, min, max, dolní kvartil a horní kvartil každého kanálu histogramu.

Vrací attrtuple Statistics.

get_stats() → image.statistics

Alias pro get_statistics().

statistics() → image.statistics

Alias pro get_statistics().