class Histogram – Histogram-object

Het histogram-object wordt teruggegeven door Image.get_histogram(). De onderliggende klassenaam is histogram.

Voor grijswaardenafbeeldingen heeft het histogram één kanaal met bins. Voor RGB565-afbeeldingen heeft het histogram drie kanalen die de CIE-LAB-assen L, A en B bestrijken. In beide gevallen wordt elk kanaal genormaliseerd zodat de bins ervan optellen tot 1.0.

Bin-lijsten per kanaal worden zowel als gebonden methoden (hist.bins()) als via subscriptnotatie (hist[0]) blootgesteld. De hoog-niveau reducties get_percentile(), get_threshold() en get_statistics() geven respectievelijk de bijbehorende attrtuples Percentile, Threshold en Statistics terug.

class image.histogram

Roep Image.get_histogram() aan om dit object te maken. Het heeft geen openbare constructor.

bins() → list[float]

Geef de bin-lijst van een grijswaardenhistogram terug. Elke waarde ligt in het bereik 0.0 tot 1.0 en de waarden tellen op tot 1.0.

Gelijkwaardig aan histogram[0].

l_bins() → list[float]

Geef de bin-lijst van het LAB-L-kanaal van een RGB565-histogram terug. Elke waarde ligt in het bereik 0.0 tot 1.0 en de waarden tellen op tot 1.0.

Gelijkwaardig aan histogram[0].

a_bins() → list[float]

Geef de bin-lijst van het LAB-A-kanaal van een RGB565-histogram terug. Elke waarde ligt in het bereik 0.0 tot 1.0 en de waarden tellen op tot 1.0.

Gelijkwaardig aan histogram[1].

b_bins() → list[float]

Geef de bin-lijst van het LAB-B-kanaal van een RGB565-histogram terug. Elke waarde ligt in het bereik 0.0 tot 1.0 en de waarden tellen op tot 1.0.

Gelijkwaardig aan histogram[2].

get_percentile(percentile: float) → image.percentile

Bereken de CDF van elk histogramkanaal en geef de bin-waarde terug bij het opgevraagde percentile (een float in 0.0 – 1.0).

Handig om de min/max van een kleurverdeling te vinden terwijl uitschieters worden genegeerd (get_percentile(0.05) en get_percentile(0.95) geven een robuuste min/max).

Geeft een Percentile-attrtuple terug.

get_threshold() → image.threshold

Gebruik de methode van Otsu op elk kanaal om de drempelwaarde te vinden die de verdeling van elk kanaal het beste splitst in een “achtergrond”- en een “voorgrond”-helft. De teruggegeven drempelwaarden zijn uitstekend geschikt om rechtstreeks door te geven aan Image.binary() of aan elke andere methode die LAB-L/A/B-kleurdrempelwaarden accepteert.

Geeft een Threshold-attrtuple terug.

get_statistics() → image.statistics

Bereken het gemiddelde, de mediaan, de modus, de standaardafwijking, de min, de max, het onderste kwartiel en het bovenste kwartiel van elk histogramkanaal.

Geeft een Statistics-attrtuple terug.

get_stats() → image.statistics

Alias voor get_statistics().

statistics() → image.statistics

Alias voor get_statistics().