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

find_local_deformable_modelT_find_local_deformable_modelFindLocalDeformableModelfind_local_deformable_modelFindLocalDeformableModelFindLocalDeformableModel (Operator)

Name

find_local_deformable_modelT_find_local_deformable_modelFindLocalDeformableModelfind_local_deformable_modelFindLocalDeformableModelFindLocalDeformableModel — Suche nach den besten Matches eines lokal deformierbaren Modells in einem Bild.

Signatur

find_local_deformable_model(Image : ImageRectified, VectorField, DeformedContours : ModelID, AngleStart, AngleExtent, ScaleRMin, ScaleRMax, ScaleCMin, ScaleCMax, MinScore, NumMatches, MaxOverlap, NumLevels, Greediness, ResultType, ParamName, ParamValue : Score, Row, Column)

Herror T_find_local_deformable_model(const Hobject Image, Hobject* ImageRectified, Hobject* VectorField, Hobject* DeformedContours, const Htuple ModelID, const Htuple AngleStart, const Htuple AngleExtent, const Htuple ScaleRMin, const Htuple ScaleRMax, const Htuple ScaleCMin, const Htuple ScaleCMax, const Htuple MinScore, const Htuple NumMatches, const Htuple MaxOverlap, const Htuple NumLevels, const Htuple Greediness, const Htuple ResultType, const Htuple ParamName, const Htuple ParamValue, Htuple* Score, Htuple* Row, Htuple* Column)

Herror find_local_deformable_model(Hobject Image, Hobject* ImageRectified, Hobject* VectorField, Hobject* DeformedContours, const HTuple& ModelID, const HTuple& AngleStart, const HTuple& AngleExtent, const HTuple& ScaleRMin, const HTuple& ScaleRMax, const HTuple& ScaleCMin, const HTuple& ScaleCMax, const HTuple& MinScore, const HTuple& NumMatches, const HTuple& MaxOverlap, const HTuple& NumLevels, const HTuple& Greediness, const HTuple& ResultType, const HTuple& ParamName, const HTuple& ParamValue, HTuple* Score, HTuple* Row, HTuple* Column)

HImageArray HImage::FindLocalDeformableModel(HImageArray* VectorField, HXLDContArray* DeformedContours, const HDeformableModel& ModelID, const HTuple& AngleStart, const HTuple& AngleExtent, const HTuple& ScaleRMin, const HTuple& ScaleRMax, const HTuple& ScaleCMin, const HTuple& ScaleCMax, const HTuple& MinScore, const HTuple& NumMatches, const HTuple& MaxOverlap, const HTuple& NumLevels, const HTuple& Greediness, const HTuple& ResultType, const HTuple& ParamName, const HTuple& ParamValue, HTuple* Score, HTuple* Row, HTuple* Column) const

HImageArray HDeformableModel::FindLocalDeformableModel(const HImage& Image, HImage* VectorField, HXLDContArray* DeformedContours, const HTuple& AngleStart, const HTuple& AngleExtent, const HTuple& ScaleRMin, const HTuple& ScaleRMax, const HTuple& ScaleCMin, const HTuple& ScaleCMax, const HTuple& MinScore, const HTuple& NumMatches, const HTuple& MaxOverlap, const HTuple& NumLevels, const HTuple& Greediness, const HTuple& ResultType, const HTuple& ParamName, const HTuple& ParamValue, HTuple* Score, HTuple* Row, HTuple* Column) const

void FindLocalDeformableModel(const HObject& Image, HObject* ImageRectified, HObject* VectorField, HObject* DeformedContours, const HTuple& ModelID, const HTuple& AngleStart, const HTuple& AngleExtent, const HTuple& ScaleRMin, const HTuple& ScaleRMax, const HTuple& ScaleCMin, const HTuple& ScaleCMax, const HTuple& MinScore, const HTuple& NumMatches, const HTuple& MaxOverlap, const HTuple& NumLevels, const HTuple& Greediness, const HTuple& ResultType, const HTuple& ParamName, const HTuple& ParamValue, HTuple* Score, HTuple* Row, HTuple* Column)

HImage HDeformableModel::FindLocalDeformableModel(const HImage& Image, HImage* VectorField, HXLDCont* DeformedContours, double AngleStart, double AngleExtent, double ScaleRMin, double ScaleRMax, double ScaleCMin, double ScaleCMax, double MinScore, Hlong NumMatches, double MaxOverlap, Hlong NumLevels, double Greediness, const HTuple& ResultType, const HTuple& ParamName, const HTuple& ParamValue, HTuple* Score, HTuple* Row, HTuple* Column) const

