FindPatMaxRedLine

根据训练图案在图像中查找对象。（您希望找到的对象的训练（内部）几何描述。）FindPatMaxRedLine 根据来自 Patterns 结构的训练图案在图像中查找图案.

FindPatMaxRedLine 输入

参数

说明

图像

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 也会根据“固定坐标”而旋转或转换。

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

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

查找区域

也称为关注区域 (ROI)，指定要进行分析的图像区域。双击区域参数以创建可以变换和旋转的交互图形模式。选择此参数并按属性表的作业编辑工具栏上的最大化区域按钮，自动拉伸区域以覆盖整个图像。

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

外部区域

该参数使用对于电子表格单元格的单元格引用，其中包含 Annulus、Circle、区域、EditAnnulus、EditCircle、EditCompositeRegion、EditPolygon、或 EditRegion。使用此参数时，该函数将忽略区域和固定设置并检查引用区域指定的图像区域。如果引用了编辑复合区域控件，则检查区域可以是多种形状的混合。在混合区域中的任何一个形状可以被指定从（遮蔽）检查区域中添加或删除。

注意:如果此参数已设置为对外部区域的引用，要使用函数的内部区域，必须通过输入值 0 代替单元格引用手动将此参数设置为零。否则，该函数将继续引用外部区域。

图案

此参数必须引用包含 TrainPatMaxRedLine 函数返回的有效 Patterns 数据结构的电子表格单元格。

要查找的数量

指定了最多返回的图案数目 (1 到 1000; 默认值 = 1)。

接受阈值

指定接受阈值，即有效实例的最低分数。潜在匹配的分数必须大于接受阈值的值，否则将不会返回该匹配（0 到 100；默认值 = 50）。

忽略极性

指定是否可以找到包含与训练图案相关的颜色反转匹配特征的匹配项。

0 = OFF（默认值）	不要匹配颜色反转的特征。
1 = ON	考虑与相反极性匹配的边缘。

忽略图案极性会增加 PatMax 发现的图案的极性。下图显示了匹配和不匹配极性的一些示例。如果您将 PatMaxRedLine 配置为忽略极性，它会找到图中所示的所有图案。如果您配置 PatMaxRedLine 以考虑极性，它可能找不到底行中的图案，或者可能找到这些图案但分配的分数比上面行中的图案低。

精确模式

指定准确性/可靠性和执行速度之间的权衡。

0 = 低	指定较低的准确性/可靠性和更快的执行速度。
1 = 高（默认值）	指定更高的准确性/可靠性和更慢的执行速度。

分数包含杂波

指定缺失或遮挡的图案特征是否会降低响应分数。

0 = OFF（默认值）	不要在分数中包括杂波的影响。
1 = ON	在分数中包括杂波的影响。

对比度阈值

指定有效实例的最低对比度。潜在匹配的对比度必须大于对比度阈值，否则将不考虑该实例（0 到 100；默认值 = 0）。FindPatMaxRedLine 对比度是训练图案中的特征与搜索图像中的匹配特征之间对比度变化的“相对”度量，以百分比表示。因此，如果特征对比度与图案对比度相似或较高，则报告的对比度将约为 100。如果特征对比度低于图案对比度，则报告的对比度将 <100。

注意:FindPatMaxRedLine 的对比度不同于 FindPatMaxPatterns 的对比度，后者是搜索 ROI 的“绝对”图像对比度（以灰度级别表示）。

查找公差

指定用于查找相对于训练图案旋转或缩放的图案的设置。

注意:查找公差是硬性限制，即在指定查找公差之外找到的任何结果都不会在电子表格中返回。

角度开始	指定开始搜索匹配项的角度，采用逆时针方向（-180 到 180；默认值 = -15）。
角度结束	指定停止搜索匹配项的角度，采用逆时针方向（-180 到 180；默认值 = 15）。
缩放开始	指定开始搜索匹配项的缩放（1 到 10000；默认值 = 100） .
缩放结束	指定停止搜索匹配项的缩放（1 到 10000；默认值 = 100） .

XY 重叠

指定大致相同 X、Y 位置的多个重叠图案之间的预期位置差异，作为训练图案大小的百分比（0 到 100；默认值 = 70）。

注意:增加这个值可以找到相同图案的多个重叠匹配项。

高级设置

使用粗糙百分比

指定是否在粗糙搜索阶段使用配置粗糙接受百分比值。

注意:在大多数情况下，不需要启用此设置。

0 = OFF（默认值）	仅在粗糙搜索阶段仅使用接受阈值（忽略粗糙接受百分比值）。
1 = ON	启用粗糙接受百分比参数以将与接受阈值的偏差指定为百分比，在粗糙搜索阶段使用该参数。

粗糙接受百分比

将与接受阈值的偏差指定为百分比，在粗糙搜索阶段使用（0 到 100；默认值 = 60）。当接受阈值值无法有效缩小实例范围并且函数返回不匹配或返回太多匹配时，此参数很有用。

粗糙接受百分比的工作原理

FindPatMaxRedLine 首先使用大特征在运行时图像中找到近似图案匹配（粗糙搜索阶段），然后使用小特征来精确确定图案位置（精细搜索阶段）。在这两个阶段中，接受阈值值都用于缩小找到的实例的范围。

正常流量（使用粗糙百分比 = OFF）

虽然很少见，但 FindPatMaxRedLine 可能不会返回任何匹配项，因为在粗糙搜索阶段只找到低分实例。如果发生这种情况，可以降低接受阈值设置；但是，较低的接受阈值值可能会导致返回太多匹配项。

返回不匹配或太多匹配项
（使用粗糙百分比 = 关闭）

在这种情况下，粗糙接受百分比设置允许您仅为粗糙搜索阶段定义接受阈值。通过为每个搜索阶段使用不同的接受阈值，现在可以返回预期的结果。

返回预期结果（使用粗糙百分比 = ON）

超时

指定时间量，以毫秒为单位（0 到 30000；默认值 = 5000），该函数将在暂停执行并返回 #ERR 之前搜索图案。将该值设置为 0 将禁用该设置，并且不会应用超时。

显示

指定在图像上的图形叠加显示模式。

0 = 隐藏所有（默认值）	所有图形都将被隐藏，除非包含 FindPatMaxRedLine 函数的单元格是电子表格中的活动单元格。
1 = 仅结果图形	任何时候都会为每个找到的图案显示一个交叉。
2 = 输入和结果图形	输入图像区域、每个找到的图案的交叉将始终显示。
3 = 显示全部：输入、结果和匹配特征	输入图像区域、每个找到的图案的交叉和 PatMax RedLine 匹配特征将始终显示。

FindPatMaxRedLine 输出

包含模型和按分数排序的图案响应列表的 Patterns 数据结构，如果任何输入参数无效，则为 #ERR。

注意:FindPatMaxRedLine如果未找到训练图案，则不会 #ERR。在这种情况下，使用图案Vision Data Access functionsGetNFound(Patterns)，如果未找到匹配图案，则返回 0。

结果

最初将 FindPatMaxRedLine 插入单元格时，会使用以下图案Vision Data Access functions在电子表格中创建结果表。

标签	函数	说明
X	GetX(Patterns, Index)	图案位置的 x 坐标。
Y	GetY(Patterns, Index)	图案位置的 y 坐标。
角度	GetAngle(Patterns, Index)	图案位置的方向。
缩放	GetScale(Patterns, Index)	与训练模型相比找到的图案大小，以模型大小的百分比表示。
分数	GetScore(Patterns, Index)	图案响应分数。