get_training_componentsT_get_training_componentsGetTrainingComponentsGetTrainingComponentsget_training_components (Operator)

Name

get_training_componentsT_get_training_componentsGetTrainingComponentsGetTrainingComponentsget_training_components — Return the initial or model components in a certain image.

Warning

get_training_componentsget_training_componentsGetTrainingComponentsGetTrainingComponentsget_training_components is obsolete and is only provided for reasons of backward compatibility.

Signature

Description

get_training_componentsget_training_componentsGetTrainingComponentsGetTrainingComponentsget_training_components returns all initial components (if ComponentsComponentsComponentscomponentscomponents = 'initial_components'"initial_components""initial_components""initial_components""initial_components") or all model components (if ComponentsComponentsComponentscomponentscomponents = 'model_components'"model_components""model_components""model_components""model_components") in TrainingComponentsTrainingComponentsTrainingComponentstrainingComponentstraining_components in form of contour regions as well as in numerical form. Alternatively, by directly passing the index of an initial component, all found poses of that initial component (i.e., the poses before solving the ambiguities in train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentstrain_model_components) are returned.

The pose of the returned components corresponds to their pose in the model image (if ImageImageImageimageimage = 'model_image'"model_image""model_image""model_image""model_image" or ImageImageImageimageimage = 0) or in a training image (if ImageImageImageimageimage >= 1). In order to obtain the components in the pose at which they were found in the ith training image, ImageImageImageimageimage must be set to i. Furthermore, when dealing with rotationally symmetric components, one may wish to mark the current orientation of the found component. This can be achieved by setting MarkOrientationMarkOrientationMarkOrientationmarkOrientationmark_orientation to 'true'"true""true""true""true". In this case, the contour region of each component is complemented by an arrow at its reference point pointing in the reference direction. The reference direction of a component is based on the orientation of the component in the model image and is represented by an arrow that starts at the reference point and points to the right in the horizontal direction.

In addition to the contour regions, the pose and the score of all found components is returned in RowRowRowrowrow, ColumnColumnColumncolumncolumn, AngleAngleAngleangleangle, and ScoreScoreScorescorescore (see find_shape_modelfind_shape_modelFindShapeModelFindShapeModelfind_shape_model). If ComponentsComponentsComponentscomponentscomponents was set to 'initial_components'"initial_components""initial_components""initial_components""initial_components" or 'model_components'"model_components""model_components""model_components""model_components", the tuples TrainingComponentsTrainingComponentsTrainingComponentstrainingComponentstraining_components, RowRowRowrowrow, ColumnColumnColumncolumncolumn, AngleAngleAngleangleangle, and ScoreScoreScorescorescore always contain the same number of elements as initial components or model components contained in ComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingIDcomponent_training_id, respectively. If one component was not found in the image, an empty region is returned in the corresponding element of TrainingComponentsTrainingComponentsTrainingComponentstrainingComponentstraining_components and the elements of the four output control parameters are set to the value 0. In contrast, if the index of an initial component is passed in ComponentsComponentsComponentscomponentscomponents, these tuples contain as many elements as matches of the corresponding initial component were found in the image.

The operator get_training_componentsget_training_componentsGetTrainingComponentsGetTrainingComponentsget_training_components is particularly useful in order to visualize the result of the training ComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingIDcomponent_training_id, which was performed with train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentstrain_model_components. With this, it is possible to evaluate the suitability of the training images or to inspect the influence of the parameters of train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentstrain_model_components. Sometimes it might be reasonable to restart the training with train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentstrain_model_components using a different set of training images or after adjusting the parameters.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Result

If the handle of the training result is valid, the operator get_training_componentsget_training_componentsGetTrainingComponentsGetTrainingComponentsget_training_components returns the value 2 ( H_MSG_TRUE) . If necessary, an exception is raised.

Module

Matching