get_found_component_modelT_get_found_component_modelGetFoundComponentModelGetFoundComponentModel (Operator)

Name

get_found_component_modelT_get_found_component_modelGetFoundComponentModelGetFoundComponentModel — Liefert die Komponenten einer gefundenen Instanz eines Komponentenmodells zurück.

Signatur

Beschreibung

get_found_component_modelget_found_component_modelGetFoundComponentModelGetFoundComponentModelGetFoundComponentModel liefert die Komponenten einer gefundenen Instanz des Komponentenmodells ComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID sowohl in Form von Konturregionen in FoundComponentsFoundComponentsFoundComponentsFoundComponentsfoundComponents als auch in numerischer Form zurück.

Der Operator get_found_component_modelget_found_component_modelGetFoundComponentModelGetFoundComponentModelGetFoundComponentModel kann dazu genutzt werden, das Ergebnis der mit find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel erhaltenen Matches zu visualisieren.

Die Lage der zurückgelieferten Komponenten entspricht deren Lage im Suchbild, wie sie mit find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel erhalten wurde. Daher müssen die Parameter ModelStartModelStartModelStartModelStartmodelStart, ModelEndModelEndModelEndModelEndmodelEnd, RowCompRowCompRowCompRowComprowComp, ColumnCompColumnCompColumnCompColumnCompcolumnComp, AngleCompAngleCompAngleCompAngleCompangleComp, ScoreCompScoreCompScoreCompScoreCompscoreComp und ModelCompModelCompModelCompModelCompmodelComp an get_found_component_modelget_found_component_modelGetFoundComponentModelGetFoundComponentModelGetFoundComponentModel so übergeben werden wie sie von find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel zurückgeliefert worden sind. In ModelMatchModelMatchModelMatchModelMatchmodelMatch muss der Index der gefunden Instanz des Komponentenmodells übergeben werden. ModelMatchModelMatchModelMatchModelMatchmodelMatch muss somit zwischen 0 und m-1 liegen, wobei m gleich der Anzahl an Elemente in den Parametern ModelStartModelStartModelStartModelStartmodelStart und ModelEndModelEndModelEndModelEndmodelEnd ist und somit der Anzahl der gefundenen Instanzen entspricht. Soll zum Beispiel der beste aller gefundenen Matches zurückgeliefert werden, so muss ModelMatchModelMatchModelMatchModelMatchmodelMatch auf 0 gesetzt werden.

Bei rotationssymmetrischen Komponenten kann es darüber hinaus hilfreich sein, deren Orientierung zu markieren. Dies kann erreicht werden, indem MarkOrientationMarkOrientationMarkOrientationMarkOrientationmarkOrientation auf 'true'"true""true""true""true" gesetzt wird. In diesem Fall wird die Konturregion der jeweiligen Komponente an ihrem Referenzpunkt durch einen Pfeil ergänzt, der in die Referenzrichtung zeigt. Die Referenzrichtung einer Komponente ergibt sich aus deren Orientierung im Modellbild (siehe train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents oder create_component_modelcreate_component_modelCreateComponentModelCreateComponentModelCreateComponentModel) und wird beschrieben durch einen vom Referenzpunkt horizontal nach rechts zeigenden Pfeil.

Zur Vereinfachung werden sowohl die Lageparameter jeder Komponente als auch deren Bewertung (Score) der gefunden Instanz zusätzlich in numerischer Form in RowCompInstRowCompInstRowCompInstRowCompInstrowCompInst, ColumnCompInstColumnCompInstColumnCompInstColumnCompInstcolumnCompInst, AngleCompInstAngleCompInstAngleCompInstAngleCompInstangleCompInst und ScoreCompInstScoreCompInstScoreCompInstScoreCompInstscoreCompInst zurückgegeben. Diese vier Tupel haben immer die Länge n, wobei n die Anzahl der Komponenten im Komponentenmodell ComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID beschreibt. Konnte während der Suche eine Komponente nicht gefunden werden, so wird im entsprechenden Element in FoundComponentsFoundComponentsFoundComponentsFoundComponentsfoundComponents eine leere Region zurückgeliefert und der Wert des entsprechenden Elements in RowCompInstRowCompInstRowCompInstRowCompInstrowCompInst, ColumnCompInstColumnCompInstColumnCompInstColumnCompInstcolumnCompInst, AngleCompInstAngleCompInstAngleCompInstAngleCompInstangleCompInst und ScoreCompInstScoreCompInstScoreCompInstScoreCompInstscoreCompInst auf 0 gesetzt.

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.

Parameter

Beispiel (HDevelop)

* Read a component model from file.
read_component_model ('pliers.cpm', ComponentModelID)
* Find the component model in a run-time image.
read_image (SearchImage, 'search_image.tif')
find_component_model (SearchImage, ComponentModelID, RootRanking, 0, \
                      rad(360), 0.5, 0, 0.5, 'stop_search', 'prune_branch', \
                      'none', 0.8, 'least_squares', 0, 0.8, ModelStart, \
                      ModelEnd, Score, RowComp, ColumnComp, AngleComp, \
                      ScoreComp, ModelComp)
* Visualize the found instances.
for i := 0 to |ModelStart|-1 by 1
    get_found_component_model (FoundComponents, ComponentModelID, \
                               ModelStart, ModelEnd, RowComp, ColumnComp, \
                               AngleComp, ScoreComp, ModelComp, i, 'false', \
                               RowCompInst, ColumnCompInst, AngleCompInst, \
                               ScoreCompInst)
    dev_display (FoundComponents)
endfor

Ergebnis

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

Vorgänger

find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel

Siehe auch

train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents, create_component_modelcreate_component_modelCreateComponentModelCreateComponentModelCreateComponentModel

Modul

Matching