ClassesClassesClassesClasses | | | | Operators

modify_component_relationsmodify_component_relationsModifyComponentRelationsmodify_component_relationsModifyComponentRelationsModifyComponentRelations (Operator)

Name

modify_component_relationsmodify_component_relationsModifyComponentRelationsmodify_component_relationsModifyComponentRelationsModifyComponentRelations — Modify the relations within a training result.

Signature

modify_component_relations( : : ComponentTrainingID, ReferenceComponent, ToleranceComponent, PositionTolerance, AngleTolerance : )

Herror modify_component_relations(const Hlong ComponentTrainingID, const char* ReferenceComponent, const char* ToleranceComponent, double PositionTolerance, double AngleTolerance)

Herror T_modify_component_relations(const Htuple ComponentTrainingID, const Htuple ReferenceComponent, const Htuple ToleranceComponent, const Htuple PositionTolerance, const Htuple AngleTolerance)

Herror modify_component_relations(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 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 HOperatorSetX.ModifyComponentRelations(
[in] VARIANT ComponentTrainingID, [in] VARIANT ReferenceComponent, [in] VARIANT ToleranceComponent, [in] VARIANT PositionTolerance, [in] VARIANT AngleTolerance)

void HComponentTrainingX.ModifyComponentRelations(
[in] VARIANT ReferenceComponent, [in] VARIANT ToleranceComponent, [in] VARIANT PositionTolerance, [in] VARIANT AngleTolerance)

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_relationsModifyComponentRelationsmodify_component_relationsModifyComponentRelationsModifyComponentRelations modifies the relations between the model components within the component training result ComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingID. The selection of the relation(s) that should be changed is performed by setting ReferenceComponentReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent and ToleranceComponentToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponent, respectively. This means that the relative movement of component ToleranceComponentToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponent with respect to the component ReferenceComponentReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent is modified.

The size of the change is specified as follows: By specifying a position tolerance PositionTolerancePositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionTolerance, the semi-axes of the rectangle that describes the reference point's movement (see train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents) are enlarged by PositionTolerancePositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionTolerance pixels. Accordingly, by specifying an orientation tolerance AngleToleranceAngleToleranceAngleToleranceAngleToleranceAngleToleranceangleTolerance, the angle range that describes the variation of the relative orientation (see train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents) is enlarged by AngleToleranceAngleToleranceAngleToleranceAngleToleranceAngleToleranceangleTolerance to both sides. Consequently, negative tolerance values lead to a decreased size of the relations. The operator modify_component_relationsmodify_component_relationsModifyComponentRelationsmodify_component_relationsModifyComponentRelationsModifyComponentRelations 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 ReferenceComponentReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent and ToleranceComponentToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponent 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""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, ReferenceComponentReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent is set to 0 and ToleranceComponentToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponent 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.

  | ReferenceComponentReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent | ToleranceComponentToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponent | 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 PositionTolerancePositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionTolerance and AngleToleranceAngleToleranceAngleToleranceAngleToleranceAngleToleranceangleTolerance 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.

Parallelization

Parameters

ComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingID (input_control)  component_training HComponentTraining, HTupleHTupleHComponentTraining, HTupleHComponentTrainingX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the training result.

ReferenceComponentReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent (input_control)  string(-array) HTupleHTupleHTupleVARIANTHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong) (BSTR / Hlong) (char* / Hlong)

Model component(s) relative to which the movement(s) should be modified.

Default value: 'all' "all" "all" "all" "all" "all"

Suggested values: 'all'"all""all""all""all""all", 0, 1, 2, 3, 4, 5, 6

ToleranceComponentToleranceComponentToleranceComponentToleranceComponentToleranceComponenttoleranceComponent (input_control)  string(-array) HTupleHTupleHTupleVARIANTHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong) (BSTR / Hlong) (char* / Hlong)

Model component(s) of which the relative movement(s) should be modified.

Default value: 'all' "all" "all" "all" "all" "all"

Suggested values: 'all'"all""all""all""all""all", 0, 1, 2, 3, 4, 5, 6

PositionTolerancePositionTolerancePositionTolerancePositionTolerancePositionTolerancepositionTolerance (input_control)  real(-array) HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (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

AngleToleranceAngleToleranceAngleToleranceAngleToleranceAngleToleranceangleTolerance (input_control)  angle.rad(-array) HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (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_relationsModifyComponentRelationsmodify_component_relationsModifyComponentRelationsModifyComponentRelations returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents

Possible Successors

create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModel

Module

Matching


ClassesClassesClassesClasses | | | | Operators