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.
Tree (output_object) region → object
Suchbaum
Relations (output_object) region-array → object
Relationen der im Suchbaum verbundenen Komponenten.
ComponentModelID (input_control) component_model → (handle)
Handle des Komponentenmodells.
RootComponent (input_control) integer(-array) → (integer)
Index der Wurzelkomponente.
Wertevorschläge: 0, 1, 2, 3, 4, 5, 6, 7, 8
Image (input_control) string → (string / integer)
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
StartNode (output_control) integer(-array) → (integer)
Komponentenindex des Startknotens einer Verbindung im Suchbaum.
EndNode (output_control) integer(-array) → (integer)
Komponentenindex des Endknotens einer Verbindung im Suchbaum.
Row (output_control) rectangle2.center.y(-array) → (real)
Zeilenkoordinate des Mittelpunktes des Rechtecks, das die Relation beschreibt.
Column (output_control) rectangle2.center.x(-array) → (real)
Spaltenindex des Mittelpunktes des Rechtecks, das die Relation beschreibt.
Phi (output_control) rectangle2.angle.rad(-array) → (real)
Orientierung des Rechtecks, das die Relation beschreibt (Bogenmaß).
Zusicherung: - pi / 2 < Phi && Phi <= pi / 2
Length1 (output_control) rectangle2.hwidth(-array) → (real)
Erster Halbmesser (halbe Länge) des Rechtecks, das die Relation beschreibt.
Zusicherung: Length1 >= 0.0
Length2 (output_control) rectangle2.hheight(-array) → (real)
Zweiter Halbmesser (halbe Breite) des Rechtecks, das die Relation beschreibt.
Zusicherung: Length2 >= 0.0 && Length2 <= Length1
AngleStart (output_control) angle.rad(-array) → (real)
Kleinster relativer Orientierungswinkel.
AngleExtent (output_control) angle.rad(-array) → (real)
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