HALCON 算子 create_planar_calib_deformable_model_xld

HALCON 算子 create_planar_calib_deformable_model_xld
准备一个可变形模型，用于平面标定匹配XLD轮廓。
签名

create_planar_calib_deformable_model_xld（Contours：：CamParam、ReferencePose、NumLevel、AngleStart、AngleExtent、Angle.、ScaleRMin、ScaleRMax、ScaleRStep、ScaleCMin、ScaleCStep、.、Metric、MinContrast、ParamName、ParamValue：ModelID）
描述
操作符create_planar_calib_deformable_model_xld根据在Contours中传递的XLD轮廓创建用于平面校准匹配的可变形模型。XLD轮廓表示要搜索的对象的灰度值边缘。与从模板图像创建可变形模型的操作符create_planar_calib_deformable_model不同，操作符create_planar_calib_deformable_model_xld从XLD轮廓创建可变形模型。注意，操作者期望轮廓在度量世界坐标系中。这与create_planar_uncalib_deformable_model_xld形成对比，其中在图像坐标中提供等高线。
此外，模型的原点（参考点）直接从所提供的轮廓。这与create_planar_uncalib_deformable_model_xld形成对比，其中使用了轮廓的最小周围矩形的重心。世界坐标系中的一个不同的起源可以用set_deformable_model_origin.模型来设定。
为了进一步解释平面可变形模型及其参数，我们参考create_planar_uncalib_deformable_model和create_planar_calib_deformable_model的描述。
敬告
注意，与操作符create_planar_calib_deformable_model相反，不可能指定模型组件的最小大小。为了避免模型中的小模型组件，可以在使用操作符select_contours_xld调用create_planar_calib_deformable_model_xld之前消除短轮廓。

Parameters
Contours (input_object) xld_cont(-array) → object
Input contours that will be used to create the model. 将用于创建模型的输入轮廓。

CamParam (input_control) number-array → (real / integer)
The parameters of the interior orientation of the camera. 摄像机的内部定位参数。
Number of elements: (CamParam == 8) || (CamParam == 12)

ReferencePose (input_control) pose-array → (real / integer)
The reference pose of the object. 对象的参考姿态。

NumLevels (input_control) integer → (integer / string)
Maximum number of pyramid levels. 金字塔级别的最大数目。
Default value: ‘auto’
List of values: ‘auto’, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

AngleStart (input_control) angle.rad → (real)
Smallest rotation of the pattern. 在最小的旋转模式。
Default value: -0.39
Suggested values: -3.14, -1.57, -0.79, -0.39, -0.20, 0.0

AngleExtent (input_control) angle.rad → (real)
Extent of the rotation angles. 在旋转的角。
Default value: 0.79
Suggested values: 6.29, 3.14, 1.57, 0.79, 0.39
Restriction: AngleExtent >= 0

AngleStep (input_control) angle.rad → (real / string)
Step length of the angles (resolution). 角度的步长（分辨率）。
Default value: ‘auto’
Suggested values: ‘auto’, 0.0175, 0.0349, 0.0524, 0.0698, 0.0873
Restriction: (AngleStep > 0) && (AngleStep <= (pi / 16))

ScaleRMin (input_control) number → (real)
Minimum scale of the pattern in the row direction. 行方向上的图案的最小尺度。
Default value: 1.0
Suggested values: 0.5, 0.6, 0.7, 0.8, 0.9, 1.0
Restriction: ScaleRMin > 0

ScaleRMax (input_control) number → (real)
Maximum scale of the pattern in the row direction. 在行方向上的图案的最大尺度。
Default value: 1.0
Suggested values: 1.0, 1.1, 1.2, 1.3, 1.4, 1.5
Restriction: ScaleRMax >= ScaleRMin

ScaleRStep (input_control) number → (real / string)
Scale step length (resolution) in the row direction. 在行方向上的尺度步长（分辨率）。
Default value: ‘auto’
Suggested values: ‘auto’, 0.01, 0.02, 0.05, 0.1, 0.15, 0.2
Restriction: ScaleRStep > 0

ScaleCMin (input_control) number → (real)
Minimum scale of the pattern in the column direction. 在列方向上的图案的最小尺度。
Default value: 1.0
Suggested values: 0.5, 0.6, 0.7, 0.8, 0.9, 1.0
Restriction: ScaleCMin > 0

ScaleCMax (input_control) number → (real)
Maximum scale of the pattern in the column direction. 在列方向上的图案的最大尺度。
Default value: 1.0
Suggested values: 1.0, 1.1, 1.2, 1.3, 1.4, 1.5
Restriction: ScaleCMax >= ScaleCMin

ScaleCStep (input_control) number → (real / string)
Scale step length (resolution) in the column direction. 在列方向上的刻度步长（分辨率）。
Default value: ‘auto’
Suggested values: ‘auto’, 0.01, 0.02, 0.05, 0.1, 0.15, 0.2
Restriction: ScaleCStep > 0

Optimization (input_control) string(-array) → (string)
Kind of optimization used for generating the model. 一种用于生成模型的优化方法。
Default value: ‘auto’
List of values: ‘auto’, ‘none’, ‘point_reduction_low’, ‘point_reduction_medium’, ‘point_reduction_high’
Metric (input_control) string → (string)
Match metric.
Default value: ‘ignore_local_polarity’
List of values: ‘use_polarity’, ‘ignore_global_polarity’, ‘ignore_part_polarity’, ‘ignore_local_polarity’, ‘ignore_color_polarity’

MinContrast (input_control) number → (integer)
Minimum contrast of the objects in the search images. 搜索图像中物体的最小对比度。
Default value: 5
Suggested values: 1, 2, 3, 5, 7, 10, 20, 30, 40

ParamName (input_control) string-array → (string)
The generic parameter names. 泛型参数名。
Default value: []
List of values: [], ‘part_size’

ParamValue (input_control) integer-array → (integer / real / string)
Values of the generic parameter. 泛型参数的值。
Default value: []
List of values: [], ‘small’, ‘medium’, ‘big’

ModelID (output_control) deformable_model → (integer)
Handle of the model. 模型的句柄。

Possible Predecessors 前置函数
read_contour_xld_dxf, edges_sub_pix, select_contours_xld
Possible Successors后置函数
find_planar_calib_deformable_model