OpenCV Harris 角点检测及特征匹配：Python 代码详解和错误解决

本代码示例演示了如何使用 OpenCV 在 Python 中进行 Harris 角点检测和特征匹配。

代码示例：

import cv2
import numpy as np
from matplotlib import pyplot as plt

img1 = cv2.imread('1.png')
img2 = cv2.imread('4.png')

gray1 = cv2.cvtColor(img1, cv2.COLOR_BGR2GRAY).astype(np.float32)  # 将图像转换为 float32 类型
gray2 = cv2.cvtColor(img2, cv2.COLOR_BGR2GRAY).astype(np.float32)  # 将图像转换为 float32 类型

dst1 = cv2.cornerHarris(gray1, 2, 3, 0.04)
img1[dst1 > 0.1 * dst1.max()] = [0, 0, 255]

dst2 = cv2.cornerHarris(gray2, 2, 23, 0.04)
img2[dst2 > 0.1 * dst2.max()] = [0, 0, 255]

# 从一幅 Harris 响应图像中返回角点，min_dist 为分割角点和图像边界的最少像素数目
def get_harris_points(harrisim, min_dist=10, threshold=0.1):
    # 寻找高于阈值的候选角点
    corner_threshold = harrisim.max() * threshold
    harrisim_t = (harrisim > corner_threshold) * 1
    # 得到候选点的坐标
    coords = np.array(harrisim_t.nonzero()).T
    # 以及它们的 Harris 响应值
    candidate_values = [harrisim[c[0], c[1]] for c in coords]
    # 对候选点按照 Harris 响应值进行排序
    index = np.argsort(candidate_values)[::-1]
    # 将可行点的位置保存到数组中
    allowed_locations = np.zeros(harrisim.shape)
    allowed_locations[min_dist:-min_dist, min_dist:-min_dist] = 1
    # 按照 min_distance 原则，选择最佳 Harris 点
    filtered_coords = []
    for i in index:
        if allowed_locations[coords[i, 0], coords[i, 1]] == 1:
            filtered_coords.append(coords[i])
            allowed_locations[(coords[i, 0] - min_dist):(coords[i, 0] + min_dist),
                        (coords[i, 1] - min_dist):(coords[i, 1] + min_dist)] = 0
    return filtered_coords

# 对于每个返回的点，返回点周围 2*wid+1 个像素的值（假设选取点的 min_distance > wid）
def get_descriptors(image, filtered_coords, wid=5):
    desc = []
    for coords in filtered_coords:
        patch = image[coords[0] - wid:coords[0] + wid + 1,
                coords[1] - wid:coords[1] + wid + 1].flatten()
        desc.append(patch)
    return desc

# 对于第一幅图像中的每个角点描述子，使用归一化互相关，选取它在第二幅图像中的匹配角点
def match(desc1, desc2, threshold=0.5):
    n = len(desc1[0])
    # 点对的距离
    d = -np.ones((len(desc1), len(desc2)))
    for i in range(len(desc1)):
        for j in range(len(desc2)):
            d1 = (desc1[i] - np.mean(desc1[i])) / np.std(desc1[i])
            d2 = (desc2[j] - np.mean(desc2[j])) / np.std(desc2[j])
            ncc_value = sum(d1 * d2) / (n - 1)
            if ncc_value > threshold:
                d[i, j] = ncc_value
    ndx = np.argsort(-d)  # 从大 0 到小排序
    matchscores = ndx[:, 0]  # 最大一个数的位置坐标
    return matchscores

# 两边对称版本的 match()
def match_twosided(desc1, desc2, threshold=0.5):
    matches_12 = match(desc1, desc2, threshold)
    matches_21 = match(desc2, desc1, threshold)
    ndx_12 = np.where(matches_12 >= 0)[0]
    # 去除非对称的匹配
    for n in ndx_12:
        if matches_21[matches_12[n]] != n:
            matches_12[n] = -1
    return matches_12


# 返回将两幅图像并排拼接成的一幅新图像
def appendimages(im1, im2):
    row1 = im1.shape[0]
    row2 = im2.shape[0]
    if row1 < row2:
        im1 = np.concatenate((im1, np.zeros((row2 - row1, im1.shape[1], im1.shape[2]))), axis=0)
    elif row1 > row2:
        im2 = np.concatenate((im2, np.zeros((row1 - row2, im2.shape[1], im2.shape[2]))), axis=0)
    return np.concatenate((im1, im2), axis=1)


