class Histogram – Histogram-objekt

Histogramobjektet returneras av Image.get_histogram(). Den underliggande klassens namn är histogram.

För gråskalebilder har histogrammet en enda kanal med fack. För RGB565-bilder har histogrammet tre kanaler som täcker CIE-LAB-axlarna L, A och B. I båda fallen normaliseras varje kanal så att dess fack summerar till 1.0.

Facklistor per kanal exponeras både som bundna metoder (hist.bins()) och via indexnotation (hist[0]). De högnivåreduktioner get_percentile(), get_threshold() och get_statistics() returnerar motsvarande attrtupler Percentile, Threshold och Statistics.

class image.histogram

Anropa Image.get_histogram() för att skapa detta objekt. Det har ingen publik konstruktor.

bins() → list[float]

Returnerar facklistan för ett gråskalehistogram. Varje post ligger i intervallet 0.0 till 1.0 och posterna summerar till 1.0.

Ekvivalent med histogram[0].

l_bins() → list[float]

Returnerar facklistan för LAB-kanalen L i ett RGB565-histogram. Varje post ligger i intervallet 0.0 till 1.0 och posterna summerar till 1.0.

Ekvivalent med histogram[0].

a_bins() → list[float]

Returnerar facklistan för LAB-kanalen A i ett RGB565-histogram. Varje post ligger i intervallet 0.0 till 1.0 och posterna summerar till 1.0.

Ekvivalent med histogram[1].

b_bins() → list[float]

Returnerar facklistan för LAB-kanalen B i ett RGB565-histogram. Varje post ligger i intervallet 0.0 till 1.0 och posterna summerar till 1.0.

Ekvivalent med histogram[2].

get_percentile(percentile: float) → image.percentile

Beräknar CDF för varje histogramkanal och returnerar fackvärdet vid den begärda percentile (ett flyttal i 0.0 – 1.0).

Användbar för att hitta min/max för en färgfördelning samtidigt som extremvärden ignoreras (get_percentile(0.05) och get_percentile(0.95) ger ett robust min/max).

Returnerar en attrtupel Percentile.

get_threshold() → image.threshold

Använder Otsus metod på varje kanal för att hitta det tröskelvärde som bäst delar varje kanals fördelning i en ”bakgrunds”- och ”förgrunds”-halva. De returnerade tröskelvärdena lämpar sig väl för att matas direkt in i Image.binary() eller någon annan metod som tar LAB L/A/B-färgtröskelvärden.

Returnerar en attrtupel Threshold.

get_statistics() → image.statistics

Beräknar medelvärde, median, typvärde, standardavvikelse, min, max, undre kvartil och övre kvartil för varje histogramkanal.

Returnerar en attrtupel Statistics.

get_stats() → image.statistics

Alias för get_statistics().

statistics() → image.statistics

Alias för get_statistics().