get_found_component_modelT_get_found_component_modelGetFoundComponentModelGetFoundComponentModelget_found_component_model (Operator)

Name

get_found_component_modelT_get_found_component_modelGetFoundComponentModelGetFoundComponentModelget_found_component_model — Return the components of a found instance of a component model.

Signature

Description

get_found_component_modelget_found_component_modelGetFoundComponentModelGetFoundComponentModelGetFoundComponentModelget_found_component_model returns the components of a found instance of the component model ComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelIDcomponent_model_id in form of contour regions in FoundComponentsFoundComponentsFoundComponentsFoundComponentsfoundComponentsfound_components as well as in numerical form.

The operator get_found_component_modelget_found_component_modelGetFoundComponentModelGetFoundComponentModelGetFoundComponentModelget_found_component_model is particularly useful in order to visualize the matches that have been obtained by find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModelfind_component_model.

The pose of the returned components corresponds to their pose in the search image as returned by find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModelfind_component_model. Hence, the parameters ModelStartModelStartModelStartModelStartmodelStartmodel_start, ModelEndModelEndModelEndModelEndmodelEndmodel_end, RowCompRowCompRowCompRowComprowComprow_comp, ColumnCompColumnCompColumnCompColumnCompcolumnCompcolumn_comp, AngleCompAngleCompAngleCompAngleCompangleCompangle_comp, ScoreCompScoreCompScoreCompScoreCompscoreCompscore_comp, and ModelCompModelCompModelCompModelCompmodelCompmodel_comp must be passed to get_found_component_modelget_found_component_modelGetFoundComponentModelGetFoundComponentModelGetFoundComponentModelget_found_component_model as they have been returned by find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModelfind_component_model. In ModelMatchModelMatchModelMatchModelMatchmodelMatchmodel_match the index of the found instance of the component model must be passed. Consequently, ModelMatchModelMatchModelMatchModelMatchmodelMatchmodel_match must lie within the range between 0 and m-1, where m is the number of elements in ModelStartModelStartModelStartModelStartmodelStartmodel_start and ModelEndModelEndModelEndModelEndmodelEndmodel_end, and hence corresponds to the number of found model instances. For example, if the best match should be returned, ModelMatchModelMatchModelMatchModelMatchmodelMatchmodel_match should be set to 0.

When dealing with rotationally symmetric components, one may wish to mark the current orientation of the found component. This can be achieved by setting MarkOrientationMarkOrientationMarkOrientationMarkOrientationmarkOrientationmark_orientation to 'true'"true""true""true""true""true". In this case, the contour region of each component is complemented by an arrow at its reference point that points in the reference direction. The reference direction of a component is based on the orientation of the component in the model image (see train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponentstrain_model_components or create_component_modelcreate_component_modelCreateComponentModelCreateComponentModelCreateComponentModelcreate_component_model) and is represented by an arrow that starts at the reference point and points to the right in the horizontal direction.

For convenience, the pose parameters as well as the score of each component of the found model instance are additionally returned in numerical form in RowCompInstRowCompInstRowCompInstRowCompInstrowCompInstrow_comp_inst, ColumnCompInstColumnCompInstColumnCompInstColumnCompInstcolumnCompInstcolumn_comp_inst, AngleCompInstAngleCompInstAngleCompInstAngleCompInstangleCompInstangle_comp_inst, and ScoreCompInstScoreCompInstScoreCompInstScoreCompInstscoreCompInstscore_comp_inst. The four tuples are always of length n, where n is the number of components in the component model ComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelIDcomponent_model_id. If a component could not be found during the search, an empty region is passed in the corresponding element of FoundComponentsFoundComponentsFoundComponentsFoundComponentsfoundComponentsfound_components and the value of the corresponding element in RowCompInstRowCompInstRowCompInstRowCompInstrowCompInstrow_comp_inst, ColumnCompInstColumnCompInstColumnCompInstColumnCompInstcolumnCompInstcolumn_comp_inst, AngleCompInstAngleCompInstAngleCompInstAngleCompInstangleCompInstangle_comp_inst, and ScoreCompInstScoreCompInstScoreCompInstScoreCompInstscoreCompInstscore_comp_inst is set to 0.

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

Example (HDevelop)

* Read a component model from file.
read_component_model ('pliers.cpm', ComponentModelID)
* Find the component model in a run-time image.
read_image (SearchImage, 'search_image.tif')
find_component_model (SearchImage, ComponentModelID, RootRanking, 0, \
                      rad(360), 0.5, 0, 0.5, 'stop_search', 'prune_branch', \
                      'none', 0.8, 'least_squares', 0, 0.8, ModelStart, \
                      ModelEnd, Score, RowComp, ColumnComp, AngleComp, \
                      ScoreComp, ModelComp)
* Visualize the found instances.
for i := 0 to |ModelStart|-1 by 1
    get_found_component_model (FoundComponents, ComponentModelID, \
                               ModelStart, ModelEnd, RowComp, ColumnComp, \
                               AngleComp, ScoreComp, ModelComp, i, 'false', \
                               RowCompInst, ColumnCompInst, AngleCompInst, \
                               ScoreCompInst)
    dev_display (FoundComponents)
endfor

Result

If the parameters are valid, the operator get_found_component_modelget_found_component_modelGetFoundComponentModelGetFoundComponentModelGetFoundComponentModelget_found_component_model returns the value TRUE. If necessary an exception is raised.

Possible Predecessors

find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModelfind_component_model

See also

train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponentstrain_model_components, create_component_modelcreate_component_modelCreateComponentModelCreateComponentModelCreateComponentModelcreate_component_model

Module

Matching