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）整数→（整数）
创建的计量对象的索引。