modify_component_relationsT_modify_component_relationsModifyComponentRelationsModifyComponentRelationsmodify_component_relations (Operator)
Name
modify_component_relationsT_modify_component_relationsModifyComponentRelationsModifyComponentRelationsmodify_component_relations — Verändert die Relationen innerhalb eines Trainingsergebnisses.
Signatur
void ModifyComponentRelations(const HTuple& ComponentTrainingID, const HTuple& ReferenceComponent, const HTuple& ToleranceComponent, const HTuple& PositionTolerance, const HTuple& AngleTolerance)
void HComponentTraining::ModifyComponentRelations(const HTuple& ReferenceComponent, const HTuple& ToleranceComponent, const HTuple& PositionTolerance, const HTuple& AngleTolerance) const
void HComponentTraining::ModifyComponentRelations(const HString& ReferenceComponent, const HString& ToleranceComponent, double PositionTolerance, double AngleTolerance) const
void HComponentTraining::ModifyComponentRelations(const char* ReferenceComponent, const char* ToleranceComponent, double PositionTolerance, double AngleTolerance) const
void HComponentTraining::ModifyComponentRelations(const wchar_t* ReferenceComponent, const wchar_t* ToleranceComponent, double PositionTolerance, double AngleTolerance) const
(Nur Windows)
static void HOperatorSet.ModifyComponentRelations(HTuple componentTrainingID, HTuple referenceComponent, HTuple toleranceComponent, HTuple positionTolerance, HTuple angleTolerance)
void HComponentTraining.ModifyComponentRelations(HTuple referenceComponent, HTuple toleranceComponent, HTuple positionTolerance, HTuple angleTolerance)
void HComponentTraining.ModifyComponentRelations(string referenceComponent, string toleranceComponent, double positionTolerance, double angleTolerance)
Beschreibung
modify_component_relationsmodify_component_relationsModifyComponentRelationsModifyComponentRelationsModifyComponentRelationsmodify_component_relations verändert die Relationen zwischen
den Modellkomponenten innerhalb des Trainingsergebnisses
ComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingIDcomponent_training_id. Die Auswahl der zu ändernden
Relation(en) erfolgt mit ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponentreference_component und
ToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponenttolerance_component, d.h. die Bewegung der Komponente
ToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponenttolerance_component relativ zur Komponente
ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponentreference_component wird verändert. Diese beiden Parameter
beschreiben den Index der entsprechenden Komponenten und müssen
somit im Bereich von 0 bis n-1 liegen, wenn n die
Anzahl der Komponenten darstellt.
Das Maß der Veränderung wird durch die Angabe von Toleranzwerten
festgelegt. Durch die Angabe einer Positionstoleranz
PositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionToleranceposition_tolerance wird erreicht, dass die Halbachsen des
Rechtecks, das die Referenzpunktbewegung beschreibt (siehe
train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponentstrain_model_components), um PositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionToleranceposition_tolerance Pixel
vergrößert werden. Dementsprechend wird durch die Angabe einer
Winkeltoleranz AngleToleranceAngleToleranceAngleToleranceAngleToleranceangleToleranceangle_tolerance erreicht, dass der
Winkelbereich, der die Variation der relativen Orientierung
beschreibt (siehe train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponentstrain_model_components), um
AngleToleranceAngleToleranceAngleToleranceAngleToleranceangleToleranceangle_tolerance in beide Richtungen vergrößert
wird. Negative Toleranzwerte führen konsequenter Weise zur
Verkleinerung der jeweiligen Relationen. Die Verwendung von
modify_component_relationsmodify_component_relationsModifyComponentRelationsModifyComponentRelationsModifyComponentRelationsmodify_component_relations ist insbesondere dann sinnvoll,
wenn davon ausgegangen werden muss, dass die während des Trainierens
verwendeten Trainingsbildern nicht das gesamte Spektrum der relativen
Bewegungen abdecken.
Für die Auswahl der zu ändernden Relationen mit Hilfe von
ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponentreference_component und ToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponenttolerance_component sind
folgende Möglichkeiten vorgesehen. Für jeden der beiden Parameter
können jeweils entweder ein Wert, mehrere Werte, oder 'all'"all""all""all""all""all"
übergeben werden. Folgende Tabelle veranschaulicht die verschiedenen
Möglichkeiten durch Angabe der betroffenen Relation(en) für
verschiedene Kombinationen von Parameterwerten. Dabei wird von vier
Modellkomponenten (0, 1, 2 und 3) ausgegangen. Werden zum Beispiel
ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponentreference_component auf 0 und
ToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponenttolerance_component auf 1 gesetzt, dann wird die
Relation (0,1), die die Bewegung der Komponente 1 relativ zur
Komponente 0 beschreibt, verändert.
ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponentreference_component |
ToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponenttolerance_component |
Betroffene Relation(en) |
|
|
|
|
|
'all' |
'all' |
(0,1) (0,2) (0,3) |
|
|
|
(1,0) (1,2) (1,3) |
|
|
|
(2,0) (2,1) (2,3) |
|
|
|
(3,0) (3,1) (3,2) |
|
|
|
|
|
'all' |
[1,2] |
(0,1) (0,2) |
|
|
|
(1,2) |
|
|
|
(2,1) |
|
|
|
(3,1) (3,2) |
|
|
|
|
|
[0,1] |
'all' |
(0,1) (0,2) (0,3) |
|
|
|
(1,0) (1,2) (1,3) |
|
|
|
|
|
0 |
1 |
(0,1) |
|
|
|
|
|
0 |
[1,2] |
(0,1) (0,2) |
|
|
|
|
|
[0,1] |
2 |
(0,2) (1,2) |
|
|
|
|
|
[0,1,2] |
[1,2,3] |
(0,1) (1,2) (2,3)
|
Die Anzahl an übergebenen Toleranzwerten in
PositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionToleranceposition_tolerance und AngleToleranceAngleToleranceAngleToleranceAngleToleranceangleToleranceangle_tolerance muss gleich 1
sein oder mit der Anzahl an betroffenen Relationen
übereinstimmen. Im ersten Fall werden alle betroffenen Relationen um
den gleichen Wert verändert, wohingegen im zweiten Fall jede
Relation individuell durch einen eigenen Wert verändert werden
kann.
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.
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
Parameter
ComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingIDcomponent_training_id (input_control, Zustand wird modifiziert) component_training → HComponentTraining, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Trainingsergebnisses.
ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponentreference_component (input_control) string(-array) → HTupleMaybeSequence[Union[int, str]]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Modellkomponente(n) relativ zu der die Bewegung(en)
verändert werden soll(en).
Defaultwert:
'all'
"all"
"all"
"all"
"all"
"all"
Wertevorschläge: 'all'"all""all""all""all""all", 0, 1, 2, 3, 4, 5, 6
ToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponenttolerance_component (input_control) string(-array) → HTupleMaybeSequence[Union[int, str]]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Modellkomponente(n), deren relative Bewegung(en)
verändert werden soll(en).
Defaultwert:
'all'
"all"
"all"
"all"
"all"
"all"
Wertevorschläge: 'all'"all""all""all""all""all", 0, 1, 2, 3, 4, 5, 6
PositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionToleranceposition_tolerance (input_control) real(-array) → HTupleMaybeSequence[float]HTupleHtuple (real) (double) (double) (double)
Veränderung der Positionsrelation in Pixel.
Wertevorschläge: 1.0, 2.0, 3.0, 4.0, 5.0, 10.0, 20.0, 30.0
AngleToleranceAngleToleranceAngleToleranceAngleToleranceangleToleranceangle_tolerance (input_control) angle.rad(-array) → HTupleMaybeSequence[float]HTupleHtuple (real) (double) (double) (double)
Veränderung der Winkelrelation im Bogenmaß.
Wertevorschläge: 0.017, 0.035, 0.052, 0.070, 0.087, 0.175, 0.349
Ergebnis
Ist der Handle des Trainingsergebnisses gültig, dann liefert
modify_component_relationsmodify_component_relationsModifyComponentRelationsModifyComponentRelationsModifyComponentRelationsmodify_component_relations den Wert TRUE. Gegebenenfalls
wird eine Fehlerbehandlung durchgeführt.
Vorgänger
train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponentstrain_model_components
Nachfolger
create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModelCreateTrainedComponentModelcreate_trained_component_model
Modul
Matching