get_component_relationsget_component_relationsGetComponentRelationsget_component_relationsGetComponentRelationsGetComponentRelations (Operator)

Name

get_component_relationsget_component_relationsGetComponentRelationsget_component_relationsGetComponentRelationsGetComponentRelations — Liefert die in einem Trainingsergebnis gespeicherten Relationen zwischen den Modellkomponenten zurück.

Signatur

Beschreibung

get_component_relationsget_component_relationsGetComponentRelationsget_component_relationsGetComponentRelationsGetComponentRelations liefert die Relationen zwischen Modellkomponenten nachdem sie mit train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents trainiert worden sind. Mit dem Parameter ReferenceComponentReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent kann eine Referenzkomponente ausgewählt werden. get_component_relationsget_component_relationsGetComponentRelationsget_component_relationsGetComponentRelationsGetComponentRelations liefert dann die Relationen zwischen der Referenzkomponente und allen übrigen 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). Um die Relationen im i. Trainingsbild zu erhalten, muss ImageImageImageImageImageimage auf i gesetzt werden. Das Ergebnis des mit train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents durchgeführten Trainings muss in ComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingID übergeben werden. ReferenceComponentReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent beschreibt den Index der entsprechenden Referenzkomponente und muss somit im Bereich von 0 bis n-1 liegen, wenn n die Anzahl der Modellkomponenten darstellt (siehe train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents).

Die Relationen werden sowohl in Form von Regionen in RelationsRelationsRelationsRelationsRelationsrelations als auch in Form von numerischen Werten in RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn, PhiPhiPhiPhiPhiphi, Length1Length1Length1Length1Length1length1, Length2Length2Length2Length2Length2length2, AngleStartAngleStartAngleStartAngleStartAngleStartangleStart und AngleExtentAngleExtentAngleExtentAngleExtentAngleExtentangleExtent zurückgeliefert.

Das Regionenobjekttupel RelationsRelationsRelationsRelationsRelationsrelations hat folgenden Aufbau: Für jede Komponente wird eine eigene Region zurückgeliefert. Somit beinhaltet RelationsRelationsRelationsRelationsRelationsrelations n Regionen, wobei die Reihenfolge der Regionen im Tupel durch den Index der entsprechenden Komponenten festgelegt ist. Die Positionen aller Komponenten im Bild werden durch Kreise mit einem Radius von 3 Pixel dargestellt. Für jede Komponente, die nicht der Referenzkomponente ReferenceComponentReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent entspricht, werden zusätzlich die Positionsrelation und die Winkelrelation relativ zur Referenzkomponente 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 Referenzkomponente, der Öffnungswinkel des Kreissektors beschreibt die Variation der relativen Orientierung (siehe train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents). Eine relative Orientierung von 0 entspricht der relativen Orientierung der beiden Komponenten im Modellbild. Zeigen die beiden Komponenten in allen Bildern die gleiche relative Orientierung entartet der Kreissektor demzufolge zu einer Geraden.

Neben dem Regionenobjekttupel RelationsRelationsRelationsRelationsRelationsrelations werden die Relationen auch in Form von numerischen Werten RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn, PhiPhiPhiPhiPhiphi, Length1Length1Length1Length1Length1length1, Length2Length2Length2Length2Length2length2, AngleStartAngleStartAngleStartAngleStartAngleStartangleStart und AngleExtentAngleExtentAngleExtentAngleExtentAngleExtentangleExtent zurückgeliefert. Diese Parameter sind Tupel der Länge n und enthalten die Relationen aller Komponenten relativ zur Referenzkomponente, 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, Length1Length1Length1Length1Length1length1 und Length2Length2Length2Length2Length2length2 beschrieben (siehe gen_rectangle2gen_rectangle2GenRectangle2gen_rectangle2GenRectangle2GenRectangle2). Die Winkelrelation wird durch den Anfangswinkel AngleStartAngleStartAngleStartAngleStartAngleStartangleStart und die Winkelausdehnung AngleExtentAngleExtentAngleExtentAngleExtentAngleExtentangleExtent beschrieben. Für die Referenzkomponente wird lediglich deren Position im Bild in RowRowRowRowRowrow und ColumnColumnColumnColumnColumncolumn zurückgeliefert. Alle anderen Werte sind dagegen auf 0 gesetzt.

Wurde die Referenzkomponente im Bild nicht gefunden, so wird ein Tupel leerer Regionen zurückgeliefert und die entsprechenden Parameterwerte werden auf 0 gesetzt.

Der Operator get_component_relationsget_component_relationsGetComponentRelationsget_component_relationsGetComponentRelationsGetComponentRelations kann dazu genutzt werden, das Ergebnis des mit train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents durchgeführten Trainings zu visualisieren. Damit ist es möglich, die in den Trainingsbildern enthaltenen Variationen einzuschätzen. Eventuell kann es sinnvoll sein, mit einem veränderten Satz von Trainingsbildern das Training mit train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents erneut durchzuführen.

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

Ergebnis

Ist der Handle des Trainingsergebnisses gültig, dann liefert get_component_relationsget_component_relationsGetComponentRelationsget_component_relationsGetComponentRelationsGetComponentRelations den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents

Nachfolger

train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents

Siehe auch

gen_rectangle2gen_rectangle2GenRectangle2gen_rectangle2GenRectangle2GenRectangle2

Modul

Matching