HALCON Website / HALCON Operator-Referenz / Matching / Deformierbar
KlassenKlassenKlassenKlassen | | | | Operatoren

create_local_deformable_model_xldT_create_local_deformable_model_xldCreateLocalDeformableModelXldcreate_local_deformable_model_xldCreateLocalDeformableModelXldCreateLocalDeformableModelXld (Operator)

Name

create_local_deformable_model_xldT_create_local_deformable_model_xldCreateLocalDeformableModelXldcreate_local_deformable_model_xldCreateLocalDeformableModelXldCreateLocalDeformableModelXld — Vorbereiten eines deformierbaren Modells für lokal deformierbares Matching aus XLD-Konturen.

Signatur

create_local_deformable_model_xld(Contours : : NumLevels, AngleStart, AngleExtent, AngleStep, ScaleRMin, ScaleRMax, ScaleRStep, ScaleCMin, ScaleCMax, ScaleCStep, Optimization, Metric, MinContrast, ParamName, ParamValue : ModelID)

Herror T_create_local_deformable_model_xld(const Hobject Contours, const Htuple NumLevels, const Htuple AngleStart, const Htuple AngleExtent, const Htuple AngleStep, const Htuple ScaleRMin, const Htuple ScaleRMax, const Htuple ScaleRStep, const Htuple ScaleCMin, const Htuple ScaleCMax, const Htuple ScaleCStep, const Htuple Optimization, const Htuple Metric, const Htuple MinContrast, const Htuple ParamName, const Htuple ParamValue, Htuple* ModelID)

Herror create_local_deformable_model_xld(Hobject Contours, const HTuple& NumLevels, const HTuple& AngleStart, const HTuple& AngleExtent, const HTuple& AngleStep, const HTuple& ScaleRMin, const HTuple& ScaleRMax, const HTuple& ScaleRStep, const HTuple& ScaleCMin, const HTuple& ScaleCMax, const HTuple& ScaleCStep, const HTuple& Optimization, const HTuple& Metric, const HTuple& MinContrast, const HTuple& ParamName, const HTuple& ParamValue, Hlong* ModelID)

HDeformableModel HXLDCont::CreateLocalDeformableModelXld(const HTuple& NumLevels, const HTuple& AngleStart, const HTuple& AngleExtent, const HTuple& AngleStep, const HTuple& ScaleRMin, const HTuple& ScaleRMax, const HTuple& ScaleRStep, const HTuple& ScaleCMin, const HTuple& ScaleCMax, const HTuple& ScaleCStep, const HTuple& Optimization, const HTuple& Metric, const HTuple& MinContrast, const HTuple& ParamName, const HTuple& ParamValue) const

HDeformableModel HXLDContArray::CreateLocalDeformableModelXld(const HTuple& NumLevels, const HTuple& AngleStart, const HTuple& AngleExtent, const HTuple& AngleStep, const HTuple& ScaleRMin, const HTuple& ScaleRMax, const HTuple& ScaleRStep, const HTuple& ScaleCMin, const HTuple& ScaleCMax, const HTuple& ScaleCStep, const HTuple& Optimization, const HTuple& Metric, const HTuple& MinContrast, const HTuple& ParamName, const HTuple& ParamValue) const

void HDeformableModel::CreateLocalDeformableModelXld(const HXLDContArray& Contours, const HTuple& NumLevels, const HTuple& AngleStart, const HTuple& AngleExtent, const HTuple& AngleStep, const HTuple& ScaleRMin, const HTuple& ScaleRMax, const HTuple& ScaleRStep, const HTuple& ScaleCMin, const HTuple& ScaleCMax, const HTuple& ScaleCStep, const HTuple& Optimization, const HTuple& Metric, const HTuple& MinContrast, const HTuple& ParamName, const HTuple& ParamValue)

void CreateLocalDeformableModelXld(const HObject& Contours, const HTuple& NumLevels, const HTuple& AngleStart, const HTuple& AngleExtent, const HTuple& AngleStep, const HTuple& ScaleRMin, const HTuple& ScaleRMax, const HTuple& ScaleRStep, const HTuple& ScaleCMin, const HTuple& ScaleCMax, const HTuple& ScaleCStep, const HTuple& Optimization, const HTuple& Metric, const HTuple& MinContrast, const HTuple& ParamName, const HTuple& ParamValue, HTuple* ModelID)

