get_component_model_treeT_get_component_model_treeGetComponentModelTreeGetComponentModelTreeget_component_model_tree (Operator)

Name

get_component_model_treeT_get_component_model_treeGetComponentModelTreeGetComponentModelTreeget_component_model_tree — Liefert den Suchbaum eines Komponentenmodells zurück.

Signatur

Beschreibung

get_component_model_treeget_component_model_treeGetComponentModelTreeGetComponentModelTreeGetComponentModelTreeget_component_model_tree liefert den Suchbaum TreeTreeTreeTreetreetree und die zugehörigen Relationen RelationsRelationsRelationsRelationsrelationsrelations des Komponentenmodells, das in ComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelIDcomponent_model_id übergeben wird, sowohl in Form von Regionen als auch in numerischer Form zurück. get_component_model_treeget_component_model_treeGetComponentModelTreeGetComponentModelTreeGetComponentModelTreeget_component_model_tree ist besonders hilfreich, um die mit create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModelCreateTrainedComponentModelcreate_trained_component_model oder create_component_modelcreate_component_modelCreateComponentModelCreateComponentModelCreateComponentModelcreate_component_model berechnete Suchreihenfolge der einzelnen Komponenten zu visualisieren.

Da je nach Wurzelkomponente ein anderer Suchbaum verwendet wird, muss die Wurzelkomponente in RootComponentRootComponentRootComponentRootComponentrootComponentroot_component übergeben werden. Die Knoten im Baum TreeTreeTreeTreetreetree repräsentieren die einzelnen Komponenten im Modell, die Verbindungen zwischen den Knoten zeigen an, welche Komponenten relativ zueinander gesucht werden. Die Lage der Knoten im Baum entspricht der Lage der Komponenten im Modellbild (wenn ImageImageImageImageimageimage = 'model_image'"model_image""model_image""model_image""model_image""model_image" oder ImageImageImageImageimageimage = 0) oder in einem Trainingsbild (wenn ImageImageImageImageimageimage >= 1). Falls ImageImageImageImageimageimage >= 1 gewählt wird, muss das Komponentenmodell basierend auf dem Trainingsergebnis mit create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModelCreateTrainedComponentModelcreate_trained_component_model generiert worden sein.

Sei n die Anzahl an Komponenten in ComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelIDcomponent_model_id. Das Regionenobjekttupel RelationsRelationsRelationsRelationsrelationsrelations der Länge n hat folgenden Aufbau: Für jede Komponente wird eine eigene Region zurückgeliefert. Die Positionen aller Komponenten im Bild werden durch Kreise mit einem Radius von 3 Pixel dargestellt. Für jede Komponente, die nicht der Wurzelkomponente RootComponentRootComponentRootComponentRootComponentrootComponentroot_component entspricht, werden zusätzlich die Positionsrelation und die Winkelrelation relativ zur Vorgänger-Komponente im Baum dargestellt. Die Positionsrelation wird dabei durch ein Rechteck und die Winkelrelation durch einen Kreissektor mit einem Radius von 30 Pixel dargestellt. Der Kreismittelpunkt liegt dabei an der mittleren relativen Position der Komponente. Das Rechteck beschreibt die Referenzpunktbewegung der jeweiligen Komponente relativ zur Lage der Vorgänger-Komponente, der Öffnungswinkel des Kreissektors beschreibt die Variation der relativen Orientierung. Eine relative Orientierung von 0 entspricht der relativen Orientierung der beiden Komponenten im Modellbild.

Zusätzlich zu den Regionen werden der Suchbaum und die entsprechenden Relationen auch in numerischer Form zurückgeliefert. Der Suchbaum wird dabei in Form zweier Tupel StartNodeStartNodeStartNodeStartNodestartNodestart_node und EndNodeEndNodeEndNodeEndNodeendNodeend_node der Länge n beschrieben, die die jeweiligen Anfangs- und Endknoten aller Verbindungen im Baum enthalten. Dabei enthalten die Knoten die Indizes der entsprechenden Komponenten. Während der Suche wird die Komponenten, die durch den Endknoten beschrieben ist, relativ zur Lage der Komponente, die durch den Anfangsknoten beschrieben ist (Vorgängerkomponente), gesucht. Da die Wurzelkomponente nicht relativ zu einer anderen Komponente gesucht wird und somit keine Vorgängerkomponente besitzt, wird der entsprechende Anfangsknoten auf -1 gesetzt. Die Relationen werden in Form von numerischen Werten in RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn, PhiPhiPhiPhiphiphi, Length1Length1Length1Length1length1length_1, Length2Length2Length2Length2length2length_2, AngleStartAngleStartAngleStartAngleStartangleStartangle_start und AngleExtentAngleExtentAngleExtentAngleExtentangleExtentangle_extent zurückgeliefert. Diese Parameter sind Tupel der Länge n und enthalten die Relationen aller Komponenten relativ zu ihrer Vorgängerkomponente im Baum, wobei die Reihenfolge der Werte in den Tupeln durch den Index der entsprechenden Komponenten festgelegt ist. Die Positionsrelation wird dabei durch die Parameter des entsprechenden Rechtecks RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn, PhiPhiPhiPhiphiphi, Length1Length1Length1Length1length1length_1 und Length2Length2Length2Length2length2length_2 beschrieben (siehe gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2gen_rectangle2). Die Winkelrelation wird durch den Anfangswinkel AngleStartAngleStartAngleStartAngleStartangleStartangle_start und die Winkelausdehnung AngleExtentAngleExtentAngleExtentAngleExtentangleExtentangle_extent beschrieben.

Für die Wurzelkomponente und für Komponenten, die in dem entsprechenden Bild keine Vorgängerkomponente besitzen oder nicht gefunden wurden, wird eine leere Region zurückgeliefert und die entsprechenden Werte der sieben Parameter 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 the model image.
read_image (ModelImage, 'model_image.tif')
* Describe the model components.
gen_rectangle2 (ComponentRegions, 318, 109, -1.62, 34, 19)
gen_rectangle2 (Rectangle2, 342, 238, -1.63, 32, 17)
gen_rectangle2 (Rectangle3, 355, 505, 1.41, 25, 17)
concat_obj (ComponentRegions, Rectangle2, ComponentRegions)
concat_obj (ComponentRegions, Rectangle3, ComponentRegions)
* Create the component model.
create_component_model (ModelImage, ComponentRegions, 20, 20, rad(25), 0, \
                        rad(360), 15, 40, 15, 10, 0.8, 0, 0, 'none', \
                        'use_polarity', 'true', ComponentModelID, \
                        RootRanking)
* Get the component model tree.
get_component_model_tree (Tree, Relations, ComponentModelID, RootRanking, \
                          'model_image', StartNode, EndNode, Row, Column, \
                          Phi, Length1, Length2, AngleStart, AngleExtent)
dev_set_colored (12)
dev_display (ModelImage)
dev_display (Tree)
dev_display (Relations)

Ergebnis

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

Vorgänger

create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModelCreateTrainedComponentModelcreate_trained_component_model, create_component_modelcreate_component_modelCreateComponentModelCreateComponentModelCreateComponentModelcreate_component_model

Siehe auch

train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponentstrain_model_components

Modul

Matching