优化特征匹配

## 优化特征匹配

![](/media/202606/2026-06-22_094538_1609300.4251800578333852.png)
用于查找特定基于模板图像的轮廓特征信息寻找相似的图形区域，相较于特征匹配，此模块检测速度和表现都要好一些，更推荐使用此模块。

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

### 使用方法

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

### 参数配置说明

#### 基本参数

![](/media/202606/2026-06-22_094032_0530080.9635470569802077.png)
【匹配度】模板与搜索图像中目标的相似程度，搜索到的目标在相似度大于设置值时才会被搜索到，默认为0.7。
【搜索角度】输入最小和最大搜索角度，在这个角度范围内的目标才能匹配到，范围从-180~180。
【显示设置】ROI区域，图形结果，掩膜显示等显示设置，包括是否显示，颜色选择，字体大小等。
【搜索数量】待查找目标的最大搜索数量。
【图像滤波】图像滤波主要用于预处理阶段的噪声抑制与边缘增强，目的是提升检测的稳定性和匹配精度。
【定位模式】精准定位:较准确；快速定位:速度较快，不如精准定位准确。
【边缘显示】模板边缘的显示
【形变等级】区分特征的形体变化等级

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

#### 高级参数

![](/media/202606/2026-06-22_094317_9566980.9551504757943883.png)

![](/media/202606/2026-06-22_094615_5218780.2183628093492732.png)
【缩放比例】缩放比例默认为1.00~1.00（即匹配无缩放的目标）。当匹配缩放的目标时，需要根据目标缩放的比例调整该参数。（此参数暂时无效）
【旋转角度后复检(角度)】
【最大重叠率(百分比)】当搜索多个目标时，两个被检测目标彼此重合时，两者匹配框所被允许的最大重叠比例。 值越大则允许两目标重叠的程度就越大。
【考虑极性】是否考虑目标极性和模板极性的一致。
【排序标准】按标准对匹配到的结果进行排序
【排序间隔】排序目标的间隔

#### 模板编辑

![](/media/202606/2026-06-22_094717_0724060.12798523077513835.png)

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

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

【手动掩膜】通过画笔、橡皮擦等，手动绘制、擦除所需掩膜
【边缘擦除】排除的图像内容
【画笔尺寸】选择画笔和橡皮擦的直径大小
【掩膜擦除】类似于橡皮擦，根据绘制擦除掩膜
【边缘增强】强化的图像内容
【权重等级】强化的图像内容

【掩盖所有】整个图像都添加上掩膜
【擦除所有】擦除掉所有掩膜

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

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

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

![](/media/202606/2026-06-22_095808_1158080.9395564724386489.png)
【启用匹配校验】是否启用匹配校验
【模型生成】点击此按钮重新生成校验模型
【边缘颜色】校验模型边缘颜色
【位置调整】调整校验的roi位置
【自动边缘梯度】优先使用“自动边缘梯度”，若需要进行精细调优，再进行手动设置
【自动定位尺度】优先使用“自动定位尺度梯度”，若需要进行精细调优，再进行手动设置
【检测尺度】检测尺度要小于定位尺度[1,16]，通过实际测试不同尺度范围下的匹配效果，选择在精度和效率之间达到最佳平衡的参数设置。
【匹配度】用于衡量两个特征点之间描述符的相似程度。决定哪些匹配点被保留、哪些被剔除。
【搜索角度范围】用于控制算法在进行几何一致性验证时，允许模板与目标图像之间存在的‌最大旋转角度差异‌。
【匹配结果角度】实际旋转了多少，角度偏差是衡量匹配稳定性的关键
【搜索宽度】搜索宽度
【搜索高度】搜索高度

![](/media/202606/2026-06-22_095911_4976190.1574402733582927.png)
【Blob校验】是否启用Blob校验
【灰度阈值】灰度图像的灰度值设置，符合该区间的区域被选中
【面积判定】对最终的区域结果进行判定，所有区域的总面积在该区间内结果为真，否则为假
【Blob筛选】可以根据一些条件过滤掉一些区域，例如单个面积、重心x、重心y、外接正/斜矩形的中心坐标x/y、外接正/斜矩形的长宽，孔洞面积、孔洞个数、矩形度、圆度、紧密度、去除边界区域等。
【Blob绘制】是否绘制Blob
【启用掩膜】是否在Blob上额外使用掩膜功能
【掩膜编辑】编辑在Blob上使用的掩膜

### 输出说明

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

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