void HDeformableModel::CreateLocalDeformableModelXld(const HXLDCont& Contours, const HTuple& NumLevels, double AngleStart, double AngleExtent, const HTuple& AngleStep, double ScaleRMin, double ScaleRMax, const HTuple& ScaleRStep, double ScaleCMin, double ScaleCMax, const HTuple& ScaleCStep, const HTuple& Optimization, const HString& Metric, Hlong MinContrast, const HTuple& ParamName, const HTuple& ParamValue)

void HDeformableModel::CreateLocalDeformableModelXld(const HXLDCont& Contours, Hlong NumLevels, double AngleStart, double AngleExtent, double AngleStep, double ScaleRMin, double ScaleRMax, double ScaleRStep, double ScaleCMin, double ScaleCMax, double ScaleCStep, const HString& Optimization, const HString& Metric, Hlong MinContrast, const HTuple& ParamName, const HTuple& ParamValue)

void HDeformableModel::CreateLocalDeformableModelXld(const HXLDCont& Contours, Hlong NumLevels, double AngleStart, double AngleExtent, double AngleStep, double ScaleRMin, double ScaleRMax, double ScaleRStep, double ScaleCMin, double ScaleCMax, double ScaleCStep, const char* Optimization, const char* Metric, Hlong MinContrast, const HTuple& ParamName, const HTuple& ParamValue)

HDeformableModel HXLDCont::CreateLocalDeformableModelXld(const HTuple& NumLevels, double AngleStart, double AngleExtent, const HTuple& AngleStep, double ScaleRMin, double ScaleRMax, const HTuple& ScaleRStep, double ScaleCMin, double ScaleCMax, const HTuple& ScaleCStep, const HTuple& Optimization, const HString& Metric, Hlong MinContrast, const HTuple& ParamName, const HTuple& ParamValue) const

HDeformableModel HXLDCont::CreateLocalDeformableModelXld(Hlong NumLevels, double AngleStart, double AngleExtent, double AngleStep, double ScaleRMin, double ScaleRMax, double ScaleRStep, double ScaleCMin, double ScaleCMax, double ScaleCStep, const HString& Optimization, const HString& Metric, Hlong MinContrast, const HTuple& ParamName, const HTuple& ParamValue) const

HDeformableModel HXLDCont::CreateLocalDeformableModelXld(Hlong NumLevels, double AngleStart, double AngleExtent, double AngleStep, double ScaleRMin, double ScaleRMax, double ScaleRStep, double ScaleCMin, double ScaleCMax, double ScaleCStep, const char* Optimization, const char* Metric, Hlong MinContrast, const HTuple& ParamName, const HTuple& ParamValue) const

void HOperatorSetX.CreateLocalDeformableModelXld(
[in] IHUntypedObjectX* Contours, [in] VARIANT NumLevels, [in] VARIANT AngleStart, [in] VARIANT AngleExtent, [in] VARIANT AngleStep, [in] VARIANT ScaleRMin, [in] VARIANT ScaleRMax, [in] VARIANT ScaleRStep, [in] VARIANT ScaleCMin, [in] VARIANT ScaleCMax, [in] VARIANT ScaleCStep, [in] VARIANT Optimization, [in] VARIANT Metric, [in] VARIANT MinContrast, [in] VARIANT ParamName, [in] VARIANT ParamValue, [out] VARIANT* ModelID)

void HDeformableModelX.CreateLocalDeformableModelXld(
[in] IHXLDContX* Contours, [in] VARIANT NumLevels, [in] double AngleStart, [in] double AngleExtent, [in] VARIANT AngleStep, [in] double ScaleRMin, [in] double ScaleRMax, [in] VARIANT ScaleRStep, [in] double ScaleCMin, [in] double ScaleCMax, [in] VARIANT ScaleCStep, [in] VARIANT Optimization, [in] BSTR Metric, [in] Hlong MinContrast, [in] VARIANT ParamName, [in] VARIANT ParamValue)

IHDeformableModelX* HXLDContX.CreateLocalDeformableModelXld(
[in] VARIANT NumLevels, [in] double AngleStart, [in] double AngleExtent, [in] VARIANT AngleStep, [in] double ScaleRMin, [in] double ScaleRMax, [in] VARIANT ScaleRStep, [in] double ScaleCMin, [in] double ScaleCMax, [in] VARIANT ScaleCStep, [in] VARIANT Optimization, [in] BSTR Metric, [in] Hlong MinContrast, [in] VARIANT ParamName, [in] VARIANT ParamValue)

