Sin3DM 项目使用教程

1. 项目目录结构及介绍

Sin3DM 项目的目录结构如下：

Sin3DM/
├── data/
│   └── mesh_sampler.py
├── evaluation/
│   └── eval_full.py
├── rendering/
│   └── mvrender_script.py
├── scripts/
│   └── run_single.sh
├── src/
│   ├── app.py
│   ├── train.py
│   ├── sample.py
│   └── checkpoints/
├── .gitmodules
├── LICENSE
├── README.md
├── requirements.txt
└── teaser.jpg

目录介绍

• data/: 包含用于数据预处理的脚本，如 mesh_sampler.py，用于从纹理网格中采样点。
• evaluation/: 包含用于评估生成模型的脚本，如 eval_full.py，用于计算几何质量等指标。
• rendering/: 包含用于渲染模型的脚本，如 mvrender_script.py，用于从多个视图渲染模型。
• scripts/: 包含用于运行项目的脚本，如 run_single.sh，用于数据预处理、训练、采样和评估。
• src/: 包含项目的主要代码，如 app.py（启动文件）、train.py（训练脚本）、sample.py（采样脚本）和 checkpoints/（预训练模型存放目录）。
• .gitmodules: Git 子模块配置文件。
• LICENSE: 项目许可证文件。
• README.md: 项目介绍和使用说明。
• requirements.txt: 项目依赖包列表。
• teaser.jpg: 项目预览图。

2. 项目启动文件介绍

项目的启动文件是 src/app.py。该文件用于启动 Gradio 演示界面，用户可以通过该界面生成新的纹理网格。

启动步骤

1. 下载预训练模型并将其放置在 src/checkpoints/ 目录下。
2. 进入 src/ 目录：

   cd src
   

3. 运行启动脚本：

   python app.py
   

3. 项目配置文件介绍

项目的配置文件主要是 requirements.txt，该文件列出了项目运行所需的所有 Python 依赖包。

安装依赖

1. 创建并激活 Conda 环境：

   conda create -n sin3dm python=3.10
   conda activate sin3dm
   

2. 安装依赖包：

   pip install -r requirements.txt
   

通过以上步骤，您可以成功启动 Sin3DM 项目并开始使用。