modify_component_relationsT_modify_component_relationsModifyComponentRelationsModifyComponentRelations (Operator)
Name
modify_component_relationsT_modify_component_relationsModifyComponentRelationsModifyComponentRelations — Modify the relations within a training result.
Signature
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
(Windows only)
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)
Description
modify_component_relationsmodify_component_relationsModifyComponentRelationsModifyComponentRelationsModifyComponentRelations modifies the relations between
the model components within the component training result
ComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingID. The selection of the relation(s) that
should be changed is performed by setting
ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent and ToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponent,
respectively. This means that the relative movement of component
ToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponent with respect to the component
ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent is modified.
The size of the change is specified as follows: By specifying a
position tolerance PositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionTolerance, the semi-axes of the
rectangle that describes the reference point's movement (see
train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents) are enlarged by
PositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionTolerance pixels. Accordingly, by specifying an
orientation tolerance AngleToleranceAngleToleranceAngleToleranceAngleToleranceangleTolerance, the angle range that
describes the variation of the relative orientation (see
train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents) is enlarged by
AngleToleranceAngleToleranceAngleToleranceAngleToleranceangleTolerance to both sides. Consequently, negative
tolerance values lead to a decreased size of the relations. The
operator modify_component_relationsmodify_component_relationsModifyComponentRelationsModifyComponentRelationsModifyComponentRelations is particularly useful
when the training images that were used during the training do not
cover the entire spectrum of the relative movements.
In order to select the relations that should be modified, values for
ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent and ToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponent can be
passed in one of the following ways: For each of both parameters
either one value, several values, or the string 'all'"all""all""all""all" can
be passed. The following table summarizes the different
possibilities by giving the affected relations for different
combinations of parameter values. Here, four model components are
assumed (0, 1, 2, and 3). If, for example,
ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent is set to 0 and
ToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponent is set to 1, then the relation
(0,1), which corresponds to the relative movement of component 1
with respect to component 0, will be modified.
ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent |
ToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponent |
Affected Relation(s) |
|
|
|
|
|
'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)
|
The number of tolerance values passed in PositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionTolerance
and AngleToleranceAngleToleranceAngleToleranceAngleToleranceangleTolerance must be either 1 or be equal to the
number of affected relations. In the former case all affected
relations are modified by the same value, whereas in the latter case
each relation can be modified individually by passing different
values within a tuple.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
This operator modifies the state of the following input parameter:
During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.
Parameters
ComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingID (input_control, state is modified) component_training → HComponentTraining, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the training result.
ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent (input_control) string(-array) → HTupleHTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Model component(s) relative to which the movement(s)
should be modified.
Default value:
'all'
"all"
"all"
"all"
"all"
Suggested values: 'all'"all""all""all""all", 0, 1, 2, 3, 4, 5, 6
ToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponent (input_control) string(-array) → HTupleHTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Model component(s) of which the relative movement(s)
should be modified.
Default value:
'all'
"all"
"all"
"all"
"all"
Suggested values: 'all'"all""all""all""all", 0, 1, 2, 3, 4, 5, 6
PositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionTolerance (input_control) real(-array) → HTupleHTupleHtuple (real) (double) (double) (double)
Change of the position relation in pixels.
Suggested values: 1.0, 2.0, 3.0, 4.0, 5.0, 10.0, 20.0, 30.0
AngleToleranceAngleToleranceAngleToleranceAngleToleranceangleTolerance (input_control) angle.rad(-array) → HTupleHTupleHtuple (real) (double) (double) (double)
Change of the orientation relation in radians.
Suggested values: 0.017, 0.035, 0.052, 0.070, 0.087, 0.175, 0.349
Result
If the handle of the training result is valid, the operator
modify_component_relationsmodify_component_relationsModifyComponentRelationsModifyComponentRelationsModifyComponentRelations returns the value 2 (H_MSG_TRUE). If
necessary an exception is raised.
Possible Predecessors
train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents
Possible Successors
create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModelCreateTrainedComponentModel
Module
Matching