static void HOperatorSet.CreateLocalDeformableModelXld(HObject contours, HTuple numLevels, HTuple angleStart, HTuple angleExtent, HTuple angleStep, HTuple scaleRMin, HTuple scaleRMax, HTuple scaleRStep, HTuple scaleCMin, HTuple scaleCMax, HTuple scaleCStep, HTuple optimization, HTuple metric, HTuple minContrast, HTuple paramName, HTuple paramValue, out HTuple modelID)

void HDeformableModel.CreateLocalDeformableModelXld(HXLDCont contours, HTuple numLevels, double angleStart, double angleExtent, HTuple angleStep, double scaleRMin, double scaleRMax, HTuple scaleRStep, double scaleCMin, double scaleCMax, HTuple scaleCStep, HTuple optimization, string metric, int minContrast, HTuple paramName, HTuple paramValue)

void HDeformableModel.CreateLocalDeformableModelXld(HXLDCont contours, int numLevels, double angleStart, double angleExtent, double angleStep, double scaleRMin, double scaleRMax, double scaleRStep, double scaleCMin, double scaleCMax, double scaleCStep, string optimization, string metric, int minContrast, HTuple paramName, HTuple paramValue)

HDeformableModel HXLDCont.CreateLocalDeformableModelXld(HTuple numLevels, double angleStart, double angleExtent, HTuple angleStep, double scaleRMin, double scaleRMax, HTuple scaleRStep, double scaleCMin, double scaleCMax, HTuple scaleCStep, HTuple optimization, string metric, int minContrast, HTuple paramName, HTuple paramValue)

HDeformableModel HXLDCont.CreateLocalDeformableModelXld(int numLevels, double angleStart, double angleExtent, double angleStep, double scaleRMin, double scaleRMax, double scaleRStep, double scaleCMin, double scaleCMax, double scaleCStep, string optimization, string metric, int minContrast, HTuple paramName, HTuple paramValue)

Beschreibung

Der Operator create_local_deformable_model_xldcreate_local_deformable_model_xldCreateLocalDeformableModelXldcreate_local_deformable_model_xldCreateLocalDeformableModelXldCreateLocalDeformableModelXld erzeugt ein deformierbares Modell für lokal deformierbares Matching aus XLD Konturen ContoursContoursContoursContoursContourscontours. Die XLD Konturen repräsentieren dabei die Grauwertkanten des zu suchenden Objekts im Bild. Im Gegensatz zu dem Operator create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModel, der ein Modell aus einem Bild erzeugt, erzeugt der Operator create_local_deformable_model_xldcreate_local_deformable_model_xldCreateLocalDeformableModelXldcreate_local_deformable_model_xldCreateLocalDeformableModelXldCreateLocalDeformableModelXld das Formmodell aus XLD Konturen.

Als Ursprung (Referenzpunkt) des Modells wird der Schwerpunkt des kleinsten umschließenden Rechtecks der Konturen ContoursContoursContoursContoursContourscontours verwendet. Falls ein anderer Ursprung gewünscht wird, kann dieser mit set_deformable_model_originset_deformable_model_originSetDeformableModelOriginset_deformable_model_originSetDeformableModelOriginSetDeformableModelOrigin gesetzt werden.

Für eine weitere Erklärung des deformierbaren Modells wie auch seiner Parameter wird auf die Beschreibung in create_planar_uncalib_deformable_modelcreate_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModelcreate_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModel und create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModel verwiesen. Es ist zu beachten, das mit Hilfe von set_local_deformable_model_metricset_local_deformable_model_metricSetLocalDeformableModelMetricset_local_deformable_model_metricSetLocalDeformableModelMetricSetLocalDeformableModelMetric die Metrik des Modells verändert werden kann.

Achtung

Im Gegensatz zum Operator create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModel ist es nicht möglich die Mindestgröße der Modellkomponenten anzugeben. Um kleine Modellkomponenten zu vermeiden, können kurze Konturen vor dem Aufruf von create_local_deformable_model_xldcreate_local_deformable_model_xldCreateLocalDeformableModelXldcreate_local_deformable_model_xldCreateLocalDeformableModelXldCreateLocalDeformableModelXld mit dem Operator select_contours_xldselect_contours_xldSelectContoursXldselect_contours_xldSelectContoursXldSelectContoursXld eliminiert werden.