HImage HImage::FindLocalDeformableModel(HImage* VectorField, HXLDCont* DeformedContours, const HDeformableModel& ModelID, double AngleStart, double AngleExtent, double ScaleRMin, double ScaleRMax, double ScaleCMin, double ScaleCMax, double MinScore, Hlong NumMatches, double MaxOverlap, Hlong NumLevels, double Greediness, const HTuple& ResultType, const HTuple& ParamName, const HTuple& ParamValue, HTuple* Score, HTuple* Row, HTuple* Column) const

void HOperatorSetX.FindLocalDeformableModel(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX** ImageRectified, [out] IHUntypedObjectX** VectorField, [out] IHUntypedObjectX** DeformedContours, [in] VARIANT ModelID, [in] VARIANT AngleStart, [in] VARIANT AngleExtent, [in] VARIANT ScaleRMin, [in] VARIANT ScaleRMax, [in] VARIANT ScaleCMin, [in] VARIANT ScaleCMax, [in] VARIANT MinScore, [in] VARIANT NumMatches, [in] VARIANT MaxOverlap, [in] VARIANT NumLevels, [in] VARIANT Greediness, [in] VARIANT ResultType, [in] VARIANT ParamName, [in] VARIANT ParamValue, [out] VARIANT* Score, [out] VARIANT* Row, [out] VARIANT* Column)

IHImageX* HDeformableModelX.FindLocalDeformableModel(
[in] IHImageX* Image, [out] IHImageX** VectorField, [out] IHXLDContX** DeformedContours, [in] double AngleStart, [in] double AngleExtent, [in] double ScaleRMin, [in] double ScaleRMax, [in] double ScaleCMin, [in] double ScaleCMax, [in] double MinScore, [in] Hlong NumMatches, [in] double MaxOverlap, [in] Hlong NumLevels, [in] double Greediness, [in] VARIANT ResultType, [in] VARIANT ParamName, [in] VARIANT ParamValue, [out] VARIANT* Score, [out] VARIANT* Row, [out] VARIANT* Column)

IHImageX* HImageX.FindLocalDeformableModel(
[out] IHImageX** VectorField, [out] IHXLDContX** DeformedContours, [in] IHDeformableModelX* ModelID, [in] double AngleStart, [in] double AngleExtent, [in] double ScaleRMin, [in] double ScaleRMax, [in] double ScaleCMin, [in] double ScaleCMax, [in] double MinScore, [in] Hlong NumMatches, [in] double MaxOverlap, [in] Hlong NumLevels, [in] double Greediness, [in] VARIANT ResultType, [in] VARIANT ParamName, [in] VARIANT ParamValue, [out] VARIANT* Score, [out] VARIANT* Row, [out] VARIANT* Column)

static void HOperatorSet.FindLocalDeformableModel(HObject image, out HObject imageRectified, out HObject vectorField, out HObject deformedContours, HTuple modelID, HTuple angleStart, HTuple angleExtent, HTuple scaleRMin, HTuple scaleRMax, HTuple scaleCMin, HTuple scaleCMax, HTuple minScore, HTuple numMatches, HTuple maxOverlap, HTuple numLevels, HTuple greediness, HTuple resultType, HTuple paramName, HTuple paramValue, out HTuple score, out HTuple row, out HTuple column)

HImage HDeformableModel.FindLocalDeformableModel(HImage image, out HImage vectorField, out HXLDCont deformedContours, double angleStart, double angleExtent, double scaleRMin, double scaleRMax, double scaleCMin, double scaleCMax, double minScore, int numMatches, double maxOverlap, int numLevels, double greediness, HTuple resultType, HTuple paramName, HTuple paramValue, out HTuple score, out HTuple row, out HTuple column)

HImage HImage.FindLocalDeformableModel(out HImage vectorField, out HXLDCont deformedContours, HDeformableModel modelID, double angleStart, double angleExtent, double scaleRMin, double scaleRMax, double scaleCMin, double scaleCMax, double minScore, int numMatches, double maxOverlap, int numLevels, double greediness, HTuple resultType, HTuple paramName, HTuple paramValue, out HTuple score, out HTuple row, out HTuple column)

Beschreibung

Der Operator find_local_deformable_modelfind_local_deformable_modelFindLocalDeformableModelfind_local_deformable_modelFindLocalDeformableModelFindLocalDeformableModel sucht die besten NumMatchesNumMatchesNumMatchesNumMatchesNumMatchesnumMatches Instanzes eines lokal deformierbaren Modells ModelIDModelIDModelIDModelIDModelIDmodelID in dem Suchbild ImageImageImageImageImageimage. Die Modelle müssen vorher durch create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModel oder read_deformable_modelread_deformable_modelReadDeformableModelread_deformable_modelReadDeformableModelReadDeformableModel erzeugt worden sein. Der Operator find_local_deformable_modelfind_local_deformable_modelFindLocalDeformableModelfind_local_deformable_modelFindLocalDeformableModelFindLocalDeformableModel gibt die Zeilen RowRowRowRowRowrow und Spalten ColumnColumnColumnColumnColumncolumn der Koordinaten einer gefundenen Instanz zurück.

