gray_histoT_gray_histoGrayHistogray_histoGrayHistoGrayHisto (Operator)

Name

gray_histoT_gray_histoGrayHistogray_histoGrayHistoGrayHisto — Verteilung der Grauwerte.

Signatur

Beschreibung

gray_histogray_histoGrayHistogray_histoGrayHistoGrayHisto berechnet für das übergebene Bild (ImageImageImageImageImageimage) innerhalb von RegionsRegionsRegionsRegionsRegionsregions das absolute (AbsoluteHistoAbsoluteHistoAbsoluteHistoAbsoluteHistoAbsoluteHistoabsoluteHisto) und relative (RelativeHistoRelativeHistoRelativeHistoRelativeHistoRelativeHistorelativeHisto) Histogramm der Grauwerte.

Beide Histogramme sind Tupel von 256 Werten, die (beginnend mit 0) die Häufigkeiten der einzelnen Grauwerte im Bild enthalten.

AbsoluteHistoAbsoluteHistoAbsoluteHistoAbsoluteHistoAbsoluteHistoabsoluteHisto gibt dabei die absoluten Häufigkeiten der Grauwerte durch ganze Zahlen an, RelativeHistoRelativeHistoRelativeHistoRelativeHistoRelativeHistorelativeHisto die relativen, d.h. die absoluten Häufigkeiten dividiert durch die Fläche des Bildes, als Gleitpunktzahlen.

'real'"real""real""real""real""real"- 'int2'"int2""int2""int2""int2""int2"-, 'uint2'"uint2""uint2""uint2""uint2""uint2"- und 'int4'"int4""int4""int4""int4""int4"-Bilder werden in 'byte'"byte""byte""byte""byte""byte"-Bilder umgewandelt (zuerst wird der größte und der kleinste Grauwert im Bild bestimmt und anschließend werden die Originalgrauwerte linear in den Bereich 0..255 abgebildet) und dann wie oben verarbeitet. Mit set_paint(::WindowHandle,'histogram':)set_paint(WindowHandle,"histogram")SetPaint(WindowHandle,"histogram")set_paint(WindowHandle,"histogram")SetPaint(WindowHandle,"histogram")SetPaint(WindowHandle,"histogram") und disp_imagedisp_imageDispImagedisp_imageDispImageDispImage kann das Histogramm auch direkt als Graphik ausgegeben werden.

Achtung

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

real-, int2, uint2 und int4-Bilder werden auf 256 Grauwerte reduziert.

Für byte-, int1-, direction- und cyclic-Bilder kann gray_histogray_histoGrayHistogray_histoGrayHistoGrayHisto auf OpenCL Geräten ausgeführt werden, sofern das Gerät die in OpenCL 1.0 optionalen Erweiterungen cl_khr_local_int32_base_atomics und cl_khr_global_int32_base_atomics unterstützt. Im Gegensatz zu den meisten anderen HALCON Operatoren kann gray_histogray_histoGrayHistogray_histoGrayHistoGrayHisto auf OpenCL Geräten deutlich langsamer laufen, wenn das Bild ImageImageImageImageImageimage sich nicht komplett innerhalb der Regionen RegionsRegionsRegionsRegionsRegionsregions befindet.

In HALCON XL ist keine Ausführung mit OpenCL möglich, da atomare 64-Bit-Festkommaarithmetik erforderlich wäre.

Parallelisierung

• Unterstützt OpenCL Compute Devices.
• 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

Komplexität

Sei F die Fläche der Region, dann beträgt die Laufzeitkomplexität O(F + 255).

Ergebnis

gray_histogray_histoGrayHistogray_histoGrayHistoGrayHisto liefert den Wert 2 (H_MSG_TRUE), falls das Bild definierte Grauwerte hat und die Parameter korrekt sind. Das Verhalten bei leerer Eingabe (keine Eingabebilder) wird mit set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>), das bei leerer Region mit set_system(::'empty_region_result',<Result>:)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>) festgelegt. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

histo_to_threshhisto_to_threshHistoToThreshhisto_to_threshHistoToThreshHistoToThresh, gen_region_histogen_region_histoGenRegionHistogen_region_histoGenRegionHistoGenRegionHisto

Alternativen

min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray, intensityintensityIntensityintensityIntensityIntensity, gray_histo_absgray_histo_absGrayHistoAbsgray_histo_absGrayHistoAbsGrayHistoAbs, gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange

Siehe auch

set_paintset_paintSetPaintset_paintSetPaintSetPaint, disp_imagedisp_imageDispImagedisp_imageDispImageDispImage, histo_2dimhisto_2dimHisto2dimhisto_2dimHisto2dimHisto2dim, scale_image_maxscale_image_maxScaleImageMaxscale_image_maxScaleImageMaxScaleImageMax, entropy_grayentropy_grayEntropyGrayentropy_grayEntropyGrayEntropyGray

Modul

Foundation