dual_thresholddual_thresholdDualThresholdDualThresholddual_threshold (Operator)

Name

dual_thresholddual_thresholdDualThresholdDualThresholddual_threshold — Segmentieren mit Schwellen für Bilder mit Vorzeichen.

Signatur

dual_threshold(Image : RegionCrossings : MinSize, MinGray, Threshold : )

Beschreibung

dual_thresholddual_thresholdDualThresholdDualThresholddual_threshold segmentiert das Eingabebild in eine Teilregion mit Grauwerten ThresholdThresholdThresholdthresholdthreshold („positive“ Bildbereiche) und eine mit Grauwerten ThresholdThresholdThresholdthresholdthreshold („negative“ Bildbereiche). Nur „positive“ oder „negative“ Teilbereiche mit einer Fläche größer als MinSizeMinSizeMinSizeminSizemin_size werden dabei berücksichtigt. Teilbereiche, deren maximaler Grauwert betragsmäßig kleiner ist als MinGrayMinGrayMinGrayminGraymin_gray, werden unterdrückt.

Die durchgeführte Segmentierung ist nicht vollständig, d.h. die „positiven“ und „negativen“ Ergebnisregionen überdecken zusammengenommen nicht unbedingt das ganze Eingabebild. Es bleiben alle Bildbereiche unberücksichtigt, deren Grauwerte zwischen ThresholdThresholdThresholdthresholdthreshold und ThresholdThresholdThresholdthresholdthreshold (bzw. MinGrayMinGrayMinGrayminGraymin_gray und MinGrayMinGrayMinGrayminGraymin_gray) liegen.

dual_thresholddual_thresholdDualThresholdDualThresholddual_threshold schließt sich typischerweise an die Anwendung von Laplace-Operatoren wie (laplacelaplaceLaplaceLaplacelaplace, laplace_of_gausslaplace_of_gaussLaplaceOfGaussLaplaceOfGausslaplace_of_gauss, derivate_gaussderivate_gaussDerivateGaussDerivateGaussderivate_gauss oder diff_of_gaussdiff_of_gaussDiffOfGaussDiffOfGaussdiff_of_gauss) oder eine Bildsubtraktion (sub_imagesub_imageSubImageSubImagesub_image) an. In den Nulldurchgängen des Laplace-Operators spiegeln sich Bildkanten wider, die sich als Trennlinien zwischen den „positiven“ und „negativen“ Bildbereichen bestimmen lassen. Dazu ruft man zuerst dual_thresholddual_thresholdDualThresholdDualThresholddual_threshold mit ThresholdThresholdThresholdthresholdthreshold = 1 auf und erzeugt dann die komplementäre Regionen mittels complementcomplementComplementComplementcomplement. Der Parameter MinGrayMinGrayMinGrayminGraymin_gray steuert dabei die Rauschinvarianz,während MinSizeMinSizeMinSizeminSizemin_size das Auflösungsvermögen der Kantendetektion steuert.

Bei Pixeltypen ohne Vorzeichen (byte) wird nur die positive Hälfte der Segmentierung durchgeführt. dual_thresholddual_thresholdDualThresholdDualThresholddual_threshold verhält sich also wie eine einfaches Schwellenwertverfahren (thresholdthresholdThresholdThresholdthreshold) mit nachgeschaltetem connectionconnectionConnectionConnectionconnection und select_grayselect_graySelectGraySelectGrayselect_gray.

Ausführungsinformationen

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

Parameter

ImageImageImageimageimage (input_object) singlechannelimage(-array) → object (byte / int1 / int2 / int4 / real)

Eingabebild.

RegionCrossingsRegionCrossingsRegionCrossingsregionCrossingsregion_crossings (output_object) region-array → object

„Positive“ und „negative“ Teilregionen.

MinSizeMinSizeMinSizeminSizemin_size (input_control) integer → (integer)

Teilregionen mit weniger als MinSize Fläche werden unterdrückt.

Default: 20

Wertevorschläge: 0, 10, 20, 50, 100, 200, 500, 1000

Wertebereich: 0 ≤ MinSize MinSize MinSize minSize min_size ≤ 10000 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

MinGrayMinGrayMinGrayminGraymin_gray (input_control) real → (real)

Teilregionen, deren maximaler Grauwert betragsmäßig kleiner als MinGray ist, werden unterdrückt.

Default: 5.0

Wertevorschläge: 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 9.0, 11.0, 15.0, 20.0

Wertebereich: 0 ≤ MinGray MinGray MinGray minGray min_gray (lin)

Minimale Schrittweite: 1.0

Empfohlene Schrittweite: 10.0

ThresholdThresholdThresholdthresholdthreshold (input_control) real → (real)

Zurückgeliefert werden Teilregionen, deren Grauwerte größer gleich (bzw. kleiner gleich) Threshold (-Threshold) sind.

Default: 2.0

Wertevorschläge: 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 9.0, 11.0, 15.0, 20.0

Wertebereich: 0 ≤ Threshold Threshold Threshold threshold threshold (lin)

Minimale Schrittweite: 1.0

Empfohlene Schrittweite: 10.0

Beispiel (HDevelop)

