Histogramm für jeden Bildkanal berechnen

Geben Sie mindestens einen benannten Kanal an, wählen Sie die Anzahl der Klassen und erhalten Sie für jeden Kanal eine geordnete Zählliste. Das eignet sich für bereits dekodierte Bilder, wenn Sie reproduzierbare Statistiken benötigen, ohne die Originaldatei hochzuladen oder erneut zu kodieren. Jeder Wert wird im 8-Bit-Bereich geprüft, jedes Pixel genau einer Klasse zugeordnet und eine leere Pixelliste als Fehler abgewiesen.

Bereiten Sie benannte Kanalwerte vor

Übergeben Sie die dekodierten Pixel im Array channels. Jeder Eintrag benötigt einen eindeutigen Kanalnamen und ein Array values mit ganzzahligen Intensitäten von 0 bis 255. Bezeichnungen wie red, green, blue, alpha und gray sind üblich, der Rechner schreibt jedoch kein Farbmodell vor; jede Komponente mit demselben 8-Bit-Wertebereich ist zulässig. Die Reihenfolge der Werte beeinflusst das Histogramm nicht, da nur ihre Häufigkeit zählt. Jeder Kanal muss mindestens einen Pixelwert enthalten. Die Anfrage wird abgelehnt, wenn die äußere Liste oder ein values-Array leer ist, ein Name fehlt oder doppelt vorkommt oder ein Wert gebrochen beziehungsweise außerhalb des Bereichs liegt. Diese Prüfungen verhindern, dass unvollständige Quelldaten wie eine gültige Verteilung wirken. Zulässig sind bis zu sechzehn Kanäle und eine Million Werte je Kanal.

Verstehen Sie die Klassengrenzen

Wählen Sie eine ganzzahlige Klassenanzahl von 1 bis 256 oder lassen Sie die Angabe weg, um 16 Klassen zu verwenden. Der vollständige 8-Bit-Intensitätsbereich wird von 0 bis 255 in gleich breite Intervalle geteilt. Bei 16 Klassen umfasst die erste die Werte 0 bis 15, die zweite 16 bis 31 und die letzte 240 bis 255. Allgemein ergibt sich der Index als abgerundeter Wert aus Pixelwert mal Klassenanzahl geteilt durch 256. Der obere Endpunkt wird ausdrücklich in der letzten Klasse gehalten, sodass 255 nie außerhalb des Arrays liegt. Diese Festlegung bleibt auch dann deterministisch, wenn die gewählte Anzahl 256 nicht ohne Rest teilt. Jedes Pixel erhöht genau einen Zähler; deshalb entspricht die Summe aller Zähler eines Kanals stets dessen pixel_count.

Lesen und prüfen Sie das Ergebnis

Die Antwort enthält bins, die festen Grenzen value_min und value_max sowie ein Histogrammobjekt für jeden Eingabekanal. Jedes Objekt behält den Kanalnamen bei, nennt pixel_count und liefert counts in aufsteigender Intensitätsreihenfolge. Die erste Position steht stets für das dunkelste, die letzte für das hellste Intervall, wodurch sich die Arrays leicht darstellen und vergleichen lassen. Addieren Sie counts und prüfen Sie, ob die Summe pixel_count entspricht; der Algorithmus garantiert diese Eigenschaft, und die Kontrolle kann Kürzungen an anderer Stelle Ihrer Verarbeitungskette sichtbar machen. Histogramme fassen Häufigkeiten zusammen, nicht die räumliche Anordnung. Daher können sehr unterschiedliche Bilder dasselbe Ergebnis besitzen. Die Funktion dekodiert keine Dateien, erkennt keine Farbräume, normalisiert keine Belichtung und verbindet keine Kanäle. Dekodieren Sie zunächst die Quelle. Im Browser bleiben die Daten lokal; die API-Automatisierung kostet $0.002 je Anfrage.