推理引擎示例
推理引擎示例应用是简单的控制台应用,显示了如何在应用中利用特定的推理引擎功能,帮助开发人员执行特定的任务,例如加载模型、运行推理、查询特定的设备功能等。
安装英特尔®OpenVINO™工具套件分发版后,С、C++和Python 示例应用分别在以下目录中:
/inference_engine/samples/c
/inference_engine/samples/cpp
/inference_engine/samples/python
推理引擎示例应用包括:
基准应用 – 在支持的设备上为同步和异步模式预估深度学习推理性能
Hello分类示例 – 使用同步推理请求API的图像分类网络(如AlexNet和GoogLeNet)的推理。可以将任何大小和布局的输入设置为推理请求,该推理请求将在推理过程中自动进行预处理(该示例仅支持将图像作为输入,并支持Unicode路径)。
Hello NV12输入分类示例 – 可以将任何大小和布局的输入提供给推理请求。该示例将输入转换为NV12颜色格式,并在推理过程中对其进行自动预处理。该示例仅支持图像作为输入。
图像分类示例异步 – 使用异步推理请求API的图像分类网络(如AlexNet和GoogLeNet)的推理(该示例仅支持图像作 为输入)。
神经风格迁移示例 – 样式转移示例(该示例仅支持图像作为输入)。
对象检测SSD示例 – 基于SSD的对象检测网络推理,此示例是简化版本,仅支持图像作为输入。
可用于示例的素材
支持预训练模型的示例
构建示例应用
在Linux上构建示例应用
官方支持的Linux构建环境如下:
Ubuntu 16.04 LTS 64位或CentOS 7.4 64位
GCC 5.4.0(对于Ubuntu 16.04)或GCC 4.8.5(对于CentOS 7.4)
CMake 2.8或更高版本
要为Linux构建C或C ++示例应用,请分别转到/inference_engine/samples/c或/inference_engine/samples/cpp目录,然后运行build_samples.sh脚本:
build_samples.sh
构建完成后,你可以在以下文件夹中找到示例的二进制文件:
C语言示例: ~/inference_engine_c_samples_build/intel64/Release
C ++示例: ~/inference_engine_cpp_samples_build/intel64/Release
你还可以手动构建示例应用:
注意:如果你已以root用户身份安装产品,请先切换到root模式,然后再继续:sudo -i
转到具有写访问权限的目录,并创建示例构建目录。本示例使用名为build的目录:
mkdir build
注意:如果在安装过程中运行了图像分类验证脚本,则C++示例构建目录已在你的主目录中创建:~/inference_engine_samples_build/
转到创建的目录:
cd build
运行CMake生成用于release或debug配置的Make文件。例如,对于C ++示例:
对于release 配置:
cmake -DCMAKE_BUILD_TYPE=Release /inference_engine/samples/cpp
对于debug配置:
cmake -DCMAKE_BUILD_TYPE=Debug /inference_engine/samples/cpp
运行make以构建示例:
make
对于release 配置,示例应用的二进制文件位于/intel64/Release/中;对于debug配置 — 在/intel64/Debug/中。
在Microsoft Windows操作系统上构建示例应用
推荐的Windows 构建环境如下:
Microsoft Windows 10
Microsoft Visual Studio 2015、2017或2019
CMake 2.8或更高版本
注意:如果要使用Microsoft Visual Studio 2019,则需要安装CMake 3.14。
要在Windows上构建C或C++示例应用,请分别转到\inference_engine\samples\c或\inference_engine\samples\cpp目录,然后运行build_samples_msvc.bat批处理文件:
build_samples_msvc.bat
默认情况下,该脚本会自动检测计算机上安装的最高Microsoft Visual Studio版本,并使用它来创建和构建示例代码的解决方案。你还可以根据需要指定脚本要使用的首选Microsoft Visual Studio版本。支持的版本是VS2015,VS2017和VS2019。例如,要使用Microsoft Visual Studio 2017生成C ++示例,请使用以下命令:
\inference_engine\samples\cpp\build_samples_msvc.bat VS2017
构建完成后,你可以在以下文件夹中找到示例的二进制文件:
C语言示例: C:\Users\
\Documents\Intel\OpenVINO\inference_engine_c_samples_build\intel64\Release
C ++示例: C:\Users\
\Documents\Intel\OpenVINO\inference_engine_cpp_samples_build\intel64\Release
你也可以手动构建生成的解决方案。例如,如果要在Debug配置中构建C++示例的二进制文件,请运行相应版本的Microsoft Visual Studio,然后从C:\Users\\Documents\Intel\OpenVINO\inference_engine_cpp_samples_build\Samples.sln目录中打开生成的解决方案文件。
准备就绪来运行示例应用
准备在Linux 上运行示例应用
在运行编译的二进制文件之前,请确保你的应用可以找到推理引擎和OpenCV库。运行setupvars脚本以设置所有必需的环境变量:
source /bin/setupvars.sh
可选:关闭shell时,会删除OpenVINO环境变量。你可以如下永久设置环境变量:
在中打开.bashrc文件:
vi /.bashrc
将此行添加到文件末尾:
source /opt/intel/openvino/bin/setupvars.sh
保存并关闭文件:按Esc键,键入:wq并按Enter键。
要测试你的更改,请打开一个新终端。你会看到[setupvars.sh] OpenVINO environment initialized。
你已准备好运行示例应用。要了解有关如何运行特定的示例,请通过单击上方示例列表中的示例名称来阅读示例文档。
准备在Windows上运行示例应用
在运行编译好的二进制文件之前,请确保你的应用可以找到推理引擎和OpenCV库。使用setupvars脚本来设置所有必要的环境变量:
\ bin \ setupvars.bat
要在Windows中的Microsoft Visual Studio调试或运行示例,请确保已为Debug和Release配置正确配置了Debugging环境设置。为OpenCV库、推理引擎库的debug和releaser版本设置了正确的路径。例如,对于Debug 配置,转到项目的Configuration Properties 配置属性的Debugging目录,然后将Environment字段中的PATH变量设置为以下内容:
PATH=\deployment_tools\inference_engine\bin\intel64\Debug;\opencv\bin;%PATH%
是OpenVINO工具套件的安装目录。
你已经准备好来运行示例应用。要了解有关如何运行特定示例的信息,请通过单击上方示例列表中的示例名称来阅读示例文档。
还可参阅