InspectEdgeTrainBeadPath

InspectEdgeTrainBeadPath 函数用于查找基于边缘的焊珠特征的中心，并创建一条折线来跟踪检测到的焊珠路径的路径。该工具创建的折线路径可用作其他InspectEdge 函数（例如 InspectEdgeWidth 函数）的输入，以确定焊珠中是否存在位置缺陷、宽度缺陷或间隙。

InspectEdgeTrainBeadPath 概述

焊珠路径是一对连续的边缘，它们定义了具有不同像素值的两个区域之间的边界（路径并不总是必须显示为循环）。通常，焊珠是指油墨或胶水路径，或焊缝，由其宽度或厚度及其位置定义。InspectEdgeTrainBeadPath 函数与其他 InspectEdge 函数一起，可以应用于焊珠跟踪应用中，其中焊珠路径依图像而异，或者验证焊珠路径是否始终位于同一位置。

在焊珠跟踪应用程序中，InspectEdgeTrainBeadPath 函数与 InspectedEdge 函数和 InspectedEdgeWidth 函数结合使用，能够验证焊珠路径是否始终以均匀的图案排列，既不太厚也不太薄。这些函数将创建一条多段线，定义沿焊珠的路径，然后确定焊珠路径中是否存在过厚、过薄或完全缺失的区域。

在基于位置的焊珠跟踪应用程序中，相同的函数能够验证焊珠路径始终位于相同的位置，具有相同的厚度，并且沿路径没有位置变化。

注意:要在任一应用程序中使用，必须将 InspectEdgeTrainBeadPath 函数用作 InspectEdge 函数的外部区域或路径参数的输入，并且 InspectEdgeWidth 函数必须在其 InspectEdge 参数中引用 InspectEdge 函数输出的 Inspect 数据结构。

InspectEdgeTrainBeadPath 输入

参数

说明

图像

This parameter must reference a spreadsheet cell that contains an 图像 data structure; by default, this parameter references A0, the cell containing the data structure. This parameter can also reference other Image data structures, such as those returned by the 图像 Vision Data Access functions or 坐标变换函数.

固定

定义相对于固定输入或视觉工具函数的图像坐标系输出的关注区域 (ROI)。根据“固定坐标”来设置的 ROI 可以确保如果“固定坐标” 被旋转或转换，相应的 ROI 也会根据“固定坐标”而旋转或转换。

默认设置为(0,0,0)，图像的最左上方。

X (默认值= 0)	图像坐标中的 X 偏移。
Y (默认值 = 0)	图像坐标中的 Y 偏移。
Theta (默认值 = 0)	图像坐标系中图像 X 轴的旋转。（顺时针 +/-360 度）

区域

也称为关注区域（ROI），指定图像中进行边缘分析的区域；创建一个可以变换和旋转的矩形区域交互式图形模式。如果选择了该参数，在属性表的工具栏中按“最大化区域”按钮时，区域会被自动拉伸并覆盖整个图像。黄色虚线表示找到边缘的方向。

X	在固定坐标中，偏移原点的 x 值。
Y	在固定坐标中，偏移原点的 y 值。
宽度	沿区域 x 轴的尺寸。
高度	沿区域 y 轴的尺寸。
角度	在固定坐标上的方向。
曲线	在区域 x 轴和相对的边界线之间的角度偏差。

注意:固定和区域参数必须在图像的范围内定义；否则，该函数将返回 #ERR。

外部区域或路径

指定对包含Annulus、区域、EditAnnulus、EditMaskedRegion、EditPolylinePath 或EditRegion 函数的电子表格单元格的单元格引用。使用此参数时，该函数将忽略区域和固定设置并检查引用区域指定的图像区域。.

注意:

如果此参数已设置为对外部区域的引用，要使用函数的内部区域，必须通过输入值 0 代替单元格引用手动将此参数设置为零。否则，该函数将继续引用外部区域。
如果此参数引用 EditPolylinePath，则该函数不能用作对 InspectEdgeForDefect 或 InspectEdgePosition 函数的引用，这将返回 #ERR。

卡尺

指定 ROI 中用于定义可检测缺陷和/或间隙大小的卡尺阵列。可检测缺陷或间隙的大小由可检测边缘的数量决定，该数量由沿边缘放置的卡尺的数量决定。当 InspectEdge 单元格突出显示或显示参数设置为全部显示时，卡尺在 ROI 内显示为红色矩形，在卡尺内检测到的边缘显示为绿色。

注意:根据检查的缺陷类型，卡尺可能会叠加放置。但是，在 ROI 中应用的卡尺越多，函数的执行时间就会越长。

高度	指定要沿检查方向要分析的每个卡尺的像素数。有效范围是 1 到 In-Sight 视觉系统的图像宽度；默认值为 5。
重复偏移	指定每个卡尺起点之间的像素数。有效范围是 0 到 In-Sight 视觉系统的图像宽度；默认值为 5。最后一个卡尺可能会与区域的末端重叠，除非启用了适合所有卡尺。
初始偏移	指定区域中第一个卡尺的偏移量。有效范围是 0 到 In-Sight 视觉系统的图像宽度；默认值为 0。

最小对比度

指定被视为边缘的最小灰度对比度过渡（0 到 255；默认值 = 5） 。对于每个带索引的卡尺，边缘响应图表与图像一起显示。图表中的值会自动缩放为 0-100 值。应用此参数时使用此图表来正确调整值。

示例 - 带有图表的最小对比度参数

注意:边缘响应图表是一个可停靠窗口。有关详细信息，请参阅电子表格编辑器 - 图表主题。

边宽度

