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_modelFindGenericShapeModelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model findet die besten Instanzen eines oder mehrerer Formmodelle, die in ModelIDModelIDModelIDModelIDmodelIDmodel_id übergeben werden, im Eingabebild SearchImageSearchImageSearchImageSearchImagesearchImagesearch_image. Die gefundenen Matches werden in MatchResultIDMatchResultIDMatchResultIDMatchResultIDmatchResultIDmatch_result_id zurückgegeben und können mit get_generic_shape_model_resultget_generic_shape_model_resultGetGenericShapeModelResultGetGenericShapeModelResultGetGenericShapeModelResultget_generic_shape_model_result und get_generic_shape_model_result_objectget_generic_shape_model_result_objectGetGenericShapeModelResultObjectGetGenericShapeModelResultObjectGetGenericShapeModelResultObjectget_generic_shape_model_result_object abgefragt werden. Die Anzahl gefundener Matches wird in NumMatchResultNumMatchResultNumMatchResultNumMatchResultnumMatchResultnum_match_result zurückgegeben. Das Modell kann mit set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param und set_generic_shape_model_objectset_generic_shape_model_objectSetGenericShapeModelObjectSetGenericShapeModelObjectSetGenericShapeModelObjectset_generic_shape_model_object parametrisiert werden, wodurch der Suchvorgang gesteuert werden kann.

Die Domäne des Eingabebildes SearchImageSearchImageSearchImageSearchImagesearchImagesearch_image bestimmt die ROI für die Suche. Sie schränkt den Suchbereich ein, da sie als Begrenzung für den Schwerpunkt des Modells ModelIDModelIDModelIDModelIDmodelIDmodel_id gilt, wodurch der Matching-Vorgang beschleunigt wird. Für Informationen zum Übergeben von Bild-Tupeln an SearchImageSearchImageSearchImageSearchImagesearchImagesearch_image siehe unten. Desweiteren ist der Suchbereich durch die Größe von SearchImageSearchImageSearchImageSearchImagesearchImagesearch_image begrenzt. Standardmäßig wird ModelIDModelIDModelIDModelIDmodelIDmodel_id nur an den Stellen der Domäne gesucht an denen ModelIDModelIDModelIDModelIDmodelIDmodel_id komplett hineinpasst. Dementsprechend wird ModelIDModelIDModelIDModelIDmodelIDmodel_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 ModelIDModelIDModelIDModelIDmodelIDmodel_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 ModelIDModelIDModelIDModelIDmodelIDmodel_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""border_shape_models" geändert werden, siehe set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamSetGenericShapeModelParamset_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 SearchImageSearchImageSearchImageSearchImagesearchImagesearch_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 ModelIDModelIDModelIDModelIDmodelIDmodel_id. In diesem Fall müssen die Bilder, abgesehen von deren Domänen, identisch sein. Werden mehrere Modelle angewendet, müssen diese unterschiedliche Identifikatoren ('model_identifier'"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).
• Wird ohne Parallelisierung verarbeitet.

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 modifiziert den Zustand des folgenden Eingabeparameters:

• ModelIDModelIDModelIDModelIDmodelIDmodel_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_modelFindGenericShapeModelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model den Wert TRUE. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

train_generic_shape_modeltrain_generic_shape_modelTrainGenericShapeModelTrainGenericShapeModelTrainGenericShapeModeltrain_generic_shape_model, set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param

Modul

Matching