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）→（實/整數/字符串）
結果值。