# 显示一幅带有连接匹配之间连线的图片
# 输入：im1，im2（数组图像），locs1，locs2（特征位置），matchscores（match 的输出），
def plot_matches(img1, img2, locs1, locs2, matchscores, show_below=False):
    img3 = appendimages(img1, img2)
    if show_below:
        img3 = np.vstack((img3, img3))

    plt.imshow(cv2.cvtColor(img3, cv2.COLOR_BGR2RGB))


    cols1 = img1.shape[1]
    for i, m in enumerate(matchscores):
        if m > 0:
            plt.plot([locs1[i][1], locs2[m][1] + cols1], [locs1[i][0], locs2[m][0]], 'c')
    plt.axis('off')


if "__main__" == __name__:
    wid = 9  # 比较像素点数目

    filtered_coords1 = get_harris_points(dst1, wid + 1, 0.1)  # 图 1 大于阈值的坐标
    filtered_coords2 = get_harris_points(dst2, wid + 1, 0.1)  # 图 2 大于阈值的坐标
    d1 = get_descriptors(img1, filtered_coords1, wid)
    d2 = get_descriptors(img2, filtered_coords2, wid)
    matches = match_twosided(d1, d2, 0.8)  # 图 1 的阈值点与图二哪个阈值点相关度最高，输出与图一相关性最大点的坐标
    plt.figure(figsize=(30, 20));
    plot_matches(img1, img2, filtered_coords1, filtered_coords2, matches)
    cv2.waitKey()
    cv2.destroyAllWindows()

代码解释：

导入必要的库：

import cv2
import numpy as np
from matplotlib import pyplot as plt

加载图像：

img1 = cv2.imread('1.png')
img2 = cv2.imread('4.png')

将图像转换为灰度并转换为 float32 类型：

gray1 = cv2.cvtColor(img1, cv2.COLOR_BGR2GRAY).astype(np.float32)
gray2 = cv2.cvtColor(img2, cv2.COLOR_BGR2GRAY).astype(np.float32)

执行 Harris 角点检测：

dst1 = cv2.cornerHarris(gray1, 2, 3, 0.04)
img1[dst1 > 0.1 * dst1.max()] = [0, 0, 255]

dst2 = cv2.cornerHarris(gray2, 2, 23, 0.04)
img2[dst2 > 0.1 * dst2.max()] = [0, 0, 255]

定义函数 get_harris_points： 该函数从 Harris 响应图像中返回角点，并使用最小距离 min_dist 来避免选择过近的角点。
定义函数 get_descriptors： 该函数为每个角点提取描述子，描述子是围绕角点的 2*wid+1 个像素的向量。
定义函数 match： 该函数使用归一化互相关 (NCC) 来匹配第一幅图像的描述子与第二幅图像的描述子，并返回匹配分数。
定义函数 match_twosided： 该函数执行双向匹配，以确保匹配是相互的。
定义函数 appendimages： 该函数将两幅图像并排拼接在一起，以方便在同一幅图像中显示匹配结果。
定义函数 plot_matches： 该函数将匹配的角点用直线连接起来，并显示两幅图像。
主程序：

获取两幅图像中的角点。
为每个角点提取描述子。
使用 match_twosided 函数进行双向匹配。
使用 plot_matches 函数显示匹配结果。

错误解决：

报错信息 cv2.error: OpenCV(4.7.0) ... Unsupported depth of input image: ... 'depth' is 6 (CV_64F) 表示输入图像的深度为 float64 类型，而 Harris 角点检测需要 float32 类型。解决方法是将图像转换为 float32 类型，代码如下：

gray1 = cv2.cvtColor(img1, cv2.COLOR_BGR2GRAY).astype(np.float32)
gray2 = cv2.cvtColor(img2, cv2.COLOR_BGR2GRAY).astype(np.float32)

运行代码：

将代码保存为 Python 文件（例如，harris_match.py）。
将 1.png 和 4.png 替换为要使用的图像文件路径。
运行代码：python harris_match.py。

结果：

代码运行后将显示一幅包含两幅图像的拼接图像，其中匹配的角点用直线连接起来。

注意：

wid 参数控制描述子的尺寸，应根据图像的特征选择合适的尺寸。
threshold 参数控制匹配的严格程度，较高的阈值会减少匹配的数量。
此代码只是一种基本的特征匹配示例，可以根据具体需求进行修改。

希望本代码示例和解释能帮助你理解 OpenCV 的 Harris 角点检测和特征匹配，并解决你可能遇到的错误。

OpenCV Harris 角点检测及特征匹配：Python 代码详解和错误解决