使用AKAZE_create调用detectAndCompute时出现错误，请求帮助

问题重现 #

代码：

import cv2

im = cv2.imread('a.png', cv2.IMREAD_COLOR)
imGray = cv2.cvtColor(im, cv2.COLOR_BGR2GRAY)
feat = cv2.AKAZE_create(500)
keypoints, descriptors = feat.detectAndCompute(imGray, None)

运行报错：

Traceback (most recent call last):
  File "akaze.py", line 6, in <module>
    keypoints, descriptors = feat.detectAndCompute(imGray, None)
cv2.error: OpenCV(4.6.0) /io/opencv/modules/features2d/src/kaze/AKAZEFeatures.cpp:1294: error: (-215:Assertion failed) x0 - 6 * scale >= 0 && x0 + 6 * scale < Lx.cols in function 'Sample_Derivative_Response_Radius6'

替换为ORB等特征提取器可正常运行，环境为Python 3.8.10 + OpenCV 4.6.0。

原因分析 #

不是detectAndCompute与AKAZE不兼容，而是对AKAZE_create的参数用法有误：

• ORB的ORB_create()第一个参数是nfeatures（最大特征数量），但AKAZE的AKAZE_create()第一个参数是descriptor_type（描述子类型），只能取cv2.AKAZE_DESCRIPTOR_KAZE等枚举值，直接传入500会导致内部参数逻辑混乱，触发边界断言失败。
• AKAZE没有直接设置最大特征数的参数，而是通过threshold参数控制：阈值越低，检测到的特征点越多。

解决方法 #

修正AKAZE_create的参数用法，同时增加图像加载校验：

import cv2

im = cv2.imread('a.png', cv2.IMREAD_COLOR)
# 校验图像是否加载成功
if im is None:
    print("图像加载失败，请检查文件路径或文件完整性")
    exit()

imGray = cv2.cvtColor(im, cv2.COLOR_BGR2GRAY)
# 使用默认描述子类型，通过threshold调整特征数量（值越小特征越多）
feat = cv2.AKAZE_create(threshold=0.0005)
keypoints, descriptors = feat.detectAndCompute(imGray, None)

print(f"成功检测到 {len(keypoints)} 个特征点")

额外注意：如果图像尺寸过小，也可能触发类似边界错误，建议确保图像分辨率足够（比如至少几十像素以上）。

内容的提问来源于stack exchange，提问作者neubert