find_local_deformable_modelT_find_local_deformable_modelFindLocalDeformableModelFindLocalDeformableModelfind_local_deformable_model (Operator)

Name

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

Signatur

Beschreibung

Der Operator find_local_deformable_modelfind_local_deformable_modelFindLocalDeformableModelFindLocalDeformableModelFindLocalDeformableModelfind_local_deformable_model sucht die besten NumMatchesNumMatchesNumMatchesNumMatchesnumMatchesnum_matches Instanzen eines lokal deformierbaren Modells ModelIDModelIDModelIDModelIDmodelIDmodel_id in dem Suchbild ImageImageImageImageimageimage. Die Modelle müssen vorher durch create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModelCreateLocalDeformableModelcreate_local_deformable_model oder read_deformable_modelread_deformable_modelReadDeformableModelReadDeformableModelReadDeformableModelread_deformable_model erzeugt worden sein.

Im Normalfall wird das Modell innerhalb des Definitionsbereiches des Eingabebildes nur an den Stellen gesucht, an denen das Modell vollständig in das Bild passt. Das bedeutet, dass das Modell nicht gefunden werden kann, wenn es aus dem Bild herausragt, selbst wenn es eine Bewertung größer als MinScoreMinScoreMinScoreMinScoreminScoremin_score erreichen würde. Außerdem kann es sein, dass das Modell, wenn es in einer der Pyramidenebenen den Bildrand berührt, ebenfalls nicht gefunden wird, auch wenn es im ursprünglichen Bild vollständig enthalten ist. Als Daumenregel gilt hier, dass das Modell dann nicht gefunden werden könnte, wenn seine Distanz zum Bildrand unter fällt. Dieses Verhalten kann mit set_system('border_shape_models','true')set_system("border_shape_models","true")SetSystem("border_shape_models","true")SetSystem("border_shape_models","true")SetSystem("border_shape_models","true")set_system("border_shape_models","true") umgestellt werden, so dass auch Modelle gefunden werden, die aus dem Bild herausragen, falls sie eine Bewertung größer als MinScoreMinScoreMinScoreMinScoreminScoremin_score erreichen. Dabei werden Punkte außerhalb des Bildes als verdeckt angesehen, d.h. sie verringern die Bewertung. Es ist zu beachten, dass dieser Modus die Laufzeit der Suche erhöht. Es ist weiter zu beachten, dass in seltenen Fällen, die typischerweise nur in künstlichen Bildern auftreten, auch dann kein Modell gefunden wird, wenn das Modell in einer Pyramidenebene die reduzierte Bilddomäne berührt. In diesem Fall kann es helfen, die Region der Domäne um , z.B., mit dilation_circledilation_circleDilationCircleDilationCircleDilationCircledilation_circle zu vergrößern.

Der Operator find_local_deformable_modelfind_local_deformable_modelFindLocalDeformableModelFindLocalDeformableModelFindLocalDeformableModelfind_local_deformable_model 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 ImageRectifiedImageRectifiedImageRectifiedImageRectifiedimageRectifiedimage_rectified, VectorFieldVectorFieldVectorFieldVectorFieldvectorFieldvector_field und DeformedContoursDeformedContoursDeformedContoursDeformedContoursdeformedContoursdeformed_contours zurückgegeben werden. Die Voreinstellung ist, dass diese ikonischen Objekte nicht zurückgegeben werden. In dem Fall das sie gebraucht werden muss der Parameter ResultTypeResultTypeResultTypeResultTyperesultTyperesult_type auf 'image_rectified', 'vector_field' und 'deformed_contours' gesetzt werden. Die Größe von ImageRectifiedImageRectifiedImageRectifiedImageRectifiedimageRectifiedimage_rectified und VectorFieldVectorFieldVectorFieldVectorFieldvectorFieldvector_field ist das kleinste achsenparallele Rechteck der ROI des Bildes, das verwendet wurde um das lokal deformierbare Model mit create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModelCreateLocalDeformableModelcreate_local_deformable_model zu erzeugen. Die Größe des rektifizierten Bildes und des Vektorfeldes kann in alle Richtungen durch setzen von GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name auf 'expand_border' und des entsprechenden GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (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 VectorFieldVectorFieldVectorFieldVectorFieldvectorFieldvector_field vom semantischen Typ 'vector_field_absolute' ist und damit in absoluten Koordinaten angegeben ist, und convert_map_typeconvert_map_typeConvertMapTypeConvertMapTypeConvertMapTypeconvert_map_type übergeben werden kann.

Die Glattheit der geschätzten Deformation kann durch setzen von GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name 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_modelFindPlanarUncalibDeformableModelFindPlanarUncalibDeformableModelFindPlanarUncalibDeformableModelfind_planar_uncalib_deformable_model verwiesen.

Ausführungsinformationen

• 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

Ergebnis

Sind die Parameterwerte korrekt, dann liefert find_local_deformable_modelfind_local_deformable_modelFindLocalDeformableModelFindLocalDeformableModelFindLocalDeformableModelfind_local_deformable_model den Wert TRUE. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModelCreateLocalDeformableModelcreate_local_deformable_model, create_local_deformable_model_xldcreate_local_deformable_model_xldCreateLocalDeformableModelXldCreateLocalDeformableModelXldCreateLocalDeformableModelXldcreate_local_deformable_model_xld, read_deformable_modelread_deformable_modelReadDeformableModelReadDeformableModelReadDeformableModelread_deformable_model

Modul

Matching