class Histogram – Histogram-Objekt

Das Histogramm-Objekt wird von Image.get_histogram() zurückgegeben. Der Name der zugrunde liegenden Klasse ist histogram.

Für Graustufenbilder hat das Histogramm einen einzelnen Kanal mit Bins. Für RGB565-Bilder hat das Histogramm drei Kanäle, die die CIE-LAB-Achsen L, A und B abdecken. In beiden Fällen ist jeder Kanal so normalisiert, dass die Summe seiner Bins 1.0 ergibt.

Die Bin-Listen pro Kanal werden sowohl als gebundene Methoden (hist.bins()) als auch über die Indexschreibweise (hist[0]) bereitgestellt. Die High-Level-Reduktionen get_percentile(), get_threshold() und get_statistics() geben die entsprechenden attrtuples Percentile, Threshold und Statistics zurück.

class image.histogram

Bitte rufen Sie Image.get_histogram() auf, um dieses Objekt zu erstellen. Es hat keinen öffentlichen Konstruktor.

bins() → list[float]

Gibt die Bin-Liste für ein Graustufen-Histogramm zurück. Jeder Eintrag liegt im Bereich 0.0 bis 1.0, und die Einträge summieren sich zu 1.0.

Äquivalent zu histogram[0].

l_bins() → list[float]

Gibt die Bin-Liste für den LAB-L-Kanal eines RGB565-Histogramms zurück. Jeder Eintrag liegt im Bereich 0.0 bis 1.0, und die Einträge summieren sich zu 1.0.

Äquivalent zu histogram[0].

a_bins() → list[float]

Gibt die Bin-Liste für den LAB-A-Kanal eines RGB565-Histogramms zurück. Jeder Eintrag liegt im Bereich 0.0 bis 1.0, und die Einträge summieren sich zu 1.0.

Äquivalent zu histogram[1].

b_bins() → list[float]

Gibt die Bin-Liste für den LAB-B-Kanal eines RGB565-Histogramms zurück. Jeder Eintrag liegt im Bereich 0.0 bis 1.0, und die Einträge summieren sich zu 1.0.

Äquivalent zu histogram[2].

get_percentile(percentile: float) → image.percentile

Berechnet die CDF jedes Histogrammkanals und gibt den Bin-Wert beim angeforderten percentile (eine Gleitkommazahl in 0.0 – 1.0) zurück.

Nützlich, um das Minimum/Maximum einer Farbverteilung zu finden und dabei Ausreißer zu ignorieren (get_percentile(0.05) und get_percentile(0.95) liefern ein robustes Minimum/Maximum).

Gibt ein Percentile-attrtuple zurück.

get_threshold() → image.threshold

Verwendet die Otsu-Methode auf jedem Kanal, um den Schwellenwert zu finden, der die Verteilung jedes Kanals am besten in eine „Hintergrund“- und eine „Vordergrund“-Hälfte aufteilt. Die zurückgegebenen Schwellenwerte eignen sich gut zur direkten Weitergabe an Image.binary() oder jede andere Methode, die LAB-L/A/B-Farbschwellenwerte annimmt.

Gibt ein Threshold-attrtuple zurück.

get_statistics() → image.statistics

Berechnet den Mittelwert, den Median, den Modus, die Standardabweichung, das Minimum, das Maximum, das untere Quartil und das obere Quartil jedes Histogrammkanals.

Gibt ein Statistics-attrtuple zurück.

get_stats() → image.statistics

Alias für get_statistics().

statistics() → image.statistics

Alias für get_statistics().