gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange (Operator)

Name

gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange — Berechne die Grauwertverteilung eines einkanaligen Bildes innerhalb eines bestimmten Grauwertbereichs.

Signatur

gray_histo_range(Regions, Image : : Min, Max, NumBins : Histo, BinSize)

Beschreibung

gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange erstellt die Grauwertverteilung HistoHistoHistoHistoHistohisto des einkanaligen Bildes ImageImageImageImageImageimage innerhalb von RegionsRegionsRegionsRegionsRegionsregions und des Grauwertbereichs [MinMinMinMinMinmin,MaxMaxMaxMaxMaxmax]. Die Werte für MinMinMinMinMinmin und MaxMaxMaxMaxMaxmax werden abgerundet falls das Bild ImageImageImageImageImageimage nicht vom Datentyp 'real'"real""real""real""real""real" ist. Der Grauwertbereich wird in NumBinsNumBinsNumBinsNumBinsNumBinsnumBins gleichgroße Klassen aufgeteilt. Die Größe einer solchen Klasse wird in BinSizeBinSizeBinSizeBinSizeBinSizebinSize ausgegeben. Liegt ein Grauwert zwischen zwei Klassen wird er immer der kleineren Klasse zugeordnet. Bei einem Bild vom Datentyp 'real'"real""real""real""real""real" ist die Klassengröße BinSizeBinSizeBinSizeBinSizeBinSizebinSize = (MaxMaxMaxMaxMaxmax - MinMinMinMinMinmin) / NumBinsNumBinsNumBinsNumBinsNumBinsnumBins . Bei einem Bild mit diskreten Grauwerten wird die Klassengröße über BinSizeBinSizeBinSizeBinSizeBinSizebinSize = (MaxMaxMaxMaxMaxmax - MinMinMinMinMinmin + 1) / NumBinsNumBinsNumBinsNumBinsNumBinsnumBins berechnet. Die Erstellung des Grauwerthistogramms HistoHistoHistoHistoHistohisto über gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange eignet sich vor allem bei Bildern vom Typ 'real'"real""real""real""real""real" und bei Bildern vom Typ 'integer'"integer""integer""integer""integer""integer" mit hoher Bittiefe da über 'NumBins'"NumBins""NumBins""NumBins""NumBins""NumBins" die Genauigkeit des Histogramms HistoHistoHistoHistoHistohisto beliebig angepasst werden kann.

Der Operator gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange berücksichtigt nur die mittels RegionsRegionsRegionsRegionsRegionsregions übergebenen Regionen und ignoriert jede Domäne, die zuvor für das Eingabebild ImageImageImageImageImageimage festgelegt wurde.

Bei einem Bild mit diskreten Grauwerten kann es in Abhängigkeit von BinSizeBinSizeBinSizeBinSizeBinSizebinSize zu den folgenden Effekten kommen: Für BinSizeBinSizeBinSizeBinSizeBinSizebinSize > 1 werden mehrere benachbarte Grauwerte derselben Klasse zugeordnet. Ist BinSizeBinSizeBinSizeBinSizeBinSizebinSize dabei keine natürliche Zahl werden die Grauwerte ungleichmäßig auf die Klassen verteilt (Für BinSizeBinSizeBinSizeBinSizeBinSizebinSize = 1.5 werden beispielsweise die ersten beiden Grauwerte der ersten Klasse, der dritte Grauwert der zweiten Klasse und der vierte und fünfte Grauwert der dritten Klasse zugeordnet). Dies macht sich durch einzelne Spitzen im Histogramm HistoHistoHistoHistoHistohisto bemerkbar. Gilt BinSizeBinSizeBinSizeBinSizeBinSizebinSize < 1 werden je nach BinSizeBinSizeBinSizeBinSizeBinSizebinSize einigen Klassen keine Grauwerte zugeordnet (Für BinSizeBinSizeBinSizeBinSizeBinSizebinSize = 0.5 wird beispielsweise der erste Grauwert der ersten Klasse und der zweite Grauwert der dritten Klasse zugeordnet). Das Histogramm HistoHistoHistoHistoHistohisto weist dann einige Lücken auf, was der Strukur eines Kamms ähnelt.

Bei einem Bild vom Datentyp 'real'"real""real""real""real""real" werden für MinMinMinMinMinmin = MaxMaxMaxMaxMaxmax alle Pixel des entsprechenden Grauwertes nur der ersten Klasse zugeordnet.

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Automatisch parallelisiert auf interner Datenebene.

Parameter

RegionsRegionsRegionsRegionsRegionsregions (input_object) region(-array) → object

Region, in der das Histogramm berechnet werden soll.

ImageImageImageImageImageimage (input_object) singlechannelimage → object (byte / cyclic / direction / int1 / uint2 / int2 / int4 / int8 / real)

Eingabebild.

MinMinMinMinMinmin (input_control) real → (real / integer)

Minimaler Grauwert.

Defaultwert: 0

Wertevorschläge: 0

MaxMaxMaxMaxMaxmax (input_control) real → (real / integer)

Maximaler Grauwert.

Defaultwert: 255

Wertevorschläge: 255

Restriktion: Max >= Min

NumBinsNumBinsNumBinsNumBinsNumBinsnumBins (input_control) integer → (integer)

Anzahl Klassen.

Defaultwert: 256

Wertevorschläge: 16, 32, 64, 128, 256

Restriktion: NumBins >= 1

HistoHistoHistoHistoHistohisto (output_control) histogram(-array) → (integer)

Zu berechnendes Histogramm.

BinSizeBinSizeBinSizeBinSizeBinSizebinSize (output_control) real → (real)

Klassengröße.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray

Nachfolger

create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArray

Alternativen

gray_histogray_histoGrayHistogray_histoGrayHistoGrayHisto, gray_histo_absgray_histo_absGrayHistoAbsgray_histo_absGrayHistoAbsGrayHistoAbs

Siehe auch

histo_2dimhisto_2dimHisto2dimhisto_2dimHisto2dimHisto2dim, scale_image_maxscale_image_maxScaleImageMaxscale_image_maxScaleImageMaxScaleImageMax

Modul

Foundation

Operatoren