add_metrology_object_generic（算子）

add_metrology_object_generic - 將計量對象添加到計量模型中。

add_metrology_object_generic（:: MetrologyHandle，Shape，ShapeParam，MeasureLength1，MeasureLength2，MeasureSigma，MeasureThreshold，Gen??ParamName，GenParamValue：Index）

描述

add_metrology_object_generic將類型為Shape的計量對象添加到計量模型中并準備矩形度量區域（有關2D度量的基本原理，請參閱create_metrology_model）。模型的句柄在MetrologyHandle中傳遞。 Shape指定將哪種類型的對象添加到計量模型中。運算符add_metrology_object_generic在參數Index中返回添加的度量對象的索引。請注意，add_metrology_object_generic在一個運算符中提供運算符add_metrology_object_circle_measure，add_metrology_object_ellipse_measure，add_metrology_object_rectangle2_measure和add_metrology_object_line_measure的功能。

可能的形狀

根據Shape中指定的對象，需要以下值：

‘圓形’：
類型圓的計量對象的幾何形狀由其中心（行，列）和半徑指定。

ShapeParam = [行，列，半徑]

‘旋轉矩形’：
矩形類型的計量對象的幾何形狀由其中心（行，列），主軸Phi的方向以及半邊長度Length1和Length2指定。 Phi的輸入值自動映射到間隔。

ShapeParam = [行，列，Phi，長度1，長度2]

‘橢圓’：
橢圓類型的計量對象的幾何形狀由其中心（行，列），主軸Phi的方向，較大的半軸Radius1的長度以及較小的半軸Radius2的長度來指定。 Phi的輸入值自動映射到間隔。

ShapeParam = [行，列，Phi，Radius1，Radius2]

‘線’：
類型線的度量對象的幾何形狀由其起點（RowBegin，ColumnBegin）的坐標和其終點的坐標（RowEnd，ColumnEnd）描述。

ShapeParam = [RowBegin，ColumnBegin，RowEnd，ColumnEnd]

測量區域的定義

add_metrology_object_generic還準備矩形度量區域。矩形測量區域垂直于物體的邊界。與對象邊界垂直和相切的測量區域的半邊長度在MeasureLength1和MeasureLength2中設置。測量區域的中心位于物體的邊界上。參數MeasureSigma指定運算符apply_metrology_model用于平滑圖像灰度值的標準偏差。可以使用參數MeasureThreshold選擇突出邊緣，該參數構成幅度的閾值，即邊緣的一階導數的絕對值。

通用參數

可以使用GenParamName和GenParamValue指定通用參數及其值。運算符set_metrology_object_param中可用的所有通用參數也可以在add_metrology_object_generic中設置。但請注意，對于許多應用程序，默認值足夠，無需進行任何調整。此外，GenParamName和GenParamValue的以下值僅適用于Shape =‘circle’和’ellipse’：

‘start_phi’：
該參數指定圓弧或橢圓弧的起點處的角度。對于橢圓，起點處的角度是相對于正主軸測量的，并且對應于橢圓的最小周圍圓。橢圓的實際起點是橢圓與相應圓點在主軸上的正交投影的交點。要創建閉合圓或橢圓，參數’start_phi’的值設置為0，參數’end_phi’的值設置為（帶正點順序）。輸入值自動映射到間隔。

值列表：0.0,0.78,6.28318

默認值：0.0

‘end_phi’：
該參數指定圓弧或橢圓弧的終點處的角度。對于橢圓，終點處的角度是相對于正主軸測量的，并且對應于橢圓的最小周圍圓。橢圓的實際終點是橢圓與相應圓點在主軸上的正交投影的交點。要創建閉合圓或橢圓，參數’start_phi’的值設置為0，參數’end_phi’的值設置為（帶正點順序）。輸入值自動內部映射到間隔。

值列表：0.0,0.78,6.28318

默認值：6.28318

‘point_order’：
該參數指定圓弧或橢圓弧的方向。對于值“正”，弧在數學正方向（逆時針方向）的’start_phi’和’end_phi’之間定義。對于值“負”，弧在數學上為負方向（順時針）定義在’start_phi’和’end_phi’之間。

價值清單：‘正面’，‘負面’

默認值：‘正面’

多線程類型：可重入（與非獨占運算符并行運行）。
多線程范圍：全局（可以從任何線程調用）。
沒有并行化處理。
此運算符修改以下輸入參數的狀態：
MetrologyHandle
沒有外部同步，可能無法在多個線程之間共享此參數的值。

參數

MetrologyHandle（input_control，狀態被修改）metrology_model→（整數）
處理計量模型。

Shape（input_control）attribute.name（-array）→（string）
要添加的計量對象的類型。
默認值：‘circle’
值列表：‘circle’，‘ellipse’，‘line’，‘rectangle2’
ShapeParam（input_control）attribute.value-array→（實/整數）
要添加的計量對象的參數。

MeasureLength1（input_control）數字→（實/整數）
垂直于邊界的測量區域的一半長度。
默認值：20.0
建議值：10.0,20.0,30.0
典型值范圍：1.0≤MeasureLength1≤511.0（lin）
最小增量：1.0
建議增量：10.0

MeasureLength2（input_control）數字→（實/整數）
與邊界相切的測量區域的一半長度。
默認值：5.0
建議值：3.0,5.0,10.0
典型值范圍：1.0≤MeasureLength2≤511.0（lin）
最小增量：1.0
建議增量：10.0

MeasureSigma（input_control）數字→（實/整數）
Sigma的高斯函數用于平滑。
默認值：1.0
建議值：0.4,0.6,0.8,1.0,1.5,2.0,3.0,4.0,5.0,7.0,10.0
典型值范圍：0.4≤MeasureSigma≤100（lin）
最小增量：0.01
建議增量：0.1
限制：（0.4 <= MeasureSigma）&&（MeasureSigma <= 100）

MeasureThreshold（input_control）數字→（實/整數）
最小邊緣幅度。
默認值：30.0
建議值：5.0,10.0,20.0,30.0,40.0,50.0,60.0,70.0,90.0,110.0
典型值范圍：1≤MeasureThreshold≤255（lin）
最小增量：0.5
建議增量：2

GenParamName（input_control）attribute.name（-array）→（string）
通用參數的名稱。
默認值： []
值列表：‘distance_threshold’，‘end_phi’，‘instances_outside_measure_regions’，‘max_num_iterations’，‘measure_distance’，‘measure_interpolation’，‘measure_select’，‘measure_transition’，‘min_score’，‘num_instances’，‘num_measures’，'point_order '，‘rand_seed’，‘start_phi’

GenParamValue（input_control）attribute.value（-array）→（real / integer / string）
通用參數的值。
默認值： []
建議值：1,2,3,4,5,10,20，‘all’，‘true’，‘false’，‘first’，‘last’，‘positive’，‘negative’，‘uniform’，’ nearest_neighbor’，‘bilinear’，‘bicubic’
索引（output_control）整數→（整數）
創建的計量對象的索引。