Zusätzlich kann ein rektifizierter Teil des Bildes, das entsprechende Vektorfeld und die Konturen der gefundenen deformierten Modellinstanz in ImageRectifiedImageRectifiedImageRectifiedImageRectifiedImageRectifiedimageRectified, VectorFieldVectorFieldVectorFieldVectorFieldVectorFieldvectorField und DeformedContoursDeformedContoursDeformedContoursDeformedContoursDeformedContoursdeformedContours zurückgegeben werden. Die Voreinstellung ist, dass diese ikonischen Objekte nicht zurückgegeben werden. In dem Fall das sie gebraucht werden muss der Parameter ResultTypeResultTypeResultTypeResultTypeResultTyperesultType auf 'image_rectified', 'vector_field' und 'deformed_contours' gesetzt werden. Die Größe von ImageRectifiedImageRectifiedImageRectifiedImageRectifiedImageRectifiedimageRectified und VectorFieldVectorFieldVectorFieldVectorFieldVectorFieldvectorField ist das kleinste achsenparallele Rechteck der ROI des Bildes, das verwendet wurde um das lokal deformierbare Model mit create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModel zu erzeugen. Die Größe des rektifizierten Bildes und des Vektorfeldes kann in alle Richtungen durch setzen von ParamNameParamNameParamNameParamNameParamNameparamName auf 'expand_border' und des entsprechenden ParamValueParamValueParamValueParamValueParamValueparamValue (die Anzahl Pixel) vergrößert werden. Optional kann auch eine spezifische Richtung durch 'expand_border_top', 'expand_border_bottom', 'expand_border_left' und 'expand_border_right' gesetzt werden. Es ist zu beachten, dass das VectorFieldVectorFieldVectorFieldVectorFieldVectorFieldvectorField vom semantischen Typ 'vector_field_absolute' ist und damit in absoluten Koordinaten angegeben ist, und convert_map_typeconvert_map_typeConvertMapTypeconvert_map_typeConvertMapTypeConvertMapType übergeben werden kann.

Die Glattheit der geschätzten Deformation kann durch setzen von ParamNameParamNameParamNameParamNameParamNameparamName auf 'deformation_smoothness' angegeben werden. Der Wert für 'deformation_smoothness' kann als Größe eines Glättungsfilters der auf das Deformationsfeld angewendet wird, verstanden werden. Ein sehr kleiner Wert erwartet eine starke Deformation, ein sehr großer Wert ein rigides Objekt. Der minimale Wert für 'deformation_smoothness' ist 3, ein typischer Wert ist 11. Für Fälle in denen nur sehr kleine globale Deformationen erwartet werden, sollte der Wert weiter erhöht werden.

Zusätzlich wird in ScoreScoreScoreScoreScorescore die Bewertung der gefundenen Instanzen zurückgegeben. Die Bewertung ist eine Zahl zwischen 0 und 1 und ist ein ungefähres Maß dafür, welcher Anteil des Modells im Bild zu sehen ist.

Für eine weitere Erklärung des deformierbaren Modells und seiner Parameter sei auf die Beschreibung in find_planar_uncalib_deformable_modelfind_planar_uncalib_deformable_modelFindPlanarUncalibDeformableModelfind_planar_uncalib_deformable_modelFindPlanarUncalibDeformableModelFindPlanarUncalibDeformableModel verwiesen.

Parallelisierung

Parameter

ImageImageImageImageImageimage (input_object)  (multichannel-)image → objectHImageHImageHImageHImageXHobject (byte / uint2)

Eingabebild, in dem das Modell gefunden werden soll.

ImageRectifiedImageRectifiedImageRectifiedImageRectifiedImageRectifiedimageRectified (output_object)  (multichannel-)image(-array) → objectHImageHImageHImageHImageXHobject * (byte / uint2)

Rektifizierter Bildausschnitt.

VectorFieldVectorFieldVectorFieldVectorFieldVectorFieldvectorField (output_object)  singlechannelimage(-array) → objectHImageHImageHImageHImageXHobject * (vector_field)

Vektorfeld des gefundenen Modells.

DeformedContoursDeformedContoursDeformedContoursDeformedContoursDeformedContoursdeformedContours (output_object)  xld_cont-array → objectHXLDContHXLDContHXLDContArrayHXLDContXHobject *

Die deformierten Konturen des gefundenen Modells.

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

Handle des Modells.

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

Kleinste auftretende Rotation des Modells.

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, 0.0

Restriktion: AngleExtent >= 0

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

Kleinste auftretende Skalierung des Modells 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 Modells in Zeilenrichtung.

Defaultwert: 1.0

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

Restriktion: ScaleRMax >= ScaleRMin

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

Kleinste auftretende Skalierung des Modells 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 Modells in Spaltenrichtung.

