基于飞腾平台的OpenCV的编译与安装

【写在前面】飞腾开发者平台是基于飞腾自身强大的技术基础和开放能力，聚合行业内优秀资源而打造的。该平台覆盖了操作系统、算法、数据库、安全、平台工具、虚拟化、存储、网络、固件等多个前沿技术领域，包含了应用使能套件、软件仓库、软件支持、软件适配认证四大板块，旨在共享尖端技术，为开发者提供一个涵盖多领域的开发平台和工具套件。点击这里开始你的技术升级之旅吧

本文分享至飞腾开发者平台《飞腾平台OpenCV编译安装说明》

1 介绍

OpenCV（Open Source Computer Vision Library）是一个基于BSD许可（开源）发行的跨平台计算机视觉和机器学习软件库，可以运行在Linux、Windows、Android和Mac OS操作系统上。软件库包含了超过2500种计算机视觉和机器学习领域内的通用算法，广泛应用于人脸检测、人脸识别、目标检测、视频内行为分析、3D建模、相似图像检测、眼动追踪和增强现实等等。OpenCV同时提供了C++, Java, MATLAB等语言的接口,可利用处理器相关SIMD指令集对程序进行加速，也支持CUDA和OpenCL。OpenCV是模块化的结构设计，包括了多个共享或静态库，如表1.1所示。关于OpenCV的更多信息请查阅参考文献【1】（文末）。

核心功能（core）	定义了基本的的数据结构，包含矩阵的数据结构和基本操作方式。
图像处理（imgproc）	包括线性和⾮线性的图像滤波、⼏何图像转换（缩放、仿射和透视调整）、颜⾊模式转换、直⽅图等等。
视频分析（video）	包含了运动估计、背景消除和⽬标跟踪算法。
立体标定和3D重建（calib3d）	提供基本的多视图⼏何算法、平⾯和⽴体影像校正、目标姿态估计和3D重建算法。
二维特征框架（Features2d）	显著特征探测器、描述符和描述符匹配器。
目标检测（Objectect）	检测对象和预定义的类的实例（例如：脸部、眼睛、杯⼦、⼈、⻋等等）。
图像界面（Highgui）	提供⼀个简单易⽤的UI。
视频接口（videoio）	提供⼀个简单易⽤的视频捕获和编码解码界⾯。
其他	FLANN（神经⽹络）和Google测试封装、 Python绑定等等

2 环境说明

2.1 硬件环境

硬件环境如下表所示。

项目	说明
CPU	FT-2000/4
网络	可访问外网
存储	无要求
内存	无要求

2.2 软件环境

2.2.1 操作系统

操作系统环境如下表所示。

项目	说明
Kylin	V10
Kernel	4.4.131

2.2.2 软件环境

软件环境如下表所示。

项目	版本	下载地址
GCC	5.4.0
cmake	3.18.0	https://github.com/Kitware/CMake/releases/download/v3.18.6/cmake-3.18.0.tar.gz
OpenCV	4.4.0	https://github.com/opencv/opencv/archive/4.4.0.tar.gz
OpenCV_extra	4.4.0	https://github.com/opencv/opencv_extra/archive/4.4.0.tar.gz

3 编译安装

3.1 安装OpenCV所需依赖库

依赖版本要求：
GCC 4.4.x or later
CMake 2.8.7 or higher
Git
GTK+2.x or higher, including headers (libgtk2.0-dev)
pkg-config
Python 2.6 or later and Numpy 1.5 or later with developer packages (python-dev,python-numpy)
ffmpeg or libav development packages: libavcodec-dev, libavformat-dev,libswscale-dev

可选项：
libtbb2 libtbb-dev
libdc1394 2.x
libjpeg-dev, libpng-dev, libtiff-dev, libjasper-dev, libdc1394-22-dev
CUDA Toolkit 6.5 or higher

安装方式：

# sudo apt-get install build-essential
# sudo apt-get install cmake git libgtk2.0-dev pkg-config libavcodec-dev
libavformat-dev libswscale-dev python-dev python-numpy libopenblas-dev

