模板匹配

## 模板匹配

基于模板图像的灰度特征信息寻找相似的图形区域。

### 模块原理
基于模板图像的灰度特征信息寻找相似的图形区域。

### 使用场景
需要查找拥有一定灰度特征的物体，此模块适用于边缘模糊的物体定位。

### 使用方法

#### 前后序模块
一般结合相机采图模块使用

### 参数配置说明
![](/media/202606/灰度匹配参数_1781676515.png)
#### 基本参数
【匹配度】模板与搜索图像中目标的相似程度，搜索到的目标在相似度大于设置值时才会被搜索到，默认为0.7。
【搜索角度】最小和最大搜索角度，在这个角度范围内的目标才能匹配到，范围从-180~180。
【显示设置】ROI区域，图形结果，掩膜显示等显示设置，包括是否显示，颜色选择，字体大小等。
【位置调整】调整ROI的位置及大小。
【排序参数】对匹配到的多个目标进行排序。
【模型编辑】进行模型的编辑，用于检测时使用，参数介绍见下方模板编辑详细介绍

【搜索数量】期待查找的目标数量，最大查找个数为1024。
【缩放等级】通常设为 3~8，参数设置很小时会导致匹配时间过长，参数过大会导致内存占用较大，尽量根据电脑配置设置较高的缩放等级。
【重叠率】匹配到多个目标时允许相邻目标的最小外接矩形重叠率，重叠率超过此值的匹配目标会被丢弃。
【启用亚像素】开启后匹配更精准，所需检测时间也较长，亚像素精度通过插值算法对图像灰度分布进行连续建模，从而将特征点的定位精度提升至‌0.1像素甚至更高。

![](/media/202606/模板匹配-ROI_1781679841.png)
【ROI类型】默认检测区域的ROI类型为斜矩形。
【ROI来源】手动ROI：可在窗口手动拖动ROI的位置及大小；引用ROI:可在端口连接外部ROI。
【位置修正】选择姿态修正后可连接坐标系使ROI区域跟随坐标系移动。

#### 模板编辑
![](/media/202606/模板匹配-模型编辑_1781679969.png)
【模型生成方式】图像上提取, 根据所选的roi区域生成特定的模型

【更新图像】点击后会将此模块的图像输入端口图像显示到界面上，需要切换生成模型的图像时需点击此按钮
【生成】点击后根据当前图像和参数生成新的模型

【移动roi】同位置调整弹出界面，指定调整模型roi位置，用于更精细的roi调整

模型参数
【最小旋转角度】模型搜索的角度范围，最小角度
【最大旋转角度】模型搜索的角度范围，最大角度
【角度步进】创建模板时，将目标图像按多少度的间隔旋转，生成多个不同角度的模板副本，用于匹配时适应目标的旋转变化。
【金字塔等级】金字塔等级是指将图像和模板逐级降采样的层数，用于实现由粗到精的匹配策略
【考虑极性】是否严格要求匹配目标与模板的明暗对比度方向完全一致

#### 基准位置
![](/media/202606/模板匹配-基准点_1781682899.png)
【修改基准点】添加、删除、清空基准点
【基准位置移动】更精确的移动基准点

### 输出说明
![](/media/202606/模板匹配-输出_1781683027.png)
【运行结果】是否匹配到目标，匹配到为真，否则为假
【目标个数】匹配到的目标数量
【匹配度】第一个匹配结果对应的匹配度值
【位置偏移】第一个匹配结果相对于模板的位置偏移
【检测角度】第一个匹配结果对应的检测角度
【检测位置】第一个匹配结果对应的检测位置
【斜矩形ROI】此模块编辑的搜索区域
【输出坐标系】第一个匹配结果生成的坐标系
【匹配度数组】所有匹配结果的匹配度
【检测点数组】所有匹配结果的检测位置
【检测角度数组】所有匹配结果的检测角度
【基准姿态数组】基准点相对于所有匹配结果的位置

## 注意事项
1.使用此模块匹配时的搜索角度范围和训练模型界面的角度范围要保持一致，否则可能导致异常匹配结果。

点击此处跳转到对应的中文说明书文章页:&nbsp;[Single Target Template Matching](/doc/415)