set_deformable_model_paramT_set_deformable_model_paramSetDeformableModelParamSetDeformableModelParam (Operator)

Name

set_deformable_model_paramT_set_deformable_model_paramSetDeformableModelParamSetDeformableModelParam — Set selected parameters of the deformable model.

Signature

set_deformable_model_param( : : ModelID, GenParamName, GenParamValue : )

Description

The operator set_deformable_model_paramset_deformable_model_paramSetDeformableModelParamSetDeformableModelParamSetDeformableModelParam sets the selected parameters GenParamNameGenParamNameGenParamNameGenParamNamegenParamName in the deformable model ModelIDModelIDModelIDModelIDmodelID. 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 ModelIDModelIDModelIDModelIDmodelID. 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_modelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModel, is overwritten for the deformable model ModelIDModelIDModelIDModelIDmodelID. Note that if the deformable model ModelIDModelIDModelIDModelIDmodelID was read from file and if this file should be changed as well, the deformable model ModelIDModelIDModelIDModelIDmodelID must again be written to file after the execution of the operator set_deformable_model_paramset_deformable_model_paramSetDeformableModelParamSetDeformableModelParamSetDeformableModelParam.

'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_contoursGetDeformableModelContoursGetDeformableModelContoursGetDeformableModelContours. 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_imageChangeRadialDistortionImageChangeRadialDistortionImageChangeRadialDistortionImage when using the rectified camera parameters. The rectified camera parameters can be queried by get_deformable_model_paramsget_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsGetDeformableModelParams. If the model was created by create_planar_calib_deformable_model_xldcreate_planar_calib_deformable_model_xldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXld 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:

ModelIDModelIDModelIDModelIDmodelID

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

Parameters

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

Handle of the model.

GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (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"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (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_paramSetDeformableModelParamSetDeformableModelParamSetDeformableModelParam returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.