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允许控制计量对象如何返回以及返回什么结果。支持一次性查询计量对象的所有测量参数、单独查询具体参数或查询该计量对象的得分。
`获取所有参数`:
如果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 Align image based on point-to-line correspondences for print quality inspection with a variation model
measure_stamping_part.hdev Measure circles, rectangles, and lines of a stamping part using an aligned metroloy model (calibrated)
apply_metrology_model_diamond.hdev Measure the angle of a diamond's cut using a metrology model
apply_metrology_model.hdev Measure circular and rectangular pads using a metrology model
Operators