# FindPatMaxPatterns

根据训练图案在图像中查找对象。（您要查找的对象的训练（内部）几何描述。）FindPatMaxPatterns 根据 Pattern 结构中的训练图案在图像中查找图案.

## FindPatMaxPatterns 输入

参数 | 说明
图像 | 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 | 图像坐标中的 X 偏移。
Y | 图像坐标中的 Y 偏移。
Theta | 图像坐标系中图像 X 轴的旋转。（顺时针 +/-360 度）
查找区域 | 也称为关注区域 (ROI)，指定要进行分析的图像区域。双击区域参数以创建可以变换和旋转的交互图形模式。选择此参数并按属性表的作业编辑工具栏上的最大化区域按钮，自动拉伸区域以覆盖整个图像。
X | 在固定坐标中，偏移原点的 x 值。
Y | 在固定坐标中，偏移原点的 y 值。
宽度 | 沿区域 x 轴的尺寸。
高度 | 沿区域 y 轴的尺寸。
角度 | 在固定坐标上的方向。
曲线 | 在区域 x 轴和相对的边界线之间的角度偏差。
外部区域 | 此参数对Annulus、Circle、区域、EditAnnulus、EditCircle、EditCompositeRegion、EditPolygon、EditRegion使用单元格引用。使用此参数时，该函数将忽略区域和固定设置并检查引用区域指定的图像区域。如果引用了编辑复合区域控件，则检查区域可以是多种形状的混合。在混合区域中的任何一个形状可以被指定从（遮蔽）检查区域中添加或删除。 注意:如果此参数已设置为对外部区域的引用，要使用函数的内部区域，必须通过输入值 0 代替单元格引用手动将此参数设置为零。否则，该函数将继续引用外部区域。
图案 | 此参数必须引用包含 TrainPatMaxPattern 函数返回的有效 Patterns 数据结构的电子表格单元格。
要查找的数量 | 指定了最多返回的图案数目 (1 到 1024; 默认值 = 1)。
接受 | 指定接受阈值，即有效实例的最低分数。潜在匹配的分数必须大于接受阈值的值，否则将不会返回该匹配（0 到 100；默认值 = 50）。
对比度 | 指定有效实例的最低对比度。潜在匹配的对比度必须大于对比度阈值的值，否则将不考虑该实例（0 到 255；默认值 = 10）。低对比度阈值用于低对比度图像；高对比度阈值用于高对比度图像。
分数包含杂波 | 指定缺失或遮挡的图案特征是否会降低响应分数。
0 = OFF | 不要在分数中包括杂波的影响。
1 = ON （默认值） | 在分数中包括杂波的影响。
外部区域 | 指定在不降低图案响应分数的情况下可以在查找区域之外找到的图案特征的百分比（0 到 100；默认值 = 0）。
查找公差 | 指定用于查找相对于训练图案旋转或缩放的图案的设置。
角度开始 | 指定开始搜索匹配项的角度，采用逆时针方向（-180 到 180；默认值 = -15）。
角度结束 | 指定停止搜索匹配项的角度，采用逆时针方向（-180 到 180；默认值 = 15）。
缩放开始 | 指定开始搜索匹配项的缩放（1 到 10000；默认值 = 100） .
缩放结束 | 指定停止搜索匹配项的缩放（1 到 10000；默认值 = 100） .
纵横比 | 除了均匀比例之外，将匹配查找限制为仅均匀比例或允许 X 或 Y 的纵横比变化。 注意:如果选择了均匀比例变化，则禁用纵横比开始和纵横比结束参数。
0 = 均匀比例变化
1 = 均匀比例和 X 比例变化
2 = 均匀比例和 Y 比例变化
纵横比开始 | 指定开始搜索匹配项的最小比例变化，作为训练图案的百分比（1 到 10000；默认值 = 100） .
纵横比结束 | 指定停止搜索匹配项的最大比例变化，作为训练图案的百分比（1 到 10000；默认值 = 100）。
查找重叠 | 指定用于查找在位置、旋转和比例方面相互重叠的图案的设置。
XY 重叠 | 指定大致相同 X,Y 位置的多个重叠图案之间的预期位置差异，作为训练图案大小的百分比（0 到 100；默认值 = 80）。 注意:增加这个值可以找到相同图案的多个重叠匹配项。
角度重叠 | 指定大致相同 X,Y 位置的多个旋转重叠图案之间的预期角度。A (0 到 360；默认值 = 360)。 注意: 如果角度开始和角度结束参数彼此相等，则禁用角度重叠参数。 增加这个值可以找到相同图案的多个重叠匹配项。
比例重叠 | 指定大致相同 X,Y 位置的多个重叠图案之间的预期均匀比例差异，作为训练图案大小的百分比（1 到 10000；默认值 = 140）。 注意: 如果比例开始和比例结束参数彼此相等，则禁用比例重叠参数。 增加这个值可以找到相同图案的多个重叠匹配项。
纵横比重叠 | 指定大致相同 X,Y 位置的多个重叠图案之间的预期纵横比比例差异，作为训练图案大小的百分比（1 到 10000；默认值 = 140）。 注意: 如果为纵横比参数或如果解读开始和角度结束参数彼此相等，则禁用纵横比重叠参数。 增加这个值可以找到相同图案的多个重叠匹配项。
超时 | 指定时间量，以毫秒为单位（0 到 30000），该函数将在暂停执行并返回 #ERR 之前搜索图案。将该值设置为 0 将禁用该设置，并且不会应用超时。
算法 | 指定将用于处理训练图案图像的算法。
0 = PatMax | PatMax 算法提供比 PatQuick 更高的准确性但，需要更多时间来执行。
1 = PatQuick | PatQuick 算法的准确度低于 PatMax，但执行所需的时间更短。
2 = 训练图案（默认值） | FindPatMaxPatterns 函数将使用在图案参数中引用的 TrainPatMaxPattern 函数的算法参数中指定的算法（PatMax 或 PatQuick）。
显示 | 指定在图像上的图形叠加显示模式。
0 = 隐藏所有（默认值） | 所有图形都将被隐藏，除非包含 FindPatMaxPatterns 函数的单元格是电子表格中的活动单元格。
1 = 仅结果图形 | 任何时候都会为每个找到的图案显示一个交叉。
2 = 输入和结果图形 | 输入图像区域、每个找到的图案的交叉将始终显示。
3 = 显示全部：输入、结果和匹配特征 | 输入图像区域、每个找到的图案的交叉和 PatMax® 匹配特征将始终显示。 注意:当为 TrainPatMaxPattern 的算法参数选择 PatQuick 时，不会显示匹配特征。 绿色匹配特征 = 匹配度为 67% 到 100%。 黄色匹配特征 = 匹配度为 20% 到 66%。 红色匹配特征 = 匹配度低于 20%。

## FindPatMaxPatterns 输出

返回 | 包含模型和按分数排序的图案响应列表的 Patterns 数据结构，如果任何输入参数无效或找不到匹配图案，则为 #ERR。
结果 | 在最初将 FindPatMaxPatterns 插入单元格时，会在电子表格中创建结果表。 注意:在函数的属性表中，提供了补充信息字符串作为更好地查找图案的建议。对于可能的信息字符串列表： [值] 结果因对比度低而被丢弃。 [值] 结果因接近更准确的结果而被丢弃。 [值] 结果因杂波过多而被丢弃。 训练图案包含的当前参数设置的特征太少。 要将信息字符串插入电子表格，请使用 GetInfoString 视觉数据访问函数。

## FindPatMaxPatterns Vision Data Access functions

下列图案Vision Data Access functions自动插入到电子表格中以创建结果表。

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