指定发生边缘过渡的像素距离（1 到区域宽度值；默认值 = 3） 。该设置是在提取边缘之前用于筛选灰度投影的像素运算符的近似大小；使用此设置筛选图像中的噪声。

调整所有卡尺

指定是否所有卡尺都放置在 ROI 内。

0 = OFF（默认值）	指定该函数严格遵守卡尺重复偏移和初始偏移参数，并且卡尺能会超出 ROI。
1 = ON	指定该函数将自动重新计算卡尺重复偏移和初始偏移参数，以确保所有卡尺都放置在 ROI 内。

查找边缘方向

指定函数将尝试检测边缘的方向。添加深绿色箭头以图形方式说明检测边缘的方向。拟合线将在图像中以图形方式标记，第一条拟合线标记为 0，第二条拟合线标记为 1。

0 = 左到右	该函数将尝试检测从 ROI 左侧到右侧的边缘。示例
1 = 右到左	该函数将尝试检测从 ROI 右侧到左侧的边缘。示例
3 = 中心向外（默认）	该函数将尝试检测从 ROI 中心到 ROI 上下边界的边缘（找到的边缘的顺序将与 ROI 上的“X”箭头方向相反）。示例
2 = 外到内	该函数将尝试检测从 ROI 的上下边界到 ROI 中心的边缘（找到的边缘的顺序将与 ROI 上的“X”箭头方向相反）。示例

边缘：第一

指定要检测的第一个边缘的对比度过渡，由查找边缘方向参数确定。

1 = 黑到白	边缘从黑色像素过渡到白色像素。
2 = 白到黑（默认）	边缘从白色像素过渡到黑色像素。
3 = 二者之一	边缘可以从黑到白或从白到黑过渡，该函数将确定正确的过渡。指定过渡可以提高函数的性能。

边缘：第二

指定要检测的第二个边缘的对比度过渡，由查找边缘方向参数确定。

1 = 黑到白（默认）	边缘从黑色像素过渡到白色像素。
2 = 白到黑	边缘从白色像素过渡到黑色像素。
3 = 二者之一	边缘可以从黑到白或从白到黑过渡，该函数将确定正确的过渡。指定过渡可以提高函数的性能。

边缘评分

指定将用于确定边缘是否符合既定标准的边缘评分模式。

分数阈值

指定一个评分阈值以筛选掉分数（1 到 100；默认值 = 10）低于此值的边缘。

边缘规则

指定计算分数时最重要的边缘类型。

1 = 第一	检测到的第一个边缘受到最优先考虑。
2 = 最强	具有最强对比度过渡的边缘受到最优先考虑。
3 = 第一最强	检测到的第一个具有最强过渡的边缘受到最优先考虑。
4 = 边缘对大小	以最接近对大小参数的大小检测到的边缘对受到最优先考虑。
5 = 第一个边缘对大小	以最接近对大小参数的大小检测到的第一个边缘对受到最优先考虑。
6 = 最强边缘对大小	检测到的具有最强过渡且尺寸最接近对大小参数的边对受到最优先考虑。
7 = 第一个最强边缘对大小（默认值）	第一个具有最强过渡和最接近对大小参数的大小的边缘对受到最优先考虑。

对比度上限

指定被视为边缘的边缘对比度过渡的上限（2 到 255；默认值 = 255）；边缘对比度过渡高于此值的边缘将具有相同的最高分数。

注意:边缘规则参数必须设置为最强、第一个最强、最强边缘对大小或第一个最强边缘对大小才能启用此参数。

对大小

指定获得最高分数的边缘对大小（有效范围是 In-Sight 视觉系统图像宽度的 1 到 3 倍；默认值 = 5） 。启用此参数时，检测到高于或低于此值的边缘对将按此值按比例评分。例如，如果对大小设置为 10，并且检测到两个候选边缘对，一个值为 8，另一个为 14，则将选择值为 8 的边缘对，因为它比第二边缘对边更接近此限制。

注意:检查边缘度参数必须为“打开”，边缘规则参数必须设置为边缘对大小、第一个边缘对大小、最强边缘对大小或第一个最强边缘对大小才能启用此参数。

训练

指定工具的训练模式。

0 = OFF	指定该函数将不训练。
1 = ON （默认值）	指定函数将训练。

卡尺图形索引

指定要在图像上显示的卡尺（卡尺将以绿色轮廓显示）；显示的默认卡尺为 0。

显示

指定图像顶部的 InspectEdge 图形叠加的显示模式。

0 = 隐藏所有（默认值）	所有图形都将隐藏，除非包含 InspectEdgeTrainBeadPath 函数的单元格在电子表格中突出显示。
1 = 仅结果图形	将始终显示训练的 EditPolylinePath 和找到的边缘对点图。
2 = 显示结果图形和卡尺详细信息	将始终显示训练的 EditPolylinePath 和单个卡尺（带候选边缘）以及卡尺图。
3 = 显示结果图形、卡尺细节和候选边缘	将始终显示训练的 EditPolylinePath 和单个卡尺（带候选边缘）、卡尺图和所有卡尺的所有候选边缘。
4 = 显示结果图形、所有候选边缘和卡尺	训练的 EditPolylinePath 和单个卡尺（带候选边缘）、卡尺图、所有卡尺的所有候选边缘和所有卡尺将始终显示。
5 = 显示全部：输入、结果和卡尺	输入图形、训练的 EditPolylinePath、单个卡尺（带候选边缘）、卡尺图、所有卡尺的所有候选边缘和所有卡尺将始终显示。

InspectEdgeTrainBeadPath 输出

返回	包含图像中检测到的边缘和卡尺数量的 Inspect 数据结构，如果任何输入参数无效，则为#ERR。
结果	ROI 中卡尺的数量。