HALCON 25.11.0.0 / 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_rangeGrayHistoRangeGrayHistoRangegray_histo_range erstellt die Grauwertverteilung HistoHistoHistohistohisto des einkanaligen Bildes ImageImageImageimageimage innerhalb von RegionRegionRegionregionregion 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 NumBinsNumBinsNumBinsnumBinsnum_bins gleichgroße Klassen aufgeteilt. Die Größe einer solchen Klasse wird in BinSizeBinSizeBinSizebinSizebin_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" 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_rangeGrayHistoRangeGrayHistoRangegray_histo_range 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 NumBinsNumBinsNumBinsnumBinsnum_bins die Genauigkeit des Histogramms HistoHistoHistohistohisto beliebig angepasst werden kann.

Achtung

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

RegionRegionRegionregionregion (input_object)  region → objectHRegionHObjectHObjectHobject

Region, in der das Histogramm berechnet werden soll.

ImageImageImageimageimage (input_object)  singlechannelimage → objectHImageHObjectHObjectHobject (byte / cyclic / direction / int1 / uint2 / int2 / int4 / int8 / real)

Eingabebild.

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

Minimaler Grauwert.

Default: 0

Wertevorschläge: 0

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

Maximaler Grauwert.

Default: 255

Wertevorschläge: 255

Restriktion: Max >= Min

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

Anzahl Klassen.

Default: 256

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

Restriktion: NumBins >= 1

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

Zu berechnendes Histogramm.

BinSizeBinSizeBinSizebinSizebin_size (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Klassengröße.

Ergebnis

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

Vorgänger

min_max_graymin_max_grayMinMaxGrayMinMaxGraymin_max_gray

Nachfolger

create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArraycreate_funct_1d_array

Alternativen

gray_histogray_histoGrayHistoGrayHistogray_histo, gray_histo_absgray_histo_absGrayHistoAbsGrayHistoAbsgray_histo_abs

Siehe auch

histo_2dimhisto_2dimHisto2dimHisto2dimhisto_2dim, scale_image_maxscale_image_maxScaleImageMaxScaleImageMaxscale_image_max

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 25.11.0.0 Copyright © 1996-2025 MVTec Software GmbH