区域分析
使用此工具根据特定特征来区域分析。
此工具要求前一工具可提供和发送区域。因此，“区域”参数必须与前一工具的适当结果连接。
因此，您首先需要在前一工具中提取要评估的区域，然后将生成的区域连接至此工具。
本工具可使用 easyTouch 和 easyTouch+。这意味着您可以在测量所有区域的同时，使用“最小特征值”和“最大特征值”筛选已测量区域，而相应的参数会自动调整。
要开始评估，请选择您要评估的特征。已经符合当前定义的参数设置的区域会以定义的“已选取”颜色高亮显示，默认为绿色。要选择其他区域，请将鼠标移至要评估的所需区域上方。MERLIC 将使用定义的 easyTouch 颜色来高亮显示包含在评估中具有相似属性的区域，例如，默认为蓝色。未包含在评估中的区域以定义的“已拒绝”颜色高亮显示，例如，默认为红色。如果要评估预览的区域，请单击区域以确认选择。特征的参数会自动调整以适应所选的区域。但是，您仍然可以在在相应的连接器中手动调整它们。
或者，您可以根据固定的特征值来区域分析。如果手动设置参数值，所有符合参数设置的区域将以定义的“正常”颜色高亮显示，例如，默认为绿色。
参数
基本参数
图像:
使用此参数将图像设置为背景。这通常应该是处理的特征（如轮廓或 ROI）所连接的图像。如果未连接图像，背景将会是黑色。
如果在此工具中将彩色图像用作输入图像，仅第一个通道（即红色通道）将用于处理。
这仅适用于涉及灰度值的参数“特征名称”和“特征值”的值，例如“最小灰度值”。
区域：
此参数表示要评估的区域。区域必须发送自前一工具。因此，您必须将参数与前一工具的相应结果连接。已连接的区域随后用于评估。区域的边缘以定义的“区域输入”颜色高亮显示，例如，默认为红色。这让识别要评估的区域变得更容易。
特征名称：
此参数定义为区域评估的特征名称。默认情况下设置为“面积”。这表示，将评估所选区域的面积，例如，它是否在允许的面积范围内。您可以在相应的连接器中选择另一个特征进行评估。
|
值 |
描述 |
取值范围 |
单位 |
|---|---|---|---|
|
数量 |
用于评估的区域的数量。 |
0 ... 10 000 000 |
- |
|
索引 |
区域输入阵列中基于 0 的索引将被用于评估。 此值可用于检查具有所请求索引的所有区域是否都可用。 |
0 ... 10 000 000 |
- |
|
面积 |
对区域的面积进行评估。 |
0 ... 10 000 000 |
像素 |
|
长短轴比值 |
区域的长短轴比值用于评估，即具有与区域相同纵横比的椭圆的长轴和短轴之间的关系。 |
1 ...10 000 000 |
- |
|
圆度 |
根据区域与圆的相似度对区域进行评估。 |
0 ..1 |
- |
|
凸度 |
根据区域的凸度对区域进行评估。 |
0 ..1 |
- |
|
紧密度 |
根据区域的紧密度对区域进行评估，即其轮廓和孔的路线。如果区域较长且存在孔，则其紧密度大于 1。 |
1 ...10 000 000 |
- |
|
矩形度 |
根据区域与矩形的相似度对区域进行评估。 |
0 ..1 |
- |
|
X 轴中点 |
根据区域列中心的坐标对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
Y 轴中点 |
根据区域行中心的坐标对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
宽度 |
根据与坐标轴平行的闭合矩形的宽度对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
高度 |
根据与坐标轴平行的闭合矩形的高度对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
内接矩形的宽度 |
根据符合区域的与轴平行的最大矩形的宽度对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
内接矩形的高度 |
根据符合区域的与轴平行的最大矩形的高度对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
内切圆半径 |
根据符合区域的最大内部圆的半径对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
外接圆半径 |
根据环绕区域的最小圆半径对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
X 轴起点 |
根据区域与坐标轴平行的闭合矩形左上角的列坐标对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
Y 轴起点 |
根据区域与坐标轴平行的闭合矩形左上角的行坐标对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
X 轴终点 |
根据区域与坐标轴平行的闭合矩形右下角的列坐标对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
Y 轴终点 |
根据区域与坐标轴平行的闭合矩形右下角的行坐标对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
方向 |
根据区域的方向对区域进行评估。 因为区域也可以在相反象限的相应角度进行选择，“特征值”结果返回的确定方向的范围为 -90°到 90°。 例如，如果“最小特征值”设置为 60° 且“最大特征值”设置为 120°，方向在 60° 到 90° 以及 -90° 到 -60° 之间的所有区域都分类为可被选取。 这是因为范围为 90 到 120 时，相反象限的相应角度范围为 -90 到 -60。
|
-180 ...180 |
度 |
|
孔面积 |
根据区域中孔的面积对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
孔数量 |
根据区域中孔的数量对区域进行评估。 |
0 ... 10 000 000 |
- |
|
最大直径 |
根据区域两个边界点之间的最大距离对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
长轴长度 |
根据每个区域的闭合矩形的第一半长对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
短轴长度 |
根据每个区域的闭合矩形的第二半长对区域进行评估。 |
0 ... 10 000 000 |
像素 |
|
最小灰度值 |
根据区域的最小灰度值对区域进行评估。 |
灰度值 |
|
|
最大灰度值 |
根据区域的最大灰度值对区域进行评估。 |
灰度值 |
|
|
平均灰度值 |
根据区域的平均灰度值对区域进行评估。 |
灰度值 |
|
|
灰度值中值 |
根据灰度值的中间值对区域进行评估。 |
灰度值 |
|
|
灰度值偏差 |
根据灰度值的偏差值对区域进行评估。 |
灰度值 |
最小特征值：
此参数定义评估特征的最小值。默认情况下设置为 150。它会在手动选择要评估的区域时自动调整。您还可以将此特征值用作评估的参考。在连接器中设置所需的值，所有符合参数设置的区域将突出显示为绿色。您可以将范围中的值设置为 0 到 10000000，但最高为 “最大特征值”。但是，实际取值范围取决于图像的像素类型和当前选定的特征，例如，如果为“特征名称”选择“方向”，值只能设置在 -180 到 180 之间。请参阅 “特征名称” 参数说明中的表格，了解每个特征可用的取值范围。
最大特征值:
此参数定义评估特征的最大值。默认情况下设置为 100,000。它会在手动选择要评估的区域时自动调整。您还可以将此特征值用作评估的参考。在连接器中设置所需的值，所有符合参数设置的区域将突出显示为绿色。您可以将范围中的值设置为 0 到 10,000,000，但最低为 “最小特征值”。但是，实际取值范围取决于图像的像素类型和当前选定的特征，例如，如果为“特征名称”选择“方向”，值只能设置在 -180 到 180 之间。请参阅 “特征名称” 参数说明中的表格，了解每个特征可用的取值范围。
其他参数
特征值容差：
此参数定义 “特征名称” 中定义的特征的容差值。此参数仅在 easyTouch 用于确定特征值时才有用。否则它不会影响区域评估。因此，根据参数“特征名称”的选定名称，连接器“特征值容差”显示为灰色。这意味着，只要您使用当前选定的名称，它就与使用无关。
该参数的处理方法有多种，取决于“特征名称”中选择的特征。对于一些特征，它可用于定义一个百分比值，表示区域的实际特征值可超过“最小特征值”和“最大特征值”中设置的值的程度。对于另一些特征，它可用于定义一个绝对值，表示实际特征值可超过最小和最大值的程度。对于“数量”和“索引”等其他特征，“特征值容差”将不作考虑。下表说明了受影响的特征，以及使用比值还是绝对值。
默认情况下“特征值容差”设置为 20。如果使用 easyTouch 确定选定区域的最大和最小特征值，MERLIC 将在评估中包括特征值位于定义容差值范围内的所有区域，例如，如果在“特征名称”中选择“宽度”特征，且“特征值容差”设置为 10，宽度上下浮动 10% 以内的所有区域都将包含在评估中。如果需要，您必须在连接器中手动更改其值。您可以将值设置为 0 到 100 的范围。
|
值 |
受影响？ |
百分比值 |
绝对值 |
|---|---|---|---|
|
数量 |
|
|
|
|
索引 |
|
|
|
|
面积 |
✔ |
✔ |
|
|
长短轴比值 |
✔ |
✔ |
|
|
圆度 |
✔ |
✔ |
|
|
凸度 |
✔ |
✔ |
|
|
紧密度 |
✔ |
✔ |
|
|
矩形度 |
✔ |
✔ |
|
|
X 轴中点 |
✔ |
|
✔ |
|
Y 轴中点 |
✔ |
|
✔ |
|
宽度 |
✔ |
✔ |
|
|
高度 |
✔ |
✔ |
|
|
内接矩形的宽度 |
✔ |
✔ |
|
|
内接矩形的高度 |
✔ |
✔ |
|
|
内切圆半径 |
✔ |
✔ |
|
|
外接圆半径 |
✔ |
✔ |
|
|
X 轴起点 |
✔ |
|
✔ |
|
Y 轴起点 |
✔ |
|
✔ |
|
X 轴终点 |
✔ |
|
✔ |
|
Y 轴终点 |
✔ |
|
✔ |
|
方向 |
✔ |
|
✔ |
|
孔面积 |
✔ |
✔ |
|
|
孔数量 |
✔ |
|
✔ |
|
最大直径 |
✔ |
✔ |
|
|
长轴长度 |
✔ |
✔ |
|
|
短轴长度 |
✔ |
✔ |
|
|
最小灰度值 |
✔ |
|
✔ |
|
最大灰度值 |
✔ |
|
✔ |
|
平均灰度值 |
✔ |
|
✔ |
|
灰度值中值 |
✔ |
|
✔ |
|
灰度值偏差 |
✔ |
|
✔ |
结果
基本结果
已选取的区域：
此结果返回已选取的区域。它们以定义的“正常”颜色设置显示，例如，默认为绿色。当评估的特征值符合定义的值范围时，会选取区域。
已拒绝的区域：
此结果返回已拒绝的区域。它们以定义的“已拒绝”颜色设置显示，例如，默认为红色。当评估的特征值不符合定义的值范围并因此位于允许的范围之外时，区域会被拒绝。
特征值：
此结果返回已区域分析的实际特征值。它们作为一个实数在一个 tuple 中返回。
所有区域已被选取：
此结果返回布尔值，指示是否已选取所有区域。如果所有已区域分析的特征值位于允许的值范围内，则返回值 1。如果至少一个区域的特征值不符合值范围，则返回布尔值 0。如果选择“索引”作为特征用于评估，此结果将指示具有“最小特征值”和“最大特征值”中定义的相应索引的所有区域是否都在图像可用。
工具状态：
“工具状态”返回有关工具状态的信息，因此可用于处理错误。请参阅主题工具状态结果，了解关于不同工具状态结果的更多信息。
其他结果
已选取区域的数量：
此结果返回已选取的区域的数量，即，其特征值符合允许的特征值范围的区域的数量。
已拒绝区域的数量：
此结果返回已拒绝的区域的数量，即，其特征值不符合允许的特征值范围的区域的数量。
处理时间:
此结果返回最近一次执行工具的持续时间（以毫秒为单位）。该结果作为附加结果提供。因此，默认情况下它是隐藏的，但是可以通过工具结果旁边的 
按钮显示。有关更多信息，处理时间请参工具参考中所阅部分。
应用程序示例
此工具用于以下 MERLIC Vision App 示例：
- check_correct_filling_on_3d_height_images.mvapp
- classify_and_inspect_wood.mvapp
- count_defect_clusters.mvapp
- segment_pill_defects.mvapp
- segment_pills_by_shape.mvapp
