SMPLify-X 项目使用教程
项目地址: https://gitcode.com/gh_mirrors/smp/smplify-x 1. 项目目录结构及介绍
SMPLify-X 项目的目录结构如下：
smplify-x/
├── cfg_files/
│ ├── fit_smpl.yaml
│ ├── fit_smplh.yaml
│ ├── fit_smplx.yaml
│ └── ...
├── images/
│ └── ...
├── smplifyx/
│ ├── main.py
│ ├── render_results.py
│ └── ...
├── .gitignore
├── LICENSE
├── README.md
├── optional-requirements.txt
└── requirements.txt
目录结构介绍
- cfg_files/: 包含项目的配置文件，如
fit_smpl.yaml,fit_smplh.yaml,fit_smplx.yaml等，用于配置不同的身体模型。 - images/: 存放项目中使用的图像文件。
- smplifyx/: 包含项目的主要代码文件，如
main.py和render_results.py。 - .gitignore: Git 忽略文件，用于指定不需要版本控制的文件。
- LICENSE: 项目的许可证文件。
- README.md: 项目的说明文档。
- optional-requirements.txt: 可选的依赖项文件。
- requirements.txt: 项目的依赖项文件。
2. 项目启动文件介绍
项目的启动文件是 smplifyx/main.py。该文件是执行 SMPLify-X 项目的主要入口。
启动命令
python smplifyx/main.py --config cfg_files/fit_smplx.yaml --data_folder DATA_FOLDER --output_folder OUTPUT_FOLDER --visualize="True/False" --model_folder MODEL_FOLDER --vposer_ckpt VPOSER_FOLDER --part_segm_fn smplx_parts_segm.pkl
参数说明
--config: 指定配置文件的路径，如cfg_files/fit_smplx.yaml。--data_folder: 指定数据文件夹的路径，该文件夹应包含images和keypoints两个子文件夹。--output_folder: 指定输出文件夹的路径，用于保存结果。--visualize: 是否可视化结果，可选值为True或False。--model_folder: 指定模型文件夹的路径。--vposer_ckpt: 指定 VPoser 模型的路径。--part_segm_fn: 指定身体部位分割文件的路径。
3. 项目配置文件介绍
项目的配置文件位于 cfg_files/ 目录下，主要包括以下几个文件：
- fit_smpl.yaml: 用于配置 SMPL 模型的参数。
- fit_smplh.yaml: 用于配置 SMPL+H 模型的参数。
- fit_smplx.yaml: 用于配置 SMPL-X 模型的参数。
配置文件示例
以 fit_smplx.yaml 为例：
# fit_smplx.yaml
model_type: 'smplx'
gender: 'neutral'
num_betas: 10
num_expression_coeffs: 10
use_face_contour: True
use_hands: True
use_face: True
use_3d_translation: True
配置项说明
- model_type: 指定使用的模型类型，如
smplx。 - gender: 指定模型的性别，如
neutral。 - num_betas: 指定身体形状参数的数量。
- num_expression_coeffs: 指定面部表情参数的数量。
- use_face_contour: 是否使用面部轮廓。
- use_hands: 是否使用手部模型。
- use_face: 是否使用面部模型。
- use_3d_translation: 是否使用三维平移。
通过以上配置文件，可以灵活地调整 SMPLify-X 项目的参数，以适应不同的需求。