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

gray_histo_rangegray_histo_rangeGrayHistoRangeGrayHistoRangegray_histo_range (Operator)

Name

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

Signatur

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

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

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

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

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

Hlong HImage::GrayHistoRange(const HRegion& Region, 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 region, HObject image, HTuple min, HTuple max, HTuple numBins, out HTuple histo, out HTuple binSize)

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

int HImage.GrayHistoRange(HRegion region, 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)

def gray_histo_range(region: HObject, image: HObject, min: Union[float, int], max: Union[float, int], num_bins: int) -> Tuple[Sequence[int], float]

def gray_histo_range_s(region: HObject, image: HObject, min: Union[float, int], max: Union[float, int], num_bins: int) -> Tuple[int, float]

Beschreibung

gray_histo_rangegray_histo_rangeGrayHistoRangeGrayHistoRangeGrayHistoRangegray_histo_range erstellt die Grauwertverteilung HistoHistoHistoHistohistohisto des einkanaligen Bildes ImageImageImageImageimageimage innerhalb von RegionRegionRegionRegionregionregion 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 NumBinsNumBinsNumBinsNumBinsnumBinsnum_bins gleichgroße Klassen aufgeteilt. Die Größe einer solchen Klasse wird in BinSizeBinSizeBinSizeBinSizebinSizebin_size 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 . Bei einem Bild mit diskreten Grauwerten wird die Klassengröße über berechnet. Die Erstellung des Grauwerthistogramms HistoHistoHistoHistohistohisto über gray_histo_rangegray_histo_rangeGrayHistoRangeGrayHistoRangeGrayHistoRangegray_histo_range 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 NumBinsNumBinsNumBinsNumBinsnumBinsnum_bins die Genauigkeit des Histogramms HistoHistoHistoHistohistohisto beliebig angepasst werden kann.

Achtung

Der Operator gray_histo_rangegray_histo_rangeGrayHistoRangeGrayHistoRangeGrayHistoRangegray_histo_range berücksichtigt nur die mittels RegionRegionRegionRegionregionregion ü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 BinSizeBinSizeBinSizeBinSizebinSizebin_size zu den folgenden Effekten kommen: Für BinSizeBinSizeBinSizeBinSizebinSizebin_size > 1 werden mehrere benachbarte Grauwerte derselben Klasse zugeordnet. Ist BinSizeBinSizeBinSizeBinSizebinSizebin_size dabei keine natürliche Zahl werden die Grauwerte ungleichmäßig auf die Klassen verteilt (Für BinSizeBinSizeBinSizeBinSizebinSizebin_size = 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 BinSizeBinSizeBinSizeBinSizebinSizebin_size < 1 werden je nach BinSizeBinSizeBinSizeBinSizebinSizebin_size einigen Klassen keine Grauwerte zugeordnet (Für BinSizeBinSizeBinSizeBinSizebinSizebin_size = 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.

Ausführungsinformationen

Parameter

RegionRegionRegionRegionregionregion (input_object)  region → objectHRegionHObjectHRegionHobject

Region, in der das Histogramm berechnet werden soll.

ImageImageImageImageimageimage (input_object)  singlechannelimage → objectHImageHObjectHImageHobject (byte / cyclic / direction / int1 / uint2 / int2 / int4 / int8 / real)

Eingabebild.

MinMinMinMinminmin (input_control)  real → HTupleUnion[float, int]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Minimaler Grauwert.

Defaultwert: 0

Wertevorschläge: 0

MaxMaxMaxMaxmaxmax (input_control)  real → HTupleUnion[float, int]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Maximaler Grauwert.

Defaultwert: 255

Wertevorschläge: 255

Restriktion: Max >= Min

NumBinsNumBinsNumBinsNumBinsnumBinsnum_bins (input_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Anzahl Klassen.

Defaultwert: 256

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

Restriktion: NumBins >= 1

HistoHistoHistoHistohistohisto (output_control)  histogram(-array) → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Zu berechnendes Histogramm.

BinSizeBinSizeBinSizeBinSizebinSizebin_size (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Klassengröße.

Ergebnis

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

Vorgänger

min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGraymin_max_gray

Nachfolger

create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArrayCreateFunct1dArraycreate_funct_1d_array

Alternativen

gray_histogray_histoGrayHistoGrayHistoGrayHistogray_histo, gray_histo_absgray_histo_absGrayHistoAbsGrayHistoAbsGrayHistoAbsgray_histo_abs

Siehe auch

histo_2dimhisto_2dimHisto2dimHisto2dimHisto2dimhisto_2dim, scale_image_maxscale_image_maxScaleImageMaxScaleImageMaxScaleImageMaxscale_image_max

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 22.11.4.0 Copyright © 1996-2025 MVTec Software GmbH
Follow us on