安装选装库：

方式一:

# sudo apt-get install libtbb2 libtbb-dev libjpeg-dev libpng-dev
libtiff-dev libjasper-dev libdc1394-22-dev

方式二:
选择相应的配置选项后，OpenCV会在安装过程中自动下载相关项依赖库。

3.2 编译安装OpenCV

第一步　下载源码包（建议在网页端下载源码）。

git clone <https://github.com/opencv/opencv/archive/4.4.0.tar.gz> /

git clone <https://github.com/opencv/opencv_extra/archive/4.4.0.tar.gz>

第二步　解压。

tar zxf opencv-4.4.0.tar.gz

tar zxf opencv_extra-4.4.0.tar.gz

第三步编译选项配置（详细配置选项见第四章）。

cd opencv-4.4.0

mkdir build

cd build

cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local ..

三种cmake选项配置方式：

A、命令行 cmake -Doption=value

B、cache文件 cmake -C my_options.txt

C、交互式：ccmake 或者 cmake-gui

Note : 对于Tengine等选装项，opencv会在选择配置后自动下载安装。

第四步编译安装。

make -j4

make install \#默认安装到 /usr/local/目录下

#或者下列方式，去掉strip信息

cmake --build . --target install/strip

第五步　配置

1、配置安装库到全局变量

在/etc/ld.so.conf/目录下opencv.conf

添加  \<path to your OpenCV installed \>到 opencv.conf

Ldconfig

2、配置测试文件路径（可直接添加到当前用户的环境变量之中方便后续测试工作。）

export OPENCV_TEST_DATA_PATH = \<path to opencv_extra/testdata\>

3.3 OpenCV运行验证

可执行bin目录下opencv_test_** 任意一测试程序，以core模块为例：

cd \<path to build dir/bin\>

./opencv_test_core

Note :对于dnn的测试只有卷积计算部分，对于模型的测试需要额外下载相关的模型文件。

4 编译选项说明

本章只列出了OpenCV-4.4.0部分并行化和DNN相关的配置选项，其他选项请查阅参考文献【2】。

4.1 并行化选项

	选项	默认值	平台	描述
pthreads	WITH_PTHREADS_PF	ON	Unix-like	Default backend based on pthreads library is available on Linux, Android and other Unix-like platforms. Thread pool is implemented in OpenCV and can be controlled with environment variables OPENCV_THREAD_POOL_*. Please check sources in modules/core/src/parallel_impl.cpp file for details.
TBB	WITH_TBB	OFF	Multiple	Threading Building Blocks is a cross-platform library for parallel programming.
OpenMP	WITH_OPENMP	OFF	Multiple	OpenMP API relies on compiler support.
HPX	WITH_HPX	OFF	Multiple	High Performance ParallelX is an experimental backend which is more suitable for multiprocessor environments.

4.2 GUI选项

选项	默认值	平台	描述
WITH_GTK	ON	Linux	GTK is a common toolkit in Linux and Unix-like OS-es. By default version 3 will be used if found, version 2 can be forced with the WITH_GTK_2_X option.
WITH_WIN32UI	ON	Windows	WinAPI is a standard GUI API in Windows.
N/A	ON	macOS	Cocoa is a framework used in macOS.
WITH_QT	OFF	Cross-platform	Qt is a cross-platform GUI framework.

4.3 深度神经网络相关选项

