3DGS-Avatar 项目安装与使用教程

3DGS-Avatar 项目安装与使用教程

3dgs-avatar-release 3DGS-Avatar: Animatable Avatars via Deformable 3D Gaussian Splatting 项目地址: https://gitcode.com/gh_mirrors/3d/3dgs-avatar-release

1. 项目目录结构及介绍

3dgs-avatar-release/
├── configs/
│   ├── config1.yaml
│   ├── config2.yaml
│   └── ...
├── dataset/
│   ├── dataset1/
│   ├── dataset2/
│   └── ...
├── models/
│   ├── model1.py
│   ├── model2.py
│   └── ...
├── utils/
│   ├── dataset_utils.py
│   ├── extract_smpl_parameters.py
│   ├── render.py
│   └── train.py
├── README.md
├── environment.yml
└── ...

目录结构介绍

• configs/: 存放项目的配置文件，如 config1.yaml 和 config2.yaml。
• dataset/: 存放数据集文件，如 dataset1/ 和 dataset2/。
• models/: 存放模型定义文件，如 model1.py 和 model2.py。
• utils/: 存放工具函数和脚本，如 dataset_utils.py, extract_smpl_parameters.py, render.py, 和 train.py。
• README.md: 项目的基本介绍和使用说明。
• environment.yml: 项目的环境配置文件，用于创建 Anaconda 环境。

2. 项目的启动文件介绍

项目的启动文件主要位于 utils/ 目录下，包括以下几个关键文件：

• extract_smpl_parameters.py: 用于提取 SMPL 模型的参数。
• render.py: 用于渲染模型。
• train.py: 用于训练模型。

启动文件介绍

• extract_smpl_parameters.py: 该脚本用于从 SMPL 模型中提取关键参数，通常在数据预处理阶段使用。
• render.py: 该脚本用于将模型渲染成图像或视频，通常在模型训练完成后使用。
• train.py: 该脚本是项目的主要启动文件，用于启动模型的训练过程。

3. 项目的配置文件介绍

项目的配置文件主要位于 configs/ 目录下，常见的配置文件包括 config1.yaml 和 config2.yaml。

配置文件介绍

• config1.yaml: 该配置文件定义了模型训练的基本参数，如学习率、批量大小、训练轮数等。
• config2.yaml: 该配置文件定义了模型渲染的参数，如输出分辨率、渲染模式等。

配置文件示例

# config1.yaml
learning_rate: 0.001
batch_size: 32
num_epochs: 100
...

# config2.yaml
output_resolution: 1024x1024
render_mode: "high_quality"
...

通过以上配置文件，用户可以自定义模型的训练和渲染参数，以满足不同的需求。

3dgs-avatar-release 3DGS-Avatar: Animatable Avatars via Deformable 3D Gaussian Splatting 项目地址: https://gitcode.com/gh_mirrors/3d/3dgs-avatar-release