特征匹配

## 特征匹配

![](/media/202606/2026-06-22_133957_0283120.10010036231160169.png)
`推荐使用“优化特征匹配”模块替代本模块`
`模块在20260611以后的软件中隐藏`
基于模板图像的轮廓特征信息寻找相似的图形区域。

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

### 使用场景
查找拥有一定轮廓特征的物体

### 使用方法

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

### 参数配置说明

#### 基本参数

![](/media/202606/2026-06-22_134053_9741760.5791964318299604.png)
【匹配度】模板与搜索图像中目标的相似程度，搜索到的目标在相似度大于设置值时才会被搜索到，默认为0.7。
【搜索角度】输入最小和最大搜索角度，在这个角度范围内的目标才能匹配到，范围从-180~180。
【显示设置】ROI区域，图形结果，掩膜显示等显示设置，包括是否显示，颜色选择，字体大小等。
【搜索数量】待查找目标的最大搜索数量。
【图像滤波】图像滤波主要用于预处理阶段的噪声抑制与边缘增强，目的是提升检测的稳定性和匹配精度。
【定位模式】精准定位:较准确；快速定位:速度较快，不如精准定位准确。
【考虑极性】用于控制特征描述符在匹配过程中是否保留像素强度符号信息（即亮暗关系）的参数。核心意义在于：是否允许匹配算法区分“亮到暗”与“暗到亮”的边缘变化方向。

#### ROI设置

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

#### 高级参数

![](/media/202606/2026-06-22_134214_6398790.497669916885225.png)

![](/media/202606/2026-06-22_134716_2231320.29798649783460973.png)
【缩放比例】缩放比例默认为1.00~1.00（即匹配无缩放的目标）。当匹配缩放的目标时，需要根据目标缩放的比例调整该参数。（此参数暂时无效）
【目标中心最小距离】两个相邻特征点之间必须满足的最小像素距离。如果两个特征点的距离小于该阈值，则只保留响应值更高的那个点，减少特征点数量，降低后续匹配计算的复杂度。
【目标区域规避(最小距离)】屏蔽或排除图像中特定区域的配置选项，其核心目的是防止特征点在无关或干扰区域（如背景、遮挡物、运动模糊区）中被提取或匹配，从而提升匹配精度与鲁棒性
【旋转角度后复检(角度)】旋转角度后再次检测
【排序标准】按标准对匹配到的结果进行排序
【排序间隔】排序的间隔

#### 模板编辑

![](/media/202606/2026-06-22_135239_3035940.7531905777220186.png)
![](/media/202606/2026-06-22_135152_6620910.9382447837009966.png)
【自动边缘梯度】启用“自动边缘梯度”后，模板将仅保留清晰、稳定、具有几何意义的边缘结构（如物体轮廓、角点、棱边），请优先使用“自动边缘梯度”，若需要进行精细调优，再进行手动边缘梯度设置
【自动定位尺度】自动定位尺度：算法智能选择，适用于未知尺度变化的场景，鲁棒性强。手动定位尺度：用户显式设定尺度范围或固定值，但需预知目标尺寸。
【检测尺度】检测尺度要小于定位尺度[1,16]，通过实际测试不同尺度范围下的匹配效果，选择在精度和效率之间达到最佳平衡的参数设置。
【边缘颜色】模型的边缘颜色
【更新图像】点击后，会将此模块的图像输入端口读取到界面上，在点击生成模型后将模板图像切换为当前图像，需要切换模型图像时需点击此按钮
【位置调整】指定调整模型roi位置，用于更精细的roi调整
【生成模型】点击后，根据当前图像和参数，生成新的模型

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

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

【手动】通过画笔、橡皮擦等，手动绘制、擦除所需掩膜

【掩膜画笔】画笔：根据绘制添加掩膜；
【画笔尺寸】选择画笔和橡皮擦的直径大小
【掩膜擦除】类似于橡皮擦，根据绘制擦除掩膜

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

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

![](/media/202606/2026-06-22_140044_0571000.275323644539733.png)
【掩膜处理】根据所选掩膜处理进行添加
【滤波尺寸】滤波尺寸

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

### 输出说明

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

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