get_metrology_object_result（算子）

get_metrology_object_result - 获取计量模型的测量结果。

get_metrology_object_result（:: MetrologyHandle，Index，Instance，GenParamName，GenParamValue：Parameter）

描述

get_metrology_object_result允许访问APPL_metrology_model获得的测量结果，用于计量模型MetrologyHandle的计量对象（有关2D计量的基本原理，请参阅create_metrology_model）。参数Index指定查询结果的计量对象。对于设置为“全部”的索引，将返回所有计量对象的结果。使用参数Instance可以指定，在Parameter中返回结果的哪些实例。通过将Instance设置为“all”返回所有实例的结果。可以使用不同的通用参数来控制Parameter中的返回值。通用参数名称在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中提供所需的参数名称，也可以单独查询测量的对象参数。

如果未设置摄像机参数且未设置测量平面，则可以单独查询以下参数，具体取决于它们是否可用于相应对象。注意，对于线，另外可以查询黑格尔法线形式的3个参数，即单位法线向量’nrow’，‘ncolumn’和距离坐标系原点的线的正交距离’距离’。距离的符号决定了原点所在线的边。

值列表：‘row’，‘column’，‘radius’，‘phi’，‘radius1’，‘radius2’，‘length1’，‘length2’，‘row_begin’，‘column_begin’，‘row_end’，'column_end '，‘nrow’，‘ncolumn’，‘distance’

如果设置了摄像机参数和测量平面，则以公制坐标返回参数，可以单独查询以下参数，具体取决于它们是否可用于相应对象。注意，对于线，另外可以查询黑格尔法线形式的3个参数，即，单位法线矢量’nx’，‘ny’和线与坐标系原点的正交距离’距离’。距离的符号决定了原点所在线的边。

值列表：‘x’，‘y’，‘radius’，‘phi’，‘radius1’，‘radius2’，‘length1’，‘length2’，‘radius1’，‘radius2’，‘length1’，'length2 '，‘x_begin’，‘y_begin’，‘x_end’，‘y_end’，‘nx’，‘ny’，‘distance’

‘获得分数’：

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

‘used_edges’：

要查询实际用于拟合度量对象的边缘点，可以选择以下GenParamValue值：

‘行’：

返回用于拟合度量对象的边的行坐标。

‘列’：

返回用于拟合度量对象的边的列坐标。

‘振幅’：

返回用于拟合度量对象的边缘的边缘幅度。

‘angle_direction’：

该参数确定由拟合产生的角度的旋转方向。将参数’angle_direction’设置为’正’，在物体的主轴和坐标系的水平轴之间以数学正方向（逆时针方向）指定角度。将参数’angle_direction’设置为’负’，在对象的主轴和坐标系的水平轴之间沿数学负方向（顺时针）指定角度。角度的结果以弧度返回。

价值清单：‘正面’，‘负面’

默认值：‘正面’

可以同时查询计量对象的几个计量对象的结果（参见参数索引）和几个实例（参见参数Instance）。在参数：第1计量对象的第1实例，第1计量对象的第2实例等，第2计量对象的第1实例，第2计量对象的第2实例等中依次返回结果。
多线程类型：可重入（与非独占运算符并行运行）。
多线程范围：全局（可以从任何线程调用）。
没有并行化处理。

参数

MetrologyHandle（input_control）metrology_model→（整数）
处理计量模型。

Index（input_control）整数（-array）→（整数/字符串）
计量对象的索引。
默认值：‘all’
建议值：‘all’，0,1,2

Instance（input_control）整数（-array）→（整数/字符串）
计量对象的实例。
默认值：‘all’
建议值：‘all’，0,1,2

GenParamName（input_control）attribute.name（-array）→（string）
通用参数的名称。
默认值：‘result_type’
值列表：‘angle_direction’，‘result_type’，‘used_edges’

GenParamValue（input_control）attribute.value（-array）→（string / real）
泛型参数的值。
默认值：‘all_param’
建议值：‘all_param’, ‘score’, ‘true’, ‘false’, ‘row’, ‘column’, ‘amplitude’, ‘radius’, ‘phi’, ‘radius1’, ‘radius2’, ‘length1’, ‘length2’, ‘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’
Parameter （output_control）real（-array）→（实/整数/字符串）
结果值。