HALCON Website / HALCON Operator-Referenz / Bild / Merkmale
KlassenKlassen | | Operatoren

gray_histo_rangegray_histo_rangeGrayHistoRangeGrayHistoRange (Operator)

Name

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

Signatur

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

Herror gray_histo_range(const Hobject Regions, const Hobject Image, double Min, double Max, const Hlong NumBins, Hlong* Histo, double* BinSize)

Herror T_gray_histo_range(const Hobject Regions, const Hobject Image, const Htuple Min, const Htuple Max, const Htuple NumBins, Htuple* Histo, Htuple* BinSize)

void GrayHistoRange(const HObject& Regions, const HObject& Image, const HTuple& Min, const HTuple& Max, const HTuple& NumBins, HTuple* Histo, HTuple* BinSize)

HTuple HImage::GrayHistoRange(const HRegion& Regions, const HTuple& Min, const HTuple& Max, Hlong NumBins, double* BinSize) const

Hlong HImage::GrayHistoRange(const HRegion& Regions, double Min, double Max, Hlong NumBins, double* BinSize) const

HTuple HRegion::GrayHistoRange(const HImage& Image, const HTuple& Min, const HTuple& Max, Hlong NumBins, double* BinSize) const

Hlong HRegion::GrayHistoRange(const HImage& Image, double Min, double Max, Hlong NumBins, double* BinSize) const

static void HOperatorSet.GrayHistoRange(HObject regions, HObject image, HTuple min, HTuple max, HTuple numBins, out HTuple histo, out HTuple binSize)

HTuple HImage.GrayHistoRange(HRegion regions, HTuple min, HTuple max, int numBins, out double binSize)

int HImage.GrayHistoRange(HRegion regions, double min, double max, int numBins, out double binSize)

HTuple HRegion.GrayHistoRange(HImage image, HTuple min, HTuple max, int numBins, out double binSize)

int HRegion.GrayHistoRange(HImage image, double min, double max, int numBins, out double binSize)

Beschreibung

gray_histo_rangegray_histo_rangeGrayHistoRangeGrayHistoRangeGrayHistoRange erstellt die Grauwertverteilung HistoHistoHistoHistohisto des einkanaligen Bildes ImageImageImageImageimage innerhalb von RegionsRegionsRegionsRegionsregions und des Grauwertbereichs [MinMinMinMinmin,MaxMaxMaxMaxmax]. Die Werte für MinMinMinMinmin und MaxMaxMaxMaxmax werden abgerundet falls das Bild ImageImageImageImageimage nicht vom Datentyp 'real'"real""real""real""real" ist. Der Grauwertbereich wird in NumBinsNumBinsNumBinsNumBinsnumBins gleichgroße Klassen aufgeteilt. Die Größe einer solchen Klasse wird in BinSizeBinSizeBinSizeBinSizebinSize ausgegeben. Liegt ein Grauwert zwischen zwei Klassen wird er immer der kleineren Klasse zugeordnet. Bei einem Bild vom Datentyp 'real'"real""real""real""real" ist die Klassengröße . Bei einem Bild mit diskreten Grauwerten wird die Klassengröße über berechnet. Die Erstellung des Grauwerthistogramms HistoHistoHistoHistohisto über gray_histo_rangegray_histo_rangeGrayHistoRangeGrayHistoRangeGrayHistoRange eignet sich vor allem bei Bildern vom Typ 'real'"real""real""real""real" und bei Bildern vom Typ 'integer'"integer""integer""integer""integer" mit hoher Bittiefe da über 'NumBins'"NumBins""NumBins""NumBins""NumBins" die Genauigkeit des Histogramms HistoHistoHistoHistohisto beliebig angepasst werden kann.

Achtung

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

Bei einem Bild mit diskreten Grauwerten kann es in Abhängigkeit von BinSizeBinSizeBinSizeBinSizebinSize zu den folgenden Effekten kommen: Für BinSizeBinSizeBinSizeBinSizebinSize > 1 werden mehrere benachbarte Grauwerte derselben Klasse zugeordnet. Ist BinSizeBinSizeBinSizeBinSizebinSize dabei keine natürliche Zahl werden die Grauwerte ungleichmäßig auf die Klassen verteilt (Für BinSizeBinSizeBinSizeBinSizebinSize = 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 HistoHistoHistoHistohisto bemerkbar. Gilt BinSizeBinSizeBinSizeBinSizebinSize < 1 werden je nach BinSizeBinSizeBinSizeBinSizebinSize einigen Klassen keine Grauwerte zugeordnet (Für BinSizeBinSizeBinSizeBinSizebinSize = 0.5 wird beispielsweise der erste Grauwert der ersten Klasse und der zweite Grauwert der dritten Klasse zugeordnet). Das Histogramm HistoHistoHistoHistohisto weist dann einige Lücken auf, was der Strukur eines Kamms ähnelt.

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

Ausführungsinformationen

Parameter

RegionsRegionsRegionsRegionsregions (input_object)  region(-array) → objectHRegionHRegionHobject

Region, in der das Histogramm berechnet werden soll.

ImageImageImageImageimage (input_object)  singlechannelimage → objectHImageHImageHobject (byte / cyclic / direction / int1 / uint2 / int2 / int4 / int8 / real)

Eingabebild.

MinMinMinMinmin (input_control)  real → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Minimaler Grauwert.

Defaultwert: 0

Wertevorschläge: 0

MaxMaxMaxMaxmax (input_control)  real → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Maximaler Grauwert.

Defaultwert: 255

Wertevorschläge: 255

Restriktion: Max >= Min

NumBinsNumBinsNumBinsNumBinsnumBins (input_control)  integer → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Anzahl Klassen.

Defaultwert: 256

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

Restriktion: NumBins >= 1

HistoHistoHistoHistohisto (output_control)  histogram(-array) → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Zu berechnendes Histogramm.

BinSizeBinSizeBinSizeBinSizebinSize (output_control)  real → HTupleHTupleHtuple (real) (double) (double) (double)

Klassengröße.

Ergebnis

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

Vorgänger

min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray

Nachfolger

create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArrayCreateFunct1dArray

Alternativen

gray_histogray_histoGrayHistoGrayHistoGrayHisto, gray_histo_absgray_histo_absGrayHistoAbsGrayHistoAbsGrayHistoAbs

Siehe auch

histo_2dimhisto_2dimHisto2dimHisto2dimHisto2dim, scale_image_maxscale_image_maxScaleImageMaxScaleImageMaxScaleImageMax

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 19.11.0.0 Copyright © 1996-2019 MVTec Software GmbH