openpose环境配置

### 如何配置OpenPose运行环境

#### 准备工作
为了成功安装和配置OpenPose，确保计算机满足最低硬件需求。对于带有NVIDIA显卡的机器，推荐使用CUDA加速性能；而对于无GPU支持的情况，则依赖于CPU处理。

#### 软件准备
- **操作系统**: Windows 10 或更高版本。
- **Python 版本**: 推荐 Python 3.7 至 3.9 的稳定发行版[^1]。
- **构建工具**:
- Visual Studio (建议 VS2017 及以上)[^2]
- CMake 3.22.1 或更新版本用于项目生成

#### 获取源码
通过 Git 命令下载最新版本的 OpenPose 源代码到本地目录：

git clone https://github.com/CMU-Perceptual-Computing-Lab/openpose.git
cd openpose/
git submodule update --init --recursive --remote

此过程会拉取所有必要的子模块，包括预训练模型和其他第三方库[^3]。

#### 编译设置
进入 `openpose` 文件夹内执行以下命令来启动CMake GUI界面或命令行模式下的配置流程:

如果采用图形化界面(CMake-GUI)，则需指定源路径(Source Path) 和目标路径(Build Path), 并点击Configure按钮选择合适的编译器(Visual Studio Generator). 同时勾选选项`BUILD_PYTHON`以启用Python接口的支持.

当利用命令行方式进行配置时, 使用如下指令序列完成相同的操作:

mkdir build & cd build
cmake .. ^
    -DBUILD_SHARED_LIBS=ON ^
    -DCMAKE_INSTALL_PREFIX=%CD%\install ^
    -DPYBIND11_PYTHON_VERSION=3.9 ^
    -DOPENPOSE_BUILD_EXAMPLES=OFF ^
    -DOPENPOSE_BUILD_UNIT_TESTS=OFF ^
    -DBUILD_PYTHON=ON

注意这里指定了Python解释器的具体版本号为3.9，并关闭了不必要的测试样例编译开关以加快速度[^4].

接着输入`cmake --build . --config Release --target install` 开始正式编译与安装过程.

#### 解决常见问题
遇到“No module named 'pyopenpose'” 错误提示通常是因为当前使用的Python环境中缺少对应平台架构(pyd文件)或是未正确激活包含该扩展包的虚拟环境所致。确认所用Pyhon解释器位数(x86 vs x64)匹配以及是否已按照上述指导建立了相应版本的Anaconda环境。

#### 测试验证
最后，在新建立的Python环境下尝试导入 pyopenpose 库来进行简单的功能调用来检验整个部署工作的有效性。

import pyopenpose as op
print(op.__version__)