add_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measure添加计量对象矩形2测量（算子）

名称

add_metrology_object_rectangle2_measureT_add_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measure — 将矩形添加到计量模型中。

签名

add_metrology_object_rectangle2_measure( : : MetrologyHandle, Row, Column, Phi, Length1, Length2, MeasureLength1, MeasureLength2, MeasureSigma, MeasureThreshold, GenParamName, GenParamValue : Index)

描述

add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measure 将类型为矩形的计量对象添加到计量模型中，并准备矩形测量区域。该模型的句柄通过 MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle 传递。

有关二维计量概念的说明，请参阅二维计量一章的引言。

矩形类型的计量对象的几何形状由其中心点 (RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn)、主轴方向 PhiPhiPhiPhiphiphi 以及半边长度 Length1Length1Length1Length1length1length_1 和 Length2Length2Length2Length2length2length_2。PhiPhiPhiPhiphiphi 的输入值会自动映射到区间。矩形测量区域垂直于矩形边界。垂直和相切于矩形边界的测量区域半边长分别通过 MeasureLength1MeasureLength1MeasureLength1MeasureLength1measureLength1measure_length_1 和 MeasureLength2MeasureLength2MeasureLength2MeasureLength2measureLength2measure_length_2设定。测量区域中心点位于矩形边界上。参数 MeasureSigmaMeasureSigmaMeasureSigmaMeasureSigmameasureSigmameasure_sigma 指定标准差值，该值由 apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModelapply_metrology_model 算子用于平滑图像灰度值。突出的边缘可通过参数 MeasureThresholdMeasureThresholdMeasureThresholdMeasureThresholdmeasureThresholdmeasure_threshold 进行选择，该参数构成对振幅的阈值，即边缘一阶导数的绝对值。

此外，您还可以使用 GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name 和 GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value 调整某些通用参数。具体而言，所有可在 set_metrology_object_paramset_metrology_object_paramSetMetrologyObjectParamSetMetrologyObjectParamSetMetrologyObjectParamset_metrology_object_param 算子中使用的通用参数均可设置。但请注意，对于许多应用而言，默认值已足够使用，无需进行调整。

算子 add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measure 将返回在参数 IndexIndexIndexIndexindexindex 中添加的计量对象的索引。

执行信息

多线程类型：可重入（与非独占算子并行运行）。
多线程作用域：全局（可从任何线程调用）。
未采用并行化处理。

此算子修改后续输入参数的状态：

MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle

在执行此算子时，若该参数值需在多个线程间使用，则必须对其访问进行同步。

参数

MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle (输入控制，状态被修改) metrology_model → (handle)

计量模型的句柄。

RowRowRowRowrowrow (输入控制) rectangle2.center.y(-array) → (real / integer)

矩形中心的行（或 Y ）坐标。

ColumnColumnColumnColumncolumncolumn (输入控制) rectangle2.center.x(-array) → (real / integer)

矩形中心的列（或 X ）坐标。

PhiPhiPhiPhiphiphi (输入控制) rectangle2.angle.rad(-array) → (real / integer)

主轴方向 [弧度]。

Length1Length1Length1Length1length1length_1 (输入控制) rectangle2.hwidth(-array) → (real / integer)

矩形较长的半边长度。

Length2Length2Length2Length2length2length_2 (输入控制) rectangle2.hheight(-array) → (real / integer)

矩形较短的半边长度。

MeasureLength1MeasureLength1MeasureLength1MeasureLength1measureLength1measure_length_1 (输入控制) number → (real / integer)

与边界垂直的测量区域长度的一半。

默认值： 20.0

建议值： 10.0, 20.0, 30.0

值范围： 1.0 ≤ MeasureLength1 MeasureLength1 MeasureLength1 MeasureLength1 measureLength1 measure_length_1

最小增量： 1.0

建议增量： 10.0

限制： MeasureLength1 < Length1 && MeasureLength1 < Length2

MeasureLength2MeasureLength2MeasureLength2MeasureLength2measureLength2measure_length_2 (输入控制) number → (real / integer)

与边界相切的测量区域长度的一半。

默认值： 5.0

建议值： 3.0, 5.0, 10.0

值范围： 1.0 ≤ MeasureLength2 MeasureLength2 MeasureLength2 MeasureLength2 measureLength2 measure_length_2

最小增量： 1.0

建议增量： 10.0

MeasureSigmaMeasureSigmaMeasureSigmaMeasureSigmameasureSigmameasure_sigma (输入控制) number → (real / integer)

高斯函数的平滑西格玛（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 MeasureSigma MeasureSigma MeasureSigma measureSigma measure_sigma ≤ 100.0

最小增量： 0.01

建议增量： 0.1

MeasureThresholdMeasureThresholdMeasureThresholdMeasureThresholdmeasureThresholdmeasure_threshold (输入控制) number → (real / integer)

最小边缘振幅。

默认值： 30.0

建议值： 5.0, 10.0, 20.0, 30.0, 40.0, 50.0, 60.0, 70.0, 90.0, 110.0

值范围： 1 ≤ MeasureThreshold MeasureThreshold MeasureThreshold MeasureThreshold measureThreshold measure_threshold ≤ 255 (lin)

最小增量： 0.5

建议增量： 2

GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (输入控制) attribute.name-array → (string)

通用参数的名称。

默认值： []

值列表： 'distance_threshold'"distance_threshold""distance_threshold""distance_threshold""distance_threshold""distance_threshold", 'instances_outside_measure_regions'"instances_outside_measure_regions""instances_outside_measure_regions""instances_outside_measure_regions""instances_outside_measure_regions""instances_outside_measure_regions", 'max_num_iterations'"max_num_iterations""max_num_iterations""max_num_iterations""max_num_iterations""max_num_iterations", 'measure_distance'"measure_distance""measure_distance""measure_distance""measure_distance""measure_distance", 'measure_interpolation'"measure_interpolation""measure_interpolation""measure_interpolation""measure_interpolation""measure_interpolation", 'measure_select'"measure_select""measure_select""measure_select""measure_select""measure_select", 'measure_transition'"measure_transition""measure_transition""measure_transition""measure_transition""measure_transition", 'min_score'"min_score""min_score""min_score""min_score""min_score", 'num_instances'"num_instances""num_instances""num_instances""num_instances""num_instances", 'num_measures'"num_measures""num_measures""num_measures""num_measures""num_measures", 'rand_seed'"rand_seed""rand_seed""rand_seed""rand_seed""rand_seed"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (输入控制) attribute.value-array → (real / integer / string)

通用参数的值。

默认值： []

建议值： 1, 2, 3, 4, 5, 10, 20, 'all'"all""all""all""all""all", 'true'"true""true""true""true""true", 'false'"false""false""false""false""false", 'first'"first""first""first""first""first", 'last'"last""last""last""last""last", 'positive'"positive""positive""positive""positive""positive", 'negative'"negative""negative""negative""negative""negative", 'uniform'"uniform""uniform""uniform""uniform""uniform", 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor", 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear", 'bicubic'"bicubic""bicubic""bicubic""bicubic""bicubic"

IndexIndexIndexIndexindexindex (输出控制) integer → (integer)

创建的计量对象索引。

结果

add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measure 算子在参数正确时返回 2 ( H_MSG_TRUE )。如有必要，则抛出异常。