set_shape_model_paramT_set_shape_model_paramset_shape_model_paramSetShapeModelParamSetShapeModelParam (Operator)

Name

set_shape_model_paramT_set_shape_model_paramset_shape_model_paramSetShapeModelParamSetShapeModelParam — Set selected parameters of the shape model.

Signature

set_shape_model_param( : : ModelID, GenParamNames, GenParamValues : )

The operator set_shape_model_paramset_shape_model_paramset_shape_model_paramSetShapeModelParamSetShapeModelParam sets the selected parameters GenParamNamesGenParamNamesGenParamNamesGenParamNamesgenParamNames in the shape 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 shape model ModelIDModelIDModelIDModelIDmodelID. Thereby, the value of 'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast" that was originally set, e.g. with create_shape_modelcreate_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModel, is overwritten for the shape model ModelIDModelIDModelIDModelIDmodelID. Note that if the shape model ModelIDModelIDModelIDModelIDmodelID was read from file and if this file should be changed as well, the shape model ModelIDModelIDModelIDModelIDmodelID must again be written to file after the execution of the operator set_shape_model_paramset_shape_model_paramset_shape_model_paramSetShapeModelParamSetShapeModelParam.

'timeout'"timeout""timeout""timeout""timeout"

Sets the maximum runtime of the operators used to find the shape model ModelIDModelIDModelIDModelIDmodelID (e.g. find_shape_modelfind_shape_modelfind_shape_modelFindShapeModelFindShapeModel). This is especially useful in cases where a maximum cycle time has to be ensured. The 'timeout'"timeout""timeout""timeout""timeout" must be given in milliseconds. The temporal accuracy depends on several factors including the size of the model, the speed of your computer, and the 'timer_mode'"timer_mode""timer_mode""timer_mode""timer_mode" set via set_systemset_systemset_systemSetSystemSetSystem. Be aware that the runtime of the search increases by up to 10 percent with activated timeout. To disable the timeout you can either use a negative value or 'false'"false""false""false""false".

Parallelization

Multithreading type: exclusive (runs in parallel only with independent operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

ModelIDModelIDModelIDModelIDmodelID (input_control) shape_model → (integer)

Handle of the model.

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

Parameter names.

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

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

Parameter values.

Result

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