选项	默认值	描述
WITH_PROTOBUF	ON	Enables protobuf library search. OpenCV can either build own copy of the library or use external one. This dependency is required by the dnn module, if it can't be found module will be disabled.
BUILD_PROTOBUF	ON	Build own copy of protobuf. Must be disabled if you want to use external library.
PROTOBUF_UPDATE_FILES	OFF	Re-generate all .proto files. protoc compiler compatible with used version of protobuf must be installed.
OPENCV_DNN_OPENCL	ON	Enable built-in OpenCL inference backend.
WITH_INF_ENGINE	OFF	Enables Intel Inference Engine (IE) backend. Allows to execute networks in IE format (.xml + .bin). Inference Engine must be installed either as part of OpenVINO toolkit, either as a standalone library built from sources.
INF_ENGINE_RELEASE	2020040000	Defines version of Inference Engine library which is tied to OpenVINO toolkit version. Must be a 10-digit string, e.g. 2020040000 for OpenVINO 2020.4.
WITH_NGRAPH	OFF	Enables Intel NGraph library support. This library is part of Inference Engine backend which allows executing arbitrary networks read from files in multiple formats supported by OpenCV: Caffe, TensorFlow, PyTorch, Darknet, etc.. NGraph library must be installed, it is included into Inference Engine.
OPENCV_DNN_CUDA	OFF	Enable CUDA backend. CUDA, CUBLAS and CUDNN must be installed.
WITH_HALIDE	OFF	Use experimental Halide backend which can generate optimized code for dnn-layers at runtime. Halide must be installed.
WITH_VULKAN	OFF	Enable experimental Vulkan backend. Does not require additional dependencies, but can use external Vulkan headers (VULKAN_INCLUDE_DIRS).
WITH_TENGINE	OFF	Enable experimental Tengine backend for ARM CPUs. Tengine library must be installed.

4.3.1 Tengine配置方式

-DWITH_TENGINE=ON

方式一：编译过程中自动下载安装（需要机器联网）

方式二：使用预编译的lib，并制定路径

-DOPENCV_LIBTENGINE_ROOT_DIR=/UserFileDir/Tengine-library-dir

配置安装成功后：

可通过strings <path to your opencv installed>/lib/ libopencv_dnn.so.xx.xx.xx |grep TENGINE验证：

没有配置成功则无显示.

4.4 CPU相关优化选项

这部分选项一般不需要设置，编译安装过程会自动识别。如果需要添加特定feature，可以自己添加。只要CPU支持，就会按照相关的代码路径去执行程序。
CPU_BASELINE： CPU支持的SIMD指令集
如 CPU_BASELINE = NEON,FP16
CPU_DISPATCH：自定义支持其他SIMD指令集。
如 CPU_DISPATCH = AVX,AVX2
Note: 运行时如不需要利用某个SIMD指令可以设置OPENCV_CPU_DISABLE来实现，如：
OPENCV_CPU_DISABLE=FP16

5 参考资料

[1]OpenCV官网及github：https://opencv.org/；https://github.com/opencv/opencv

[2]OpenCV配置参考https://docs.opencv.org/master/db/d05/tutorial_config_referen...

推荐阅读

基于飞腾平台的Sqoop的安装配置
基于飞腾平台的Flume的安装配置

欢迎广大开发者来飞腾开发者平台获取更多前沿技术文档及资料

如开发者在使用飞腾产品有任何问题可通过在线工单联系我们

版权所有。飞腾信息技术有限公司 2023。保留所有权利。

未经本公司同意，任何单位、公司或个人不得擅自复制，翻译，摘抄本文档内容的部分或全部，不得以任何方式或途径进行传播和宣传。

商标声明

Phytium和其他飞腾商标均为飞腾信息技术有限公司的商标。

本文档提及的其他所有商标或注册商标，由各自的所有人拥有。

注意

本文档的内容视为飞腾的保密信息，您应当严格遵守保密任务；未经飞腾事先书面同意，您不得向任何第三方披露本文档内容或提供给任何第三方使用。

由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，飞腾在现有技术的基础上尽最大努力提供相应的介绍及操作指引，但飞腾在此明确声明对本文档内容的准确性、完整性、适用性、可靠性的等不作任何明示或暗示的保证。

本文档中所有内容，包括但不限于图片、架构设计、页面布局、文字描述，均由飞腾和/或其关联公司依法拥有其知识产权，包括但不限于商标权、专利权、著作权等。非经飞腾和/或其关联公司书面同意，任何人不得擅自使用、修改，复制上述内容。