Mirrored-Human 的安装和配置教程

项目基础介绍

Mirrored-Human 是一个开源项目，致力于从单张图片中重构3D人体姿态，这张图片中可以同时看到人和镜子中的人。该项目是 CVPR 2021 年的口头报告，采用了优化方法来实现对人体姿态的三维重建。

主要编程语言

该项目主要使用 Python 编程语言，并基于 PyTorch 深度学习框架。

关键技术和框架

• 优化方法：用于从图片中估计3D人体姿态。
• PyTorch：一个流行的深度学习框架，用于模型的训练和推理。
• EasyMocap：该项目与 EasyMocap 密切相关，后者是一个用于运动捕捉的框架。
• 图像处理技术：用于从图片中提取特征，比如通过标注镜子的边缘来计算消失点。

安装和配置准备工作

在开始安装前，请确保您的计算机满足以下条件：

• Python 3.x
• PyTorch -pip（Python 包管理器）

如果您的计算机尚未安装这些工具，请按照以下步骤进行安装。

安装 Python

访问 Python 官方网站下载并安装最新版本的 Python。确保安装过程中选中了“添加 Python 到环境变量”的选项。

安装 PyTorch

访问 PyTorch 官方网站，根据您的系统和 Python 版本选择合适的安装命令，并在命令行中执行。

安装 pip

如果您的 Python 安装中未包含 pip，您可以单独下载并安装 pip。访问 pip 官方网站获取安装说明。

详细安装步骤

1. 克隆项目到本地计算机：

   git clone https://github.com/zju3dv/Mirrored-Human.git
   cd Mirrored-Human
   

2. 安装项目依赖：

   在项目目录下运行以下命令安装所需的所有 Python 包。

   pip install -r requirements.txt
   

3. 准备数据集：

   项目使用的数据集需要从官方渠道获取，并放置在项目指定的目录下。由于版权限制，原始数据集不能直接共享。

4. 运行演示：

   下载项目提供的演示数据集后，运行以下命令启动演示：

   python3 apps/demo/1v1p_mirror.py --data <path_to_sample>/zju-m-demo --out <path_to_sample>/zju-m-demo-output --vis_smpl --video
   

   替换 <path_to_sample> 为您下载的演示数据集的实际路径。

按照以上步骤操作，您应该能够成功安装并运行 Mirrored-Human 项目。如果在安装过程中遇到任何问题，请查阅项目的官方文档或向维护者提问。