HALCON Website / HALCON Operator-Referenz / Segmentation / Topographie
KlassenKlassen | | Operatoren

local_min_sub_pixT_local_min_sub_pixLocalMinSubPixLocalMinSubPix (Operator)

Name

local_min_sub_pixT_local_min_sub_pixLocalMinSubPixLocalMinSubPix — Subpixelgenaue Detektion von lokalen Minima in einem Bild.

Signatur

local_min_sub_pix(Image : : Filter, Sigma, Threshold : Row, Column)

Herror T_local_min_sub_pix(const Hobject Image, const Htuple Filter, const Htuple Sigma, const Htuple Threshold, Htuple* Row, Htuple* Column)

void LocalMinSubPix(const HObject& Image, const HTuple& Filter, const HTuple& Sigma, const HTuple& Threshold, HTuple* Row, HTuple* Column)

void HImage::LocalMinSubPix(const HString& Filter, double Sigma, double Threshold, HTuple* Row, HTuple* Column) const

void HImage::LocalMinSubPix(const char* Filter, double Sigma, double Threshold, HTuple* Row, HTuple* Column) const

void HImage::LocalMinSubPix(const wchar_t* Filter, double Sigma, double Threshold, HTuple* Row, HTuple* Column) const   (Nur Windows)

static void HOperatorSet.LocalMinSubPix(HObject image, HTuple filter, HTuple sigma, HTuple threshold, out HTuple row, out HTuple column)

void HImage.LocalMinSubPix(string filter, double sigma, double threshold, out HTuple row, out HTuple column)

Beschreibung

local_min_sub_pixlocal_min_sub_pixLocalMinSubPixLocalMinSubPixLocalMinSubPix extrahiert subpixelgenau lokale Minima aus dem Bild ImageImageImageImageimage. Zur Detektion der lokalen Minima wird das Eingangsbild in jedem Punkt durch ein quadratisches Polynom in x und y approximiert und dieses auf lokale Minima hin untersucht. Um das Polynom aufzustellen, werden die partiellen Ableitungen abhängig von FilterFilterFilterFilterfilter entweder mit verschiedenen Ableitungen der Gaußfunktion oder nach dem Facet-Modell berechnet. Im ersten Fall bestimmt SigmaSigmaSigmaSigmasigma die Größe der verwendeten Gaußkerne, im zweiten Fall erfolgt vor der Berechnung der partiellen Ableitungen eine Glättung des Eingabebildes mit einem Gaußfilter der Größe SigmaSigmaSigmaSigmasigma. Der Modus 'facet'"facet""facet""facet""facet" ist damit etwas schneller, liefert aber auch etwas ungenauere Resultate. Sind beide Eigenwerte der Hessematrix im untersuchten Punkt größer als ThresholdThresholdThresholdThresholdthreshold, dann liegt ein lokales Minimum vor. Die Eigenwerte entsprechen der Krümmung der Grauwertoberfläche.

Achtung

Beachten Sie, dass Filteroperatoren eventuell unerwartete Resultate ausgeben, wenn ein Bild mit einer reduzierten Domäne als Input übergeben wird. Weitere Informationen können im Kapitel Filter gefunden werden.

Ausführungsinformationen

Parameter

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

Eingabebilder.

FilterFilterFilterFilterfilter (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Verfahren zur Berechnung der partiellen Ableitungen.

Defaultwert: 'facet' "facet" "facet" "facet" "facet"

Werteliste: 'facet'"facet""facet""facet""facet", 'gauss'"gauss""gauss""gauss""gauss"

SigmaSigmaSigmaSigmasigma (input_control)  real → HTupleHTupleHtuple (real) (double) (double) (double)

Sigma der Gaußfunktion. Ist FilterFilterFilterFilterfilter auf 'facet' gesetzt, kann SigmaSigmaSigmaSigmasigma auf 0.0 gesetzt werden, um eine Glättung des Eingangsbildes zu vermeiden.

Wertevorschläge: 0.7, 0.8, 0.9, 1.0, 1.2, 1.5, 2.0, 3.0

Restriktion: Sigma >= 0.0

ThresholdThresholdThresholdThresholdthreshold (input_control)  real → HTupleHTupleHtuple (real) (double) (double) (double)

Mindestbetrag der Eigenwerte der Hessematrix.

Defaultwert: 5.0

Wertevorschläge: 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0

Restriktion: Threshold >= 0.0

RowRowRowRowrow (output_control)  point.y-array → HTupleHTupleHtuple (real) (double) (double) (double)

Zeilenkoordinaten der gefundenen Minima.

ColumnColumnColumnColumncolumn (output_control)  point.x-array → HTupleHTupleHtuple (real) (double) (double) (double)

Spaltenkoordinaten der gefundenen Minima.

Ergebnis

Sind die Parameterwerte korrekt und tritt kein Fehler während der Berechnung auf, liefert local_min_sub_pixlocal_min_sub_pixLocalMinSubPixLocalMinSubPixLocalMinSubPix den Wert 2 (H_MSG_TRUE). Das Verhalten bei leerer Eingabe (keine Eingabebilder vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

gen_cross_contour_xldgen_cross_contour_xldGenCrossContourXldGenCrossContourXldGenCrossContourXld, disp_crossdisp_crossDispCrossDispCrossDispCross

Alternativen

critical_points_sub_pixcritical_points_sub_pixCriticalPointsSubPixCriticalPointsSubPixCriticalPointsSubPix, local_max_sub_pixlocal_max_sub_pixLocalMaxSubPixLocalMaxSubPixLocalMaxSubPix, saddle_points_sub_pixsaddle_points_sub_pixSaddlePointsSubPixSaddlePointsSubPixSaddlePointsSubPix

Siehe auch

local_minlocal_minLocalMinLocalMinLocalMin, lowlandslowlandsLowlandsLowlandsLowlands, lowlands_centerlowlands_centerLowlandsCenterLowlandsCenterLowlandsCenter

Modul

Foundation

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