* Edge detection with the Laplace operator (and edge thinning)
diff_of_gauss(Image,Laplace,2.0,1.6)
* find "`positive"' and "`negative"' regions:
dual_threshold(Laplace,Region,20,2,1)
* The zero runnings are the complement to these image section:
complement(Region,ZeroCrossings)

* Simulation of dual_threshold
dual_threshold(Laplace,Result,MinS,MinG,Threshold)
threshold(Laplace,Tmp1,Threshold,999999)
connection(Tmp1,Tmp2)
select_shape(Tmp2,Tmp3,'area','and',MinS,999999)
select_gray(Laplace,Tmp3,Tmp4,'max','and',MinG,999999)
threshold(Laplace,Tmp5,-999999,-Threshold)
connection(Tmp5,Tmp6)
select_shape(Tmp6,Tmp7,'area','and',MinS,999999)
select_gray(Laplace,Tmp7,Tmp8,'min','and',-999999,-MinG)
concat_obj(Tmp4,Tmp8,Result)

Beispiel (C)

/* Edge detection with the Laplace operator (and edge thinning) */
diff_of_gauss(Image,&Laplace,2.0,1.6);
/* find "`positive"' and "`negative"' regions: */
dual_threshold(Laplace,&Region,20,2,1);
/*The zero runnings are the complement to these image section: */
complement(Region,ZeroCrossings);

Beispiel (C++)

#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;

int main (int argc, char *argv[])
{
  if (argc != 2)
  {
    cout << "Usage : " << argv[0] << " 'image' " << endl;
    return (-1);
  }

  HImage       image (argv[1]),
               laplace;
  HWindow      win;

  HRegionArray region,
               nulldg;

  image.Display (win);

  laplace = image.DiffOfGauss (2.0, 1.6);
  region  = laplace.DualThreshold (20, 2, 1);
  nulldg  = region.Complement ();

  laplace.Display (win);     win.Click ();
  region.Display (win);      win.Click ();
  nulldg.Display (win);      win.Click ();

  return (0);
}

Beispiel (HDevelop)

* Edge detection with the Laplace operator (and edge thinning)
diff_of_gauss(Image,Laplace,2.0,1.6)
* find "`positive"' and "`negative"' regions:
dual_threshold(Laplace,Region,20,2,1)
* The zero runnings are the complement to these image section:
complement(Region,ZeroCrossings)

* Simulation of dual_threshold
dual_threshold(Laplace,Result,MinS,MinG,Threshold)
threshold(Laplace,Tmp1,Threshold,999999)
connection(Tmp1,Tmp2)
select_shape(Tmp2,Tmp3,'area','and',MinS,999999)
select_gray(Laplace,Tmp3,Tmp4,'max','and',MinG,999999)
threshold(Laplace,Tmp5,-999999,-Threshold)
connection(Tmp5,Tmp6)
select_shape(Tmp6,Tmp7,'area','and',MinS,999999)
select_gray(Laplace,Tmp7,Tmp8,'min','and',-999999,-MinG)
concat_obj(Tmp4,Tmp8,Result)

Ergebnis

dual_thresholddual_thresholdDualThresholdDualThresholddual_threshold liefert normalerweise den Wert 2 ( H_MSG_TRUE) . Für das Verhalten bzgl. der Eingabebilder und Ausgaberegionen sind die Flags 'no_object_result'"no_object_result""no_object_result""no_object_result""no_object_result", 'empty_region_result'"empty_region_result""empty_region_result""empty_region_result""empty_region_result" und 'store_empty_region'"store_empty_region""store_empty_region""store_empty_region""store_empty_region" einstellbar (siehe set_systemset_systemSetSystemSetSystemset_system). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

min_max_graymin_max_grayMinMaxGrayMinMaxGraymin_max_gray, sobel_ampsobel_ampSobelAmpSobelAmpsobel_amp, binomial_filterbinomial_filterBinomialFilterBinomialFilterbinomial_filter, gauss_filtergauss_filterGaussFilterGaussFiltergauss_filter, reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain, diff_of_gaussdiff_of_gaussDiffOfGaussDiffOfGaussdiff_of_gauss, sub_imagesub_imageSubImageSubImagesub_image, derivate_gaussderivate_gaussDerivateGaussDerivateGaussderivate_gauss, laplace_of_gausslaplace_of_gaussLaplaceOfGaussLaplaceOfGausslaplace_of_gauss, laplacelaplaceLaplaceLaplacelaplace, expand_regionexpand_regionExpandRegionExpandRegionexpand_region

Nachfolger

connectionconnectionConnectionConnectionconnection, dilation1dilation1Dilation1Dilation1dilation1, erosion1erosion1Erosion1Erosion1erosion1, openingopeningOpeningOpeningopening, closingclosingClosingClosingclosing, rank_regionrank_regionRankRegionRankRegionrank_region, shape_transshape_transShapeTransShapeTransshape_trans, skeletonskeletonSkeletonSkeletonskeleton

Alternativen

thresholdthresholdThresholdThresholdthreshold, dyn_thresholddyn_thresholdDynThresholdDynThresholddyn_threshold, check_differencecheck_differenceCheckDifferenceCheckDifferencecheck_difference

Siehe auch

connectionconnectionConnectionConnectionconnection, select_shapeselect_shapeSelectShapeSelectShapeselect_shape, select_grayselect_graySelectGraySelectGrayselect_gray

Modul

Foundation

Operatoren