train_generic_shape_modelT_train_generic_shape_modelTrainGenericShapeModelTrainGenericShapeModeltrain_generic_shape_model (Operator)
Name
train_generic_shape_modelT_train_generic_shape_modelTrainGenericShapeModelTrainGenericShapeModeltrain_generic_shape_model — Train a shape model for matching.
Signature
Herror T_train_generic_shape_model(const Hobject Template, const Htuple ModelID)
Description
The operator train_generic_shape_modeltrain_generic_shape_modelTrainGenericShapeModelTrainGenericShapeModelTrainGenericShapeModeltrain_generic_shape_model trains the shape model
ModelIDModelIDModelIDModelIDmodelIDmodel_id in order to find the training pattern given in
TemplateTemplateTemplateTemplatetemplatetemplate.
TemplateTemplateTemplateTemplatetemplatetemplate accepts the training pattern to be of one of the following
types:
- Image:
-
The domain of the image given in TemplateTemplateTemplateTemplatetemplatetemplate sets the ROI of the
model.
The model origin (reference point) is defined by the center of gravity of
the image domain.
The origin can be reset to a different point using
set_shape_model_originset_shape_model_originSetShapeModelOriginSetShapeModelOriginSetShapeModelOriginset_shape_model_origin.
- XLD contour:
-
XLD contours passed in TemplateTemplateTemplateTemplatetemplatetemplate should represent
the gray value edges of the pattern to be searched.
The model origin (reference point) is defined by the center of gravity of
the smallest axis-parallel rectangle enclosing the contours.
The origin can be reset to a different point using
set_shape_model_originset_shape_model_originSetShapeModelOriginSetShapeModelOriginSetShapeModelOriginset_shape_model_origin.
Properties of the model ModelIDModelIDModelIDModelIDmodelIDmodel_id can be retrieved using
get_generic_shape_model_paramget_generic_shape_model_paramGetGenericShapeModelParamGetGenericShapeModelParamGetGenericShapeModelParamget_generic_shape_model_param and modified using
set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param.
Note that after modifying certain parameters the model needs to be
(re)trained, see set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param.
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
TemplateTemplateTemplateTemplatetemplatetemplate (input_object) (multichannel-)object(-array) → objectHObjectHObjectHObjectHobject
Training image or xld.
ModelIDModelIDModelIDModelIDmodelIDmodel_id (input_control, state is modified) shape_model → HShapeModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the shape model.
Result
If the parameters are valid, the operator
train_generic_shape_modeltrain_generic_shape_modelTrainGenericShapeModelTrainGenericShapeModelTrainGenericShapeModeltrain_generic_shape_model returns the value 2 (H_MSG_TRUE).
If necessary an exception is raised.
Possible Predecessors
create_generic_shape_modelcreate_generic_shape_modelCreateGenericShapeModelCreateGenericShapeModelCreateGenericShapeModelcreate_generic_shape_model,
set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param
Possible Successors
find_generic_shape_modelfind_generic_shape_modelFindGenericShapeModelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model
Module
Matching