Parallelisierung

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

ContoursContoursContoursContoursContourscontours (input_object)  xld_cont(-array) → objectHXLDContHXLDContHXLDContHXLDContXHobject

Eingabekonturen, die zum Aufbau des Modells verwendet werden.

NumLevelsNumLevelsNumLevelsNumLevelsNumLevelsnumLevels (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*) (Hlong / BSTR) (Hlong / char*)

Maximale Anzahl von Pyramidenebenen.

Defaultwert: 'auto' "auto" "auto" "auto" "auto" "auto"

Werteliste: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 'auto'"auto""auto""auto""auto""auto"

AngleStartAngleStartAngleStartAngleStartAngleStartangleStart (input_control)  angle.rad → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Kleinste auftretende Rotation des Musters.

Defaultwert: -0.39

Wertevorschläge: -3.14, -1.57, -0.79, -0.39, -0.20, 0.0

AngleExtentAngleExtentAngleExtentAngleExtentAngleExtentangleExtent (input_control)  angle.rad → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Ausdehnung des Winkelbereichs.

Defaultwert: 0.79

Wertevorschläge: 6.29, 3.14, 1.57, 0.79, 0.39

Restriktion: AngleExtent >= 0

AngleStepAngleStepAngleStepAngleStepAngleStepangleStep (input_control)  angle.rad → HTupleHTupleHTupleVARIANTHtuple (real / string) (double / string) (double / HString) (double / char*) (double / BSTR) (double / char*)

Schrittweite der Winkel (Auflösung).

Defaultwert: 'auto' "auto" "auto" "auto" "auto" "auto"

Wertevorschläge: 'auto'"auto""auto""auto""auto""auto", 0.0175, 0.0349, 0.0524, 0.0698, 0.0873

Restriktion: AngleStep > 0 && AngleStep <= pi / 16

