OpenPose项目高级安装配置指南

OpenPose项目高级安装配置指南

openpose 项目地址: https://gitcode.com/gh_mirrors/op/openpose

前言

OpenPose作为一款强大的人体姿态估计工具，其安装过程提供了多种可选配置项以满足不同使用场景的需求。本文将详细介绍OpenPose的高级安装选项，帮助用户根据自身需求定制安装方案。

1. 部署与导出

将OpenPose集成到其他项目中时，需要特别注意依赖项的配置。OpenPose提供了完整的API接口，可以方便地被其他C++项目调用。部署时需确保所有动态链接库路径正确配置，建议使用静态链接方式减少运行时依赖。

2. 性能优化配置

2.1 最大化运行速度

OpenPose的性能表现与硬件配置密切相关。对于GPU版本，建议：

• 使用最新版CUDA和cuDNN
• 确保显卡驱动为最新版本
• 根据显存容量合理设置--net_resolution参数

2.2 CPU加速方案（仅限Ubuntu）

在Ubuntu系统上，Intel CPU用户可通过启用MKL（Math Kernel Library）获得2-3倍的性能提升：

1. 设置GPU_MODE为CPU_ONLY
2. 启用USE_MKL选项
3. 配置环境变量优化线程数：

export MKL_NUM_THREADS="8"
export OMP_NUM_THREADS="8"

注意：MKL版本不支持动态分辨率输入，需固定--net_resolution参数。

3. 替代计算方案

3.1 OpenCL支持

AMD显卡用户可使用OpenCL版本：

1. 设置GPU_MODE为OPENCL
2. 注意：切换计算模式后需完全重建项目
3. OpenCL版本同样需要固定分辨率输入

4. 模型选择

OpenPose默认使用BODY_25模型，用户也可选择下载其他预训练模型：

• COCO模型：18个关键点
• MPI模型：15个关键点

通过设置DOWNLOAD_BODY_COCO_MODEL或DOWNLOAD_BODY_MPI_MODEL标志启用。

5. 3D重建模块

3D重建功能需要额外配置：

1. 安装FLIR相机软件Spinnaker SDK
2. 安装3D可视化工具FreeGLUT
3. 在CMake中启用WITH_FLIR_CAMERA和WITH_3D_RENDERER选项
4. （可选）安装Ceres Solver提高重建精度（仅Ubuntu）

6. 相机标定模块

标定工具箱默认包含在项目中，外参标定需要：

1. 启用WITH_EIGEN选项
2. 推荐使用自动下载Eigen的方式（AUTOBUILD）
3. 也可手动指定已安装的Eigen路径

7. 自定义依赖项

7.1 不使用cuDNN

禁用cuDNN会降低精度但提高兼容性：

1. 禁用USE_CUDNN选项
2. 需大幅降低--net_resolution值

7.2 自定义Caffe

OpenPose使用定制版Caffe，用户也可指定自己的Caffe版本：

1. 禁用BUILD_CAFFE
2. 设置Caffe_INCLUDE_DIRS和Caffe_LIBS路径

7.3 自定义OpenCV

指定自定义OpenCV安装路径：

• Ubuntu/Mac：设置OPENCV_DIR变量
• Windows：替换OpenCV DLL和头文件

8. 文档生成（Ubuntu）

启用BUILD_DOCS选项可自动生成Doxygen文档，位于doc/doxygen/html/index.html。

9. 命令行配置（Ubuntu）

CMake支持多种配置场景：

1. 基础配置：

cmake ..

2. 自定义Caffe和OpenCV路径：

cmake -DOpenCV_INCLUDE_DIRS=/path/to/opencv/include \
  -DOpenCV_LIBS_DIR=/path/to/opencv/lib \
  -DCaffe_INCLUDE_DIRS=/path/to/caffe/include \
  -DCaffe_LIBS=/path/to/caffe/lib/libcaffe.so -DBUILD_CAFFE=OFF ..

3. 仅自定义OpenCV：

cmake -DOpenCV_CONFIG_FILE=/path/to/OpenCVConfig.cmake ..

结语

通过合理配置这些高级选项，用户可以根据自身硬件条件和使用需求，获得最优的OpenPose运行体验。建议初次安装时先使用默认配置，再根据实际需求逐步调整优化。

openpose 项目地址: https://gitcode.com/gh_mirrors/op/openpose