多模板优化特征匹配

## 多模板优化特征匹配

![](/media/202606/2026-06-22_182800_1757120.9205196204265799.png)
基于模板图像的轮廓特征信息寻找相似的图形区域，与特征匹配相比，本模块允许添加多个模板进行检测。

### 模块原理
基于模板图像的轮廓特征信息寻找相似的图形区域，允许同时匹配多个模板

### 使用场景
需要查找多种拥有一定轮廓特征的物体，同时进行匹配

### 使用方法

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

### 参数配置说明

#### 基本参数

![](/media/202606/2026-06-22_182840_7403790.6448054551568886.png)

【匹配度】模板与搜索图像中目标的相似程度，搜索到的目标在相似度大于设置值时才会被搜索到，默认为0.7。
【搜索角度】输入最小和最大搜索角度，在这个角度范围内的目标才能匹配到，范围从-180~180。
【显示设置】ROI区域，图形结果，掩膜显示等显示设置，包括是否显示，颜色选择，字体大小等。
【位置调整】调整ROI的位置及大小。
【高级参数】点击弹出高级参数界面，详见下方高级参数介绍。
【模型编辑】进行模型的编辑，用于检测时使用，参数介绍见下方模板编辑详细介绍。

【模型管理】修改模型的数量。
【新增等按钮】新增、删除、清除所有、复制模型
【模型管理】修改模型的数量。

![](/media/202606/2026-06-22_182924_5512150.6009369912813527.png)
【搜索数量】待查找目标的最大搜索数量。
【定位模式】精准定位:较准确；快速定位:速度较快，不如精准定位准确。
【边缘显示】模板边缘的显示
【形变等级】区分特征的形体变化等级

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

#### 高级参数

![](/media/202606/2026-06-22_180028_6711040.36649598295844743.png)

![](/media/202606/2026-06-23_142440_6368640.1500471712761854.png)
【最大重叠率(百分比)】当搜索多个目标时，两个被检测目标彼此重合时，两者匹配框所被允许的最大重叠比例。 值越大则允许两目标重叠的程度就越大。
【考虑极性】是否考虑目标极性和模板极性的一致。
【排序标准】按标准对匹配到的结果进行排序
【排序间隔】排序目标的间隔

#### 模板编辑

![](/media/202606/2026-06-22_180222_8273560.616772551105411.png)

点击"+"新增模型，点击"模型编辑"修改现有模型

![](/media/202606/2026-06-23_142726_3742540.09399842992318108.png)
【自动边缘梯度】启用“自动边缘梯度”后，模板将根据roi中框选的部分自动计算边缘梯度。小图像上极为方便；但在大图像上计算耗时较久，此时尽量手动输入手动边缘梯度。
【自动定位尺度】启用“自动定位尺度”后，模板将根据roi中框选的部分自动计算定位尺度。小图像上极为方便；但在大图像上计算耗时较久，此时尽量使用手动输入定位尺度， 定位尺度越大检测速度越快，可在4-8之间尝试。
【检测尺度】检测尺度要小于定位尺度[1,16]，通过实际测试不同尺度范围下的匹配效果，选择在精度和效率之间达到最佳平衡的参数设置， 检测尺度越大检测速度越快，可在1-2之间尝试。
【边缘颜色】模型的边缘颜色
【更新图像】点击后，会将此模块的图像输入端口读取到界面上，在点击生成模型后将模板图像切换为当前图像，需要切换模型图像时需点击此按钮
【位置调整】指定调整模型roi位置，用于更精细的roi调整
【生成模型】点击后，根据当前图像和参数，生成新的模型

需生成模型后才能掩膜编辑

![](/media/202606/2026-06-23_143029_9438170.7553573451972614.png)
掩膜参数核心作用是精准控制匹配区域，用于限定特征检测与匹配的有效区域，它是一种空间约束工具，允许用户指定图像中哪些区域参与特征提取与匹配，哪些区域被忽略。

【自动】根据条件自动进行掩膜添加
【自动阈值】将符合的根据颜色快速添加上掩膜
【灰度阈值】和自动阈值参数配合使用，符合灰度范围和自动阈值时快速添加上掩膜。例如自动掩膜选择阈值中间时，符合灰度阈值范围之内的将会加上掩膜。

![](/media/202606/2026-06-23_143322_1498380.5608758105140004.png)
【自动】根据条件自动进行掩膜添加
【自动阈值】将符合的根据颜色快速添加上掩膜
【灰度阈值】和自动阈值参数配合使用，符合灰度范围和自动阈值时快速添加上掩膜。例如自动掩膜选择阈值中间时，符合灰度阈值范围之内的将会加上掩膜。

![](/media/202606/2026-06-23_143447_6901240.11877385134893403.png)
【掩膜形状】根据所选形状的roi快速添加掩膜，
【掩膜形状】矩形、圆形等不同的roi形状
【添加】点击后，根据roi生成掩膜
【位置调整】调整roi的位置

![](/media/202606/2026-06-23_143634_7779430.4807103496579461.png)
【掩膜处理】类似blob的方式添加掩膜
【滤波尺寸】滤波尺寸
【执行】根据上两个参数在图像上添加掩膜

### 输出说明

![](/media/202606/2026-06-23_143746_9601260.9207280716117981.png)
【运行结果】匹配到目标，输出为真，否则为假
【目标个数】匹配到的目标个数
【匹配度】匹配结果对应的匹配度值
【检测角度】匹配结果的角度
【检测位置】匹配结果对应的检测位置
【输出坐标系】匹配结果的坐标系，以检测位置和检测角度构造的坐标系
【匹配度数组】匹配结果对应的匹配度值数组，数组大小与匹配目标个数相同
【检测点数组】匹配结果对应的检测位置数组，数组大小与匹配目标个数相同
【检测角度数组】匹配结果对应的检测角度数组，数组大小与匹配目标个数相同
【基准点数组】根据检测位置生成的偏移后的基准点数组，数组大小与模型编辑添加的基准点数量有关，若未添加基准点，则此选项无效
【正矩形ROI】此模块的roi绘制成的矩形边框

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