get_found_component_modelget_found_component_modelGetFoundComponentModelget_found_component_modelGetFoundComponentModelGetFoundComponentModel (Operator)

Name

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

Signatur

Beschreibung

get_found_component_modelget_found_component_modelGetFoundComponentModelget_found_component_modelGetFoundComponentModelGetFoundComponentModel liefert die Komponenten einer gefundenen Instanz des Komponentenmodells ComponentModelIDComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID sowohl in Form von Konturregionen in FoundComponentsFoundComponentsFoundComponentsFoundComponentsFoundComponentsfoundComponents als auch in numerischer Form zurück.

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

Die Lage der zurückgelieferten Komponenten entspricht deren Lage im Suchbild, wie sie mit find_component_modelfind_component_modelFindComponentModelfind_component_modelFindComponentModelFindComponentModel erhalten wurde. Daher müssen die Parameter ModelStartModelStartModelStartModelStartModelStartmodelStart, ModelEndModelEndModelEndModelEndModelEndmodelEnd, RowCompRowCompRowCompRowCompRowComprowComp, ColumnCompColumnCompColumnCompColumnCompColumnCompcolumnComp, AngleCompAngleCompAngleCompAngleCompAngleCompangleComp, ScoreCompScoreCompScoreCompScoreCompScoreCompscoreComp und ModelCompModelCompModelCompModelCompModelCompmodelComp an get_found_component_modelget_found_component_modelGetFoundComponentModelget_found_component_modelGetFoundComponentModelGetFoundComponentModel so übergeben werden wie sie von find_component_modelfind_component_modelFindComponentModelfind_component_modelFindComponentModelFindComponentModel zurückgeliefert worden sind. In ModelMatchModelMatchModelMatchModelMatchModelMatchmodelMatch muss der Index der gefunden Instanz des Komponentenmodells übergeben werden. ModelMatchModelMatchModelMatchModelMatchModelMatchmodelMatch muss somit zwischen 0 und m-1 liegen, wobei m gleich der Anzahl an Elemente in den Parametern ModelStartModelStartModelStartModelStartModelStartmodelStart und ModelEndModelEndModelEndModelEndModelEndmodelEnd ist und somit der Anzahl der gefundenen Instanzen entspricht. Soll zum Beispiel der beste aller gefundenen Matches zurückgeliefert werden, so muss ModelMatchModelMatchModelMatchModelMatchModelMatchmodelMatch auf 0 gesetzt werden.

Bei rotationssymmetrischen Komponenten kann es darüber hinaus hilfreich sein, deren Orientierung zu markieren. Dies kann erreicht werden, indem MarkOrientationMarkOrientationMarkOrientationMarkOrientationMarkOrientationmarkOrientation auf 'true'"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_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents oder create_component_modelcreate_component_modelCreateComponentModelcreate_component_modelCreateComponentModelCreateComponentModel) 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 RowCompInstRowCompInstRowCompInstRowCompInstRowCompInstrowCompInst, ColumnCompInstColumnCompInstColumnCompInstColumnCompInstColumnCompInstcolumnCompInst, AngleCompInstAngleCompInstAngleCompInstAngleCompInstAngleCompInstangleCompInst und ScoreCompInstScoreCompInstScoreCompInstScoreCompInstScoreCompInstscoreCompInst zurückgegeben. Diese vier Tupel haben immer die Länge n, wobei n die Anzahl der Komponenten im Komponentenmodell ComponentModelIDComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID beschreibt. Konnte während der Suche eine Komponente nicht gefunden werden, so wird im entsprechenden Element in FoundComponentsFoundComponentsFoundComponentsFoundComponentsFoundComponentsfoundComponents eine leere Region zurückgeliefert und der Wert des entsprechenden Elements in RowCompInstRowCompInstRowCompInstRowCompInstRowCompInstrowCompInst, ColumnCompInstColumnCompInstColumnCompInstColumnCompInstColumnCompInstcolumnCompInst, AngleCompInstAngleCompInstAngleCompInstAngleCompInstAngleCompInstangleCompInst und ScoreCompInstScoreCompInstScoreCompInstScoreCompInstScoreCompInstscoreCompInst auf 0 gesetzt.

Parallelisierung

• 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_modelGetFoundComponentModelget_found_component_modelGetFoundComponentModelGetFoundComponentModel den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

find_component_modelfind_component_modelFindComponentModelfind_component_modelFindComponentModelFindComponentModel

Siehe auch

train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents, create_component_modelcreate_component_modelCreateComponentModelcreate_component_modelCreateComponentModelCreateComponentModel

Modul

Matching