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