ScaleRMinScaleRMinScaleRMinScaleRMinScaleRMinscaleRMin (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Kleinste auftretende Skalierung des Musters in Zeilenrichtung.

Defaultwert: 1.0

Wertevorschläge: 0.5, 0.6, 0.7, 0.8, 0.9, 1.0

Restriktion: ScaleRMin > 0

ScaleRMaxScaleRMaxScaleRMaxScaleRMaxScaleRMaxscaleRMax (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Größte auftretende Skalierung des Musters in Zeilenrichtung.

Defaultwert: 1.0

Wertevorschläge: 1.0, 1.1, 1.2, 1.3, 1.4, 1.5

Restriktion: ScaleRMax >= ScaleRMin

ScaleRStepScaleRStepScaleRStepScaleRStepScaleRStepscaleRStep (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real / string) (double / string) (double / HString) (double / char*) (double / BSTR) (double / char*)

Schrittweite der Skalierung (Auflösung) in Zeilenrichtung.

Defaultwert: 'auto' "auto" "auto" "auto" "auto" "auto"

Wertevorschläge: 'auto'"auto""auto""auto""auto""auto", 0.01, 0.02, 0.05, 0.1, 0.15, 0.2

Restriktion: ScaleRStep > 0

ScaleCMinScaleCMinScaleCMinScaleCMinScaleCMinscaleCMin (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Kleinste auftretende Skalierung des Musters in Spaltenrichtung.

Defaultwert: 1.0

Wertevorschläge: 0.5, 0.6, 0.7, 0.8, 0.9, 1.0

Restriktion: ScaleCMin > 0

ScaleCMaxScaleCMaxScaleCMaxScaleCMaxScaleCMaxscaleCMax (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Größte auftretende Skalierung des Musters in Spaltenrichtung.

Defaultwert: 1.0

Wertevorschläge: 1.0, 1.1, 1.2, 1.3, 1.4, 1.5

Restriktion: ScaleCMax >= ScaleCMin

ScaleCStepScaleCStepScaleCStepScaleCStepScaleCStepscaleCStep (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real / string) (double / string) (double / HString) (double / char*) (double / BSTR) (double / char*)

Schrittweite der Skalierung (Auflösung) in Spaltenrichtung.

Defaultwert: 'auto' "auto" "auto" "auto" "auto" "auto"

Wertevorschläge: 'auto'"auto""auto""auto""auto""auto", 0.01, 0.02, 0.05, 0.1, 0.15, 0.2

Restriktion: ScaleCStep > 0

OptimizationOptimizationOptimizationOptimizationOptimizationoptimization (input_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Art der Optimierung der Modellgenerierung.

Defaultwert: 'auto' "auto" "auto" "auto" "auto" "auto"

Werteliste: 'auto'"auto""auto""auto""auto""auto", 'none'"none""none""none""none""none", 'point_reduction_high'"point_reduction_high""point_reduction_high""point_reduction_high""point_reduction_high""point_reduction_high", 'point_reduction_low'"point_reduction_low""point_reduction_low""point_reduction_low""point_reduction_low""point_reduction_low", 'point_reduction_medium'"point_reduction_medium""point_reduction_medium""point_reduction_medium""point_reduction_medium""point_reduction_medium"

MetricMetricMetricMetricMetricmetric (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Art der zum Matchen verwendeten Metrik.

Defaultwert: 'ignore_local_polarity' "ignore_local_polarity" "ignore_local_polarity" "ignore_local_polarity" "ignore_local_polarity" "ignore_local_polarity"

Werteliste: 'ignore_color_polarity'"ignore_color_polarity""ignore_color_polarity""ignore_color_polarity""ignore_color_polarity""ignore_color_polarity", 'ignore_global_polarity'"ignore_global_polarity""ignore_global_polarity""ignore_global_polarity""ignore_global_polarity""ignore_global_polarity", 'ignore_local_polarity'"ignore_local_polarity""ignore_local_polarity""ignore_local_polarity""ignore_local_polarity""ignore_local_polarity", 'ignore_part_polarity'"ignore_part_polarity""ignore_part_polarity""ignore_part_polarity""ignore_part_polarity""ignore_part_polarity", 'use_polarity'"use_polarity""use_polarity""use_polarity""use_polarity""use_polarity"

MinContrastMinContrastMinContrastMinContrastMinContrastminContrast (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Minimaler Kontrast des Objektes in den Suchbildern.

Defaultwert: 5

Wertevorschläge: 1, 2, 3, 5, 7, 10, 20, 30, 40

ParamNameParamNameParamNameParamNameParamNameparamName (input_control)  string-array → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Namen der Parameter.

Defaultwert: []

Werteliste: [], 'part_size'"part_size""part_size""part_size""part_size""part_size"

ParamValueParamValueParamValueParamValueParamValueparamValue (input_control)  integer-array → HTupleHTupleHTupleVARIANTHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*) (Hlong / double / BSTR) (Hlong / double / char*)

Werte der Parameter.

Defaultwert: []

Werteliste: [], 'big'"big""big""big""big""big", 'medium'"medium""medium""medium""medium""medium", 'small'"small""small""small""small""small"

ModelIDModelIDModelIDModelIDModelIDmodelID (output_control)  deformable_model → HDeformableModel, HTupleHTupleHDeformableModel, HTupleHDeformableModelX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle des Modells.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert create_local_deformable_model_xldcreate_local_deformable_model_xldCreateLocalDeformableModelXldcreate_local_deformable_model_xldCreateLocalDeformableModelXldCreateLocalDeformableModelXld den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt. Wenn der Parameter NumLevelsNumLevelsNumLevelsNumLevelsNumLevelsnumLevels so gewählt wurde, dass das Modell zu wenige Punkte besitzt, wird die Fehlermeldung 8510 zurückgeliefert.

Vorgänger

read_contour_xld_dxfread_contour_xld_dxfReadContourXldDxfread_contour_xld_dxfReadContourXldDxfReadContourXldDxf, edges_sub_pixedges_sub_pixEdgesSubPixedges_sub_pixEdgesSubPixEdgesSubPix, select_contours_xldselect_contours_xldSelectContoursXldselect_contours_xldSelectContoursXldSelectContoursXld

Nachfolger

find_local_deformable_modelfind_local_deformable_modelFindLocalDeformableModelfind_local_deformable_modelFindLocalDeformableModelFindLocalDeformableModel

Siehe auch

create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModel

Modul

Matching

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH