Operator Reference

HALCON Operator Reference / Matching / Deformable

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

get_deformable_model_paramsT_get_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params (Operator)

get_deformable_model_paramsT_get_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params — Return the parameters of a deformable model.

Signature

get_deformable_model_params( : : ModelID, GenParamName : GenParamValue)

Herror T_get_deformable_model_params(const Htuple ModelID, const Htuple GenParamName, Htuple* GenParamValue)

void GetDeformableModelParams(const HTuple& ModelID, const HTuple& GenParamName, HTuple* GenParamValue)

HTuple HDeformableModel::GetDeformableModelParams(const HTuple& GenParamName) const

HTuple HDeformableModel::GetDeformableModelParams(const HString& GenParamName) const

HTuple HDeformableModel::GetDeformableModelParams(const char* GenParamName) const

HTuple HDeformableModel::GetDeformableModelParams(const wchar_t* GenParamName) const   ( Windows only)

static void HOperatorSet.GetDeformableModelParams(HTuple modelID, HTuple genParamName, out HTuple genParamValue)

HTuple HDeformableModel.GetDeformableModelParams(HTuple genParamName)

HTuple HDeformableModel.GetDeformableModelParams(string genParamName)

def get_deformable_model_params(model_id: HHandle, gen_param_name: MaybeSequence[str]) -> Sequence[Union[int, str, float]]

def get_deformable_model_params_s(model_id: HHandle, gen_param_name: MaybeSequence[str]) -> Union[int, str, float]

Description

The operator get_deformable_model_paramsget_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params allows to query parameters of the deformable model. The names of the desired parameters are passed in the generic parameter GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name, the corresponding values are returned in GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value.

The following parameters can be queried:

'cam_param'"cam_param""cam_param""cam_param""cam_param":

Internal parameters of the camera that is used for the calibrated case.

'cam_param_rect'"cam_param_rect""cam_param_rect""cam_param_rect""cam_param_rect":

Rectified internal parameters of the camera that is used for the calibrated case.

'reference_pose'"reference_pose""reference_pose""reference_pose""reference_pose":

Reference position and orientation of the calibrated deformable model. The returned pose describes the model plane that the user provided.

'model_pose'"model_pose""model_pose""model_pose""model_pose":

Reference position and orientation of the deformable model. The returned pose describes the pose of the internally used 3D metric model that was used for model generation. The pose refers to the model's center of gravity if not explicitly set with set_deformable_model_originset_deformable_model_originSetDeformableModelOriginSetDeformableModelOriginset_deformable_model_origin.

'angle_start'"angle_start""angle_start""angle_start""angle_start":

The smallest rotation angle of the model.

'angle_extent'"angle_extent""angle_extent""angle_extent""angle_extent":

The extent of the rotation angle of the model.

'angle_step'"angle_step""angle_step""angle_step""angle_step":

The angle step length of the model.

'scale_r_min'"scale_r_min""scale_r_min""scale_r_min""scale_r_min":

The minimum scale of the pattern in row direction.

'scale_r_max'"scale_r_max""scale_r_max""scale_r_max""scale_r_max":

The maximum scale of the pattern in row direction.

'scale_r_step'"scale_r_step""scale_r_step""scale_r_step""scale_r_step":

The scale step of the pattern in row direction.

'scale_c_min'"scale_c_min""scale_c_min""scale_c_min""scale_c_min":

The minimum scale of the pattern in column direction.

'scale_c_max'"scale_c_max""scale_c_max""scale_c_max""scale_c_max":

The maximum scale of the pattern in column direction.

'scale_c_step'"scale_c_step""scale_c_step""scale_c_step""scale_c_step":

The scale step of the pattern in column direction.

'num_levels'"num_levels""num_levels""num_levels""num_levels":

User-specified number of pyramid levels.

'optimization'"optimization""optimization""optimization""optimization":

Kind of optimization by reducing the number of model points.

'min_size'"min_size""min_size""min_size""min_size":

Minimum size of the deformable model edge.

'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast":

Minimum contrast of the objects in the search images.

'metric'"metric""metric""metric""metric":

Match metric.

'model_row'"model_row""model_row""model_row""model_row":

Row coordinate of origin in the radial undistorted model image.

'model_col'"model_col""model_col""model_col""model_col":

Column coordinate of origin in the radial undistorted model image.

'model_type'"model_type""model_type""model_type""model_type":

The type of the model: 'planar_uncalib'"planar_uncalib""planar_uncalib""planar_uncalib""planar_uncalib", 'planar_calib'"planar_calib""planar_calib""planar_calib""planar_calib" or 'local'"local""local""local""local".

'created_from_xld'"created_from_xld""created_from_xld""created_from_xld""created_from_xld":

Was the model created from XLD or from an image: 'created_from_xld'"created_from_xld""created_from_xld""created_from_xld""created_from_xld" or 'created_from_image'"created_from_image""created_from_image""created_from_image""created_from_image".

'get_deformable_model_contours_coord_system'"get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system":

Coordinate system ('image'"image""image""image""image" or 'world'"world""world""world""world") in which contours are returned when calling the operator get_deformable_model_contoursget_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours.

A detailed description of the parameters can be looked up with the operator create_planar_uncalib_deformable_modelcreate_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelcreate_planar_uncalib_deformable_model and create_planar_calib_deformable_modelcreate_planar_calib_deformable_modelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModelcreate_planar_calib_deformable_model or with the operator get_deformable_model_contoursget_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours.

Note that although the parameter ContrastContrastContrastcontrastcontrast can be determined automatically during the model creation, its value cannot be queried using get_deformable_model_paramsget_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params. Instead, the operator determine_deformable_model_paramsdetermine_deformable_model_paramsDetermineDeformableModelParamsDetermineDeformableModelParamsdetermine_deformable_model_params should be used to retrieve its value.

It is possible to query the values of several parameters with a single operator call by passing a tuple containing the names of all desired parameters to GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name. As a result a tuple of the same length with the corresponding values is returned in GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value. Note that this is solely possible for parameters that return only a single value.

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

ModelIDModelIDModelIDmodelIDmodel_id (input_control)  deformable_model → HDeformableModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the model.

GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control)  attribute.name(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Names of the generic parameters that are to be queried for the deformable model.

Default: 'angle_start' "angle_start" "angle_start" "angle_start" "angle_start"

List of values: 'angle_extent'"angle_extent""angle_extent""angle_extent""angle_extent", 'angle_start'"angle_start""angle_start""angle_start""angle_start", 'angle_step'"angle_step""angle_step""angle_step""angle_step", 'cam_param'"cam_param""cam_param""cam_param""cam_param", 'cam_param_rect'"cam_param_rect""cam_param_rect""cam_param_rect""cam_param_rect", 'created_from_xld'"created_from_xld""created_from_xld""created_from_xld""created_from_xld", 'get_deformable_model_contours_coord_system'"get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system", 'metric'"metric""metric""metric""metric", 'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast", 'min_size'"min_size""min_size""min_size""min_size", 'model_col'"model_col""model_col""model_col""model_col", 'model_pose'"model_pose""model_pose""model_pose""model_pose", 'model_row'"model_row""model_row""model_row""model_row", 'model_type'"model_type""model_type""model_type""model_type", 'num_levels'"num_levels""num_levels""num_levels""num_levels", 'optimization'"optimization""optimization""optimization""optimization", 'reference_pose'"reference_pose""reference_pose""reference_pose""reference_pose", 'scale_c_max'"scale_c_max""scale_c_max""scale_c_max""scale_c_max", 'scale_c_min'"scale_c_min""scale_c_min""scale_c_min""scale_c_min", 'scale_c_step'"scale_c_step""scale_c_step""scale_c_step""scale_c_step", 'scale_r_max'"scale_r_max""scale_r_max""scale_r_max""scale_r_max", 'scale_r_min'"scale_r_min""scale_r_min""scale_r_min""scale_r_min", 'scale_r_step'"scale_r_step""scale_r_step""scale_r_step""scale_r_step"

GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (output_control)  attribute.name(-array) → HTupleSequence[Union[int, str, float]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

Values of the generic parameters.

Result

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

Possible Predecessors

create_planar_uncalib_deformable_modelcreate_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelcreate_planar_uncalib_deformable_model, create_planar_calib_deformable_modelcreate_planar_calib_deformable_modelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModelcreate_planar_calib_deformable_model, create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModelcreate_local_deformable_model

Possible Successors

find_planar_uncalib_deformable_modelfind_planar_uncalib_deformable_modelFindPlanarUncalibDeformableModelFindPlanarUncalibDeformableModelfind_planar_uncalib_deformable_model, find_planar_calib_deformable_modelfind_planar_calib_deformable_modelFindPlanarCalibDeformableModelFindPlanarCalibDeformableModelfind_planar_calib_deformable_model

See also

set_deformable_model_paramset_deformable_model_paramSetDeformableModelParamSetDeformableModelParamset_deformable_model_param

Module

Matching

---

ClassesClasses | | Operators