| Operatoren |
get_component_model_tree — Liefert den Suchbaum eines Komponentenmodells zurück.
get_component_model_tree( : Tree, Relations : ComponentModelID, RootComponent, Image : StartNode, EndNode, Row, Column, Phi, Length1, Length2, AngleStart, AngleExtent)
get_component_model_tree liefert den Suchbaum Tree und die zugehörigen Relationen Relations des Komponentenmodells, das in ComponentModelID übergeben wird, sowohl in Form von Regionen als auch in numerischer Form zurück. get_component_model_tree ist besonders hilfreich, um die mit create_trained_component_model oder create_component_model berechnete Suchreihenfolge der einzelnen Komponenten zu visualisieren.
Da je nach Wurzelkomponente ein anderer Suchbaum verwendet wird, muss die Wurzelkomponente in RootComponent übergeben werden. Die Knoten im Baum Tree 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 Image = 'model_image' oder Image = 0) oder in einem Trainingsbild (wenn Image >= 1). Falls Image >= 1 gewählt wird, muss das Komponentenmodell basierend auf dem Trainingsergebnis mit create_trained_component_model generiert worden sein.
Sei n die Anzahl an Komponenten in ComponentModelID. Das Regionenobjekttupel Relations 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 RootComponent 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 StartNode und EndNode 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 Row, Column, Phi, Length1, Length2, AngleStart und AngleExtent 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 Row, Column, Phi, Length1 und Length2 beschrieben (siehe gen_rectangle2). Die Winkelrelation wird durch den Anfangswinkel AngleStart und die Winkelausdehnung AngleExtent 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.
Suchbaum
Relationen der im Suchbaum verbundenen Komponenten.
Handle des Komponentenmodells.
Index der Wurzelkomponente.
Wertevorschläge: 0, 1, 2, 3, 4, 5, 6, 7, 8
Bild, für das der Baum zurückgeliefert werden soll.
Defaultwert: 'model_image'
Wertevorschläge: 'model_image', 0, 1, 2, 3, 4, 5, 6, 7, 8
Komponentenindex des Startknotens einer Verbindung im Suchbaum.
Komponentenindex des Endknotens einer Verbindung im Suchbaum.
Zeilenkoordinate des Mittelpunktes des Rechtecks, das die Relation beschreibt.
Spaltenindex des Mittelpunktes des Rechtecks, das die Relation beschreibt.
Orientierung des Rechtecks, das die Relation beschreibt (Bogenmaß).
Zusicherung: - pi / 2 < Phi && Phi <= pi / 2
Erster Halbmesser (halbe Länge) des Rechtecks, das die Relation beschreibt.
Zusicherung: Length1 >= 0.0
Zweiter Halbmesser (halbe Breite) des Rechtecks, das die Relation beschreibt.
Zusicherung: Length2 >= 0.0 && Length2 <= Length1
Kleinster relativer Orientierungswinkel.
Ausdehnung des relativen Orientierungswinkelbereichs.
* 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)
Sind die Parameterwerte korrekt, dann liefert get_component_model_tree den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
create_trained_component_model, create_component_model
Matching
| Operatoren |