get_metrology_object_result 得到计量模型的测量结果

get_metrology_object_result (Operator)

名称

get_metrology_object_result 得到计量模型的测量结果

签名

get_metrology_object_result( : : MetrologyHandle, Index, Instance, GenParamName, GenParamValue : Parameter)

描述

get_metrology_object_result允许访问由apply_metrology_model为计量模型metrology handle的计量对象获得的测量结果。

有关二维计量概念的说明，请参阅二维计量章的介绍。

参数Index指定查询结果的计量对象。如果索引设置为'all'，则返回所有计量对象的结果。通过参数Instance，可以指定返回结果的实例。通过将Instance设置为'all'，返回所有实例的结果。可以使用不同的泛型参数来控制参数中的返回值。泛型参数名在GenParamName中传递。相应的值在GenParamValue中传递。可能的参数和值如下。

“result_type”:
如果GenParamName设置为'result_type'，那么GenParamValue允许控制计量对象如何返回以及返回什么结果。支持一次性查询计量对象的所有测量参数、单独查询具体参数或查询该计量对象的得分。

all_param`获取所有参数`:
如果GenParamValue设置为'all_param'，则返回一个计量对象的所有测量参数。如果已经设置了相机参数和姿态(参见set_metrology_model_param)，结果将以度量坐标返回，否则以像素返回。

对于圆，返回值是圆心的坐标和半径。顺序分别是['row'， 'column'， 'radius']或['x'， 'y'， 'radius']。

对于椭圆，返回值是椭圆的中心坐标、长轴'phi'的方向、较大的半轴'radius1'的长度和较小的半轴'radius2'的长度。顺序分别是['row'， 'column'， 'phi'， 'radius1'， 'radius2']或['x'， 'y'， 'phi'， 'radius1'， 'radius2']。

对于一行，返回该行的起点和终点。订单(‘row_begin’,‘column_begin’,‘row_end’,‘column_end]或[‘x_begin’,‘y_begin’,‘x_end’,‘y_end’)

对于矩形，返回值是矩形中心的坐标、主轴'phi'的方向、较大半边的长度'length1'和较小半边的长度'length2'。顺序分别是['row'， 'column'， 'phi'， 'length1'， 'length2']或['x'， 'y'， 'phi'， 'length1'， 'length2']。

`获取特定参数`:
也可以通过在GenParamName中提供所需的参数名来单独查询测量的对象参数。

在没有设置摄像机参数和测量平面的情况下，根据是否对对应对象可用，可以分别查询以下参数。注意，对于直线，另外可以查询hessian范式的3个参数，即单位法向量` nrow `、` ncolumn `和直线到坐标系原点的正交距离` distance `。距离的符号决定了原点位于直线的哪一边。

值列表:` row `、` column `、` radius `、` phi `、` radius1 `、` radius2 `、` length1 `、` length2 `、` row_begin `、` column_begin `、` row_end `、` column_end `、` nrow `、` ncolumn `、` distance `

如果设置了摄像机参数和测量平面，则参数以度量坐标形式返回，以下参数可以单独查询，取决于它们是否对各自的对象可用。注意，对于直线，另外可以查询hessian范式的3个参数，即单位法向量` nx `， ` ny `和直线到坐标系原点的正交距离` distance `。距离的符号决定了原点位于直线的哪一边。

的值列表:“x”、“y”,“半径”、“φ”,‘radius1’,‘radius2’,‘length1’,‘length2’,‘radius1’,‘radius2’,‘length1’,‘length2’,‘x_begin’,‘y_begin’,‘x_end’,‘y_end’,“nx”,“纽约”,“距离”

`获取分数`:
如果GenParamName设置为'score'，则返回拟合得分。得分表示用于计算结果的测量数量除以测量区域的最大数量。

“used_edges”:
要查询实际用于拟合的计量对象的边缘点，可以在GenParamValue中选择以下值:

“连续”:
返回用于拟合计量对象的边的行坐标。

“列”:
返回用于拟合计量对象的边缘的列坐标。

“振幅”:
返回用于拟合计量对象的边缘振幅。

“angle_direction”:
该参数决定了拟合得到的角度的旋转方向。将参数` angle_direction `设置为` posit . direction `

执行信息

多线程类型:可重入(与非独占操作符并行运行)。
多线程作用域:全局作用域(可以从任何线程调用)。
没有并行化处理。

参数

MetrologyHandle (input_control 输入参数)  

        Handle of the metrology model.计量模型的句柄

Index (input_control)  

        Index of the metrology object. 计量对象的索引

        默认值： 'all'

        建议值  'all', 0, 1, 2

Instance (input_control)  

        计量对象的实例

        Default value: 'all' 默认值： 'all'

        建议值  'all', 0, 1, 2

GenParamName (input_control)  

        Name of the generic parameter 参数的名称。

        默认值：'result_type'

        值列表:` angle_direction `， ` result_type `， ` used_edges `

GenParamValue (input_control)  

        Value of the generic parameter. 参数的值

       默认值： 'all_param'

        建议值：

                'all_param',全部参数

                'score',分数

                'true',

                'false',

                'row',行坐标

                'column',列坐标

                'amplitude',振幅

                 'radius',半径

                'phi', 方向

                'radius1',

                'radius2',

                 'length1',长度1

                'length2',长度2

                'row_begin',起始点的行坐标

                'column_begin',起始点的列坐标

                 'row_end',结束点的行坐标

                 'column_end',结束点的列坐标

                'nrow',

                'ncolumn',

                'distance',

                 'x',

                 'y',

                'x_begin',

                'y_begin',

                'x_end',

                'y_end',

                'nx',

                 'ny',

                 'positive',

                 'negative'

示例

*获取行的起始点坐标
get_metrology_object_result (MetrologyHandle, Index, 'all', 'result_type', 'row_begin', row1)
*获取行的结束点坐标
get_metrology_object_result (MetrologyHandle, Index, 'all', 'result_type', 'row_end', row2)
*获取列的起始点坐标
get_metrology_object_result (MetrologyHandle, Index, 'all', 'result_type', 'column_begin', column1)
*获取列的结束点坐标
get_metrology_object_result (MetrologyHandle, Index, 'all', 'result_type', 'column_end', column2)

Parameter (output_control)  输出参数

        Result values. 结果值

结果

如果参数有效，操作符get_metrology_object_result返回值2 (H_MSG_TRUE)。如果有必要，会抛出一个异常。

Possible Predecessors

apply_metrology_model

Possible Successors

clear_metrology_model

See also

get_metrology_object_result_contour, get_metrology_object_measures

Module

2D Metrology

HDevelop例程

point_line_to_hom_mat2d.hdev        基于点对行对应关系的变分模型打印质量检测图像对齐方法
measure_stamping_part.hdev        测量圆，矩形，和线冲压件使用对齐的度量衡模型(校准)
apply_metrology_model_diamond.hdev        测量角度的钻石切割使用一个计量模型
apply_metrology_model.hdev        使用计量模型测量圆形和矩形焊盘