set_deformable_model_paramT_set_deformable_model_paramSetDeformableModelParamSetDeformableModelParamset_deformable_model_param (Operator)

Name

set_deformable_model_paramT_set_deformable_model_paramSetDeformableModelParamSetDeformableModelParamset_deformable_model_param — Set selected parameters of the deformable model.

Signature

set_deformable_model_param( : : ModelID, GenParamName, GenParamValue : )

Description

The operator set_deformable_model_paramset_deformable_model_paramSetDeformableModelParamSetDeformableModelParamset_deformable_model_param sets the selected parameters GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name in the deformable model ModelIDModelIDModelIDmodelIDmodel_id. The following parameters can be modified:

'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast"

Sets the minimum contrast of the object in the search images for the deformable model ModelIDModelIDModelIDmodelIDmodel_id. Thereby, the value of 'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast" that was originally set, e.g., with create_planar_uncalib_deformable_modelcreate_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelcreate_planar_uncalib_deformable_model, is overwritten for the deformable model ModelIDModelIDModelIDmodelIDmodel_id. Note that if the deformable model ModelIDModelIDModelIDmodelIDmodel_id was read from file and if this file should be changed as well, the deformable model ModelIDModelIDModelIDmodelIDmodel_id must again be written to file after the execution of the operator set_deformable_model_paramset_deformable_model_paramSetDeformableModelParamSetDeformableModelParamset_deformable_model_param.

'get_deformable_model_contours_coord_system'

Sets the coordinate system in which the contours are returned when calling the operator get_deformable_model_contoursget_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours. If 'world'"world""world""world""world" is passed, the contours are returned in the world coordinate system in metric units. Note that this is only possible for the calibrated case. If 'image'"image""image""image""image" is passed, the contours are returned in the image coordinate system in pixel units. In the calibrated case this system corresponds to the rectified image coordinate system. The rectified image coordinate system is the coordinate system of an image one would obtain by change_radial_distortion_imagechange_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImagechange_radial_distortion_image when using the rectified camera parameters. The rectified camera parameters can be queried by get_deformable_model_paramsget_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params. If the model was created by create_planar_calib_deformable_model_xldcreate_planar_calib_deformable_model_xldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXldcreate_planar_calib_deformable_model_xld the value of 'get_deformable_model_contours_coord_system' is 'world'"world""world""world""world" by default. In all other cases it is 'image'"image""image""image""image" by default.

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:

ModelIDModelIDModelIDmodelIDmodel_id

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

ModelIDModelIDModelIDmodelIDmodel_id (input_control, state is modified) deformable_model → (handle)

Handle of the model.

GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name-array → (string)

Parameter names.

List of values: 'get_deformable_model_contours_coord_system', 'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast"

GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control) attribute.value-array → (real / integer / string)

Parameter values.

Suggested values: 5, 6, 7, 8, 9, 10, 'image'"image""image""image""image", 'world'"world""world""world""world"

Result

If the parameters are valid, the operator set_deformable_model_paramset_deformable_model_paramSetDeformableModelParamSetDeformableModelParamset_deformable_model_param returns the value 2 ( H_MSG_TRUE) . If necessary an exception is raised.