安装指南

OpenCV 4.9.0 版本开始,增加了图像处理相关高频接口的昇腾原生支持,本教程面向使用 OpenCV & 昇腾开发者,帮助完成昇腾环境下 OpenCV 的安装。

昇腾环境安装

请根据已有昇腾产品型号及CPU架构等按照 快速安装昇腾环境指引 进行昇腾环境安装,或直接获取对应产品的昇腾环境镜像 ascendai/cann

警告

CANN 最低版本为 8.0.rc1,安装 CANN 时,请同时安装 Kernel 算子包。

OpenCV 安装

请遵循以下版本控制:

lib

最低版本

推荐版本

OpenCV

4.9.0

latest

Python

3.9

3.10

GCC

9.4.0

9.4.0

Python 环境创建

1# 创建名为 opencv 的 python 3.10 的虚拟环境
2conda create -y -n opencv python=3.10
3# 激活虚拟环境
4conda activate opencv

源码编译

  1. 下载 OpenCV 和 opencv_contrib

1git clone https://github.com/opencv/opencv.git
2
3cd opencv
4git clone https://github.com/opencv/opencv_contrib.git
  1. 编译带有 opencv_contrib 的 OpenCV

 1# 在 opencv 项目目录中创建并进入 build 目录
 2mkdir build
 3cd build
 4
 5# cmake & make
 6cmake -D CMAKE_BUILD_TYPE=RELEASE
 7    -D CMAKE_INSTALL_PREFIX=pwd/install \
 8    -D WITH_DEBUG=0 \
 9    -D OPENCV_EXTRA_MODULES_PATH=/path/to/opencv/opencv_contrib/modules \
10    -D DWITH_CUDA=0 \
11    -D DWITH_CANN=1 \
12    -D DPYTHON3_EXECUTABLE=/path/to/miniconda3/envs/opencv/bin/python \
13    -D DPYTHON_LIBRARY=/path/to/miniconda3/envs/opencv \
14    -D PYTHON_INCLUDE_DIR=/path/to/miniconda3/envs/opencv/include/python3.10 \
15    -D BUILD_opencv_wechat_qrcode=OFF \
16    -D BUILD_opencv_xfeatures2d=OFF \
17    -D BUILD_opencv_face=OFF \
18    -D BUILD_opencv_dnn=OFF \
19    -D BUILD_opencv_features2d=OFF \
20    -D WITH_CAROTENE=OFF \
21    -D WITH_IPP=OFF \
22    -D BUILD_DOCS=ON \
23    -D BUILD_EXAMPLES=ON ..
24
25make -j5

当编译出现以下关键回显信息时,说明编译成功。

# xxx 为 OpenCV 中某模块名称
[100%] Built target xxx

安装校验

通过以下指令执行昇腾算子单元测试:

1cd path/to/opencv/build/bin
2./opencv_test_cannops

出现以下关键回显说明安装成功:

[==========] 72 tests from 4 test cases ran. (40937 ms total)
[  PASSED  ] 72 tests.