Defaultwert: 1.0

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

Restriktion: ScaleCMax >= ScaleCMin

MinScoreMinScoreMinScoreMinScoreMinScoreminScore (input_control)  real → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Minimale Bewertung der zu findenden Instanzen des Modells.

Defaultwert: 0.5

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

Typischer Wertebereich: 0 ≤ MinScore MinScore MinScore MinScore MinScore minScore ≤ 1

Minimale Schrittweite: 0.01

Empfohlene Schrittweite: 0.05

NumMatchesNumMatchesNumMatchesNumMatchesNumMatchesnumMatches (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Anzahl der zu findenden Instanzen des Modells (oder 0 für alle Treffer).

Defaultwert: 1

Wertevorschläge: 0, 1, 2, 3, 4, 5, 10, 20

MaxOverlapMaxOverlapMaxOverlapMaxOverlapMaxOverlapmaxOverlap (input_control)  real → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Maximale Überlappung der zu findenden Instanzen des Modells.

Defaultwert: 1.0

Wertevorschläge: 0.0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0

Typischer Wertebereich: 0 ≤ MaxOverlap MaxOverlap MaxOverlap MaxOverlap MaxOverlap maxOverlap ≤ 1

Minimale Schrittweite: 0.01

Empfohlene Schrittweite: 0.05

NumLevelsNumLevelsNumLevelsNumLevelsNumLevelsnumLevels (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Anzahl der verwendeten Pyramidenebenen.

Defaultwert: 0

Werteliste: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

GreedinessGreedinessGreedinessGreedinessGreedinessgreediness (input_control)  real → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

„Gierigkeit“ der Suchheuristik (0: sicher aber langsam; 1: schnell aber Matches können „übersehen“ werden).

Defaultwert: 0.9

Wertevorschläge: 0.0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0

Typischer Wertebereich: 0 ≤ Greediness Greediness Greediness Greediness Greediness greediness ≤ 1

Minimale Schrittweite: 0.01

Empfohlene Schrittweite: 0.05

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

Die zu berechnenden ikonischen Ergebnisse.

Defaultwert: []

Werteliste: [], 'deformed_contours'"deformed_contours""deformed_contours""deformed_contours""deformed_contours""deformed_contours", 'image_rectified'"image_rectified""image_rectified""image_rectified""image_rectified""image_rectified", 'vector_field'"vector_field""vector_field""vector_field""vector_field""vector_field"

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

Namen der generischen Parameter.

Defaultwert: []

Werteliste: [], 'angle_step'"angle_step""angle_step""angle_step""angle_step""angle_step", 'deformation_smoothness'"deformation_smoothness""deformation_smoothness""deformation_smoothness""deformation_smoothness""deformation_smoothness", 'expand_border'"expand_border""expand_border""expand_border""expand_border""expand_border", 'expand_border_bottom'"expand_border_bottom""expand_border_bottom""expand_border_bottom""expand_border_bottom""expand_border_bottom", 'expand_border_left'"expand_border_left""expand_border_left""expand_border_left""expand_border_left""expand_border_left", 'expand_border_right'"expand_border_right""expand_border_right""expand_border_right""expand_border_right""expand_border_right", 'expand_border_top'"expand_border_top""expand_border_top""expand_border_top""expand_border_top""expand_border_top", 'scale_c_step'"scale_c_step""scale_c_step""scale_c_step""scale_c_step""scale_c_step", 'scale_r_step'"scale_r_step""scale_r_step""scale_r_step""scale_r_step""scale_r_step", 'subpixel'"subpixel""subpixel""subpixel""subpixel""subpixel"

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 generischen Parameter.

Defaultwert: []

Werteliste: [], 'least_squares'"least_squares""least_squares""least_squares""least_squares""least_squares", 'least_squares_high'"least_squares_high""least_squares_high""least_squares_high""least_squares_high""least_squares_high", 'least_squares_very_high'"least_squares_very_high""least_squares_very_high""least_squares_very_high""least_squares_very_high""least_squares_very_high", 'none'"none""none""none""none""none"

ScoreScoreScoreScoreScorescore (output_control)  real-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Bewertung der gefundenen Instanzen des Modells.

RowRowRowRowRowrow (output_control)  real-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Zeilenkoordinate des gefundenen Modells.

ColumnColumnColumnColumnColumncolumn (output_control)  real-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Spaltenkoordinate des gefundenen Modells.

Ergebnis

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

Vorgänger

create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModel, create_local_deformable_model_xldcreate_local_deformable_model_xldCreateLocalDeformableModelXldcreate_local_deformable_model_xldCreateLocalDeformableModelXldCreateLocalDeformableModelXld, read_deformable_modelread_deformable_modelReadDeformableModelread_deformable_modelReadDeformableModelReadDeformableModel

Modul

Matching

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