get_deformable_model_paramsT_get_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params (算子)
名称
get_deformable_model_paramsT_get_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params — 返回可变形模型的参数。
签名
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]
描述
算子 get_deformable_model_paramsget_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params allows to query
parameters of the deformable model. The names of the desired
parameters are passed in the generic parameter
GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name, the corresponding values are returned in
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value。
The following parameters can be queried:
- 'cam_param'"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""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_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""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.
- 'angle_start'"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""angle_extent":
-
The extent of the rotation angle of the model.
- 'angle_step'"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""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""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""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""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""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""scale_c_step":
-
The scale step of the pattern in column direction.
- 'num_levels'"num_levels""num_levels""num_levels""num_levels""num_levels":
-
User-specified number of pyramid levels.
- 'optimization'"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""min_size":
-
Minimum size of the deformable model edge.
- 'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast""min_contrast":
-
Minimum contrast of the objects in the search images.
- 'metric'"metric""metric""metric""metric""metric":
-
Match metric.
- 'model_row'"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""model_col":
-
Column coordinate of origin in the radial undistorted model image.
- 'model_type'"model_type""model_type""model_type""model_type""model_type":
-
The type of the model: 'planar_uncalib', 'planar_calib' or 'local'.
- 'created_from_xld'"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'
or '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""get_deformable_model_contours_coord_system":
-
Coordinate system ('image'"image""image""image""image""image" or 'world'"world""world""world""world""world") in which
contours are returned when calling the operator
get_deformable_model_contoursget_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours。
A detailed description of the parameters can be looked up with the
operator create_planar_uncalib_deformable_modelcreate_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelcreate_planar_uncalib_deformable_model and
create_planar_calib_deformable_modelcreate_planar_calib_deformable_modelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModelcreate_planar_calib_deformable_model or with the operator
get_deformable_model_contoursget_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours。
Note that although the parameter ContrastContrastContrastContrastcontrastcontrast can be determined
automatically during the model creation, its value cannot be queried using
get_deformable_model_paramsget_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params.
Instead, the operator determine_deformable_model_paramsdetermine_deformable_model_paramsDetermineDeformableModelParamsDetermineDeformableModelParamsDetermineDeformableModelParamsdetermine_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 GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name. As a result a tuple of
the same length with the corresponding values is returned in
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value. Note that this is solely possible for
parameters that return only a single value.
执行信息
- 多线程类型:可重入(与非独占算子并行运行)。
- 多线程作用域:全局(可从任何线程调用)。
- 未采用并行化处理。
参数
ModelIDModelIDModelIDModelIDmodelIDmodel_id (输入控制) deformable_model → HDeformableModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the model.
GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (输入控制) attribute.name(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Names of the generic parameters that
are to be queried for the deformable model.
默认值:
'angle_start'
"angle_start"
"angle_start"
"angle_start"
"angle_start"
"angle_start"
值列表:
'angle_extent'"angle_extent""angle_extent""angle_extent""angle_extent""angle_extent", 'angle_start'"angle_start""angle_start""angle_start""angle_start""angle_start", 'angle_step'"angle_step""angle_step""angle_step""angle_step""angle_step", 'cam_param'"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""cam_param_rect", 'created_from_xld'"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""get_deformable_model_contours_coord_system", 'metric'"metric""metric""metric""metric""metric", 'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast""min_contrast", 'min_size'"min_size""min_size""min_size""min_size""min_size", 'model_col'"model_col""model_col""model_col""model_col""model_col", 'model_pose'"model_pose""model_pose""model_pose""model_pose""model_pose", 'model_row'"model_row""model_row""model_row""model_row""model_row", 'model_type'"model_type""model_type""model_type""model_type""model_type", 'num_levels'"num_levels""num_levels""num_levels""num_levels""num_levels", 'optimization'"optimization""optimization""optimization""optimization""optimization", 'reference_pose'"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_max", 'scale_c_min'"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_c_step", 'scale_r_max'"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_min", 'scale_r_step'"scale_r_step""scale_r_step""scale_r_step""scale_r_step""scale_r_step"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (输出控制) attribute.name(-array) → HTupleSequence[Union[int, str, float]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
通用参数的值。
结果
如果参数有效,算子
get_deformable_model_paramsget_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params 返回值 2 ( H_MSG_TRUE )。如有必要,则抛出异常。
可能的前趋
create_planar_uncalib_deformable_modelcreate_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelcreate_planar_uncalib_deformable_model,
create_planar_calib_deformable_modelcreate_planar_calib_deformable_modelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModelcreate_planar_calib_deformable_model,
create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModelCreateLocalDeformableModelcreate_local_deformable_model
可能的后继
find_planar_uncalib_deformable_modelfind_planar_uncalib_deformable_modelFindPlanarUncalibDeformableModelFindPlanarUncalibDeformableModelFindPlanarUncalibDeformableModelfind_planar_uncalib_deformable_model,
find_planar_calib_deformable_modelfind_planar_calib_deformable_modelFindPlanarCalibDeformableModelFindPlanarCalibDeformableModelFindPlanarCalibDeformableModelfind_planar_calib_deformable_model
另见
set_deformable_model_paramset_deformable_model_paramSetDeformableModelParamSetDeformableModelParamSetDeformableModelParamset_deformable_model_param
模块
匹配