find_generic_shape_modelT_find_generic_shape_modelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model (Operator)

Name

find_generic_shape_modelT_find_generic_shape_modelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model — Suche der besten Matches eines oder mehrerer Formmodelle in einem Bild.

Signatur

Beschreibung

Der Operator find_generic_shape_modelfind_generic_shape_modelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model findet die besten Instanzen eines oder mehrerer Formmodelle, die in ModelIDModelIDModelIDmodelIDmodel_id übergeben werden, im Eingabebild SearchImageSearchImageSearchImagesearchImagesearch_image. Die gefundenen Matches werden in MatchResultIDMatchResultIDMatchResultIDmatchResultIDmatch_result_id zurückgegeben und können mit get_generic_shape_model_resultget_generic_shape_model_resultGetGenericShapeModelResultGetGenericShapeModelResultget_generic_shape_model_result und get_generic_shape_model_result_objectget_generic_shape_model_result_objectGetGenericShapeModelResultObjectGetGenericShapeModelResultObjectget_generic_shape_model_result_object abgefragt werden. Die Anzahl gefundener Matches wird in NumMatchResultNumMatchResultNumMatchResultnumMatchResultnum_match_result zurückgegeben. Das Modell kann mit set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param und set_generic_shape_model_objectset_generic_shape_model_objectSetGenericShapeModelObjectSetGenericShapeModelObjectset_generic_shape_model_object parametrisiert werden, wodurch der Suchvorgang gesteuert werden kann.

Die Domäne des Eingabebildes SearchImageSearchImageSearchImagesearchImagesearch_image bestimmt die ROI für die Suche. Sie schränkt den Suchbereich ein, da sie als Begrenzung für den Schwerpunkt des Modells ModelIDModelIDModelIDmodelIDmodel_id gilt, wodurch der Matching-Vorgang beschleunigt wird. Für Informationen zum Übergeben von Bild-Tupeln an SearchImageSearchImageSearchImagesearchImagesearch_image siehe unten. Desweiteren ist der Suchbereich durch die Größe von SearchImageSearchImageSearchImagesearchImagesearch_image begrenzt. Standardmäßig wird ModelIDModelIDModelIDmodelIDmodel_id nur an den Stellen der Domäne gesucht an denen ModelIDModelIDModelIDmodelIDmodel_id komplett hineinpasst. Dementsprechend wird ModelIDModelIDModelIDmodelIDmodel_id nicht gefunden wenn es über den Bildrand hinausragt. Dies gilt für alle Stufen der Bildpyramide.

In seltenen Fällen, welche typischerweise in künstlich erzeugten Bildern auftreten, können Instanzen von ModelIDModelIDModelIDmodelIDmodel_id nicht im Bild gefunden werden wenn sie den Rand der Domäne auf irgendeiner Stufe der Bildpyramide berühren. Als Daumenregel kann man annehmen, dass ModelIDModelIDModelIDmodelIDmodel_id nicht gefunden werden könnte wenn dessen Entfernung zum Bildrand kleiner als Pixel ist (wobei für die Anzahl an Pyramidenstufen steht). Dieses Verhalten kann mittels 'border_shape_models'"border_shape_models""border_shape_models""border_shape_models""border_shape_models" geändert werden, siehe set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param.

Werden mehrere Modelle gesucht, dann kann der Suchbereich für alle Modelle gleichzeitig eingeschränkt werden indem ein einzelnes Bild mit reduzierter Domäne in SearchImageSearchImageSearchImagesearchImagesearch_image übergeben wird.

Alternativ kann der Suchbereich auch für jedes Modell individuell eingeschränkt werden indem ein Objekt mit mehreren Bildobjekten übergeben wird, eins für jedes Modell in ModelIDModelIDModelIDmodelIDmodel_id. Der Suchbereich wird dann jeweils über die Domäne des entsprechenden Bildes bestimmt. Abgesehen von der Domäne müssen die Bilder gleich sein, d.h., die Pointer der einzelnen Bilder müssen das gleiche Bild referenzieren und somit identisch sein. Siehe get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1get_image_pointer1 zum Überprüfen der Pointer.

Werden mehrere Modelle angewendet, müssen diese unterschiedliche Identifikatoren ('model_identifier'"model_identifier""model_identifier""model_identifier""model_identifier") aufweisen. Dadurch kann jede gefundene Instanz dem entsprechenden Formmodell mit dem es gefunden wurde zugeordnet werden. Ist dies nicht der Fall wird eine Fehlerbehandlung durchgeführt.

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.

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.

Dieser Operator unterstützt Cancel-Timeouts und Interrupts.

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

• ModelIDModelIDModelIDmodelIDmodel_id

Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.

Parameter

Ergebnis

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

Vorgänger

train_generic_shape_modeltrain_generic_shape_modelTrainGenericShapeModelTrainGenericShapeModeltrain_generic_shape_model, set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param

Modul

Matching