Interactive3D 项目启动与配置教程

Interactive3D 项目启动与配置教程

1. 项目目录结构及介绍

Interactive3D 是一个用于交互式3D生成的开源项目。以下是项目的目录结构及各部分的简要介绍：

interactive3d/
├── .github/               # GitHub 工作流和配置文件
├── assets/                # 资源文件，如图片等
├── configs/               # 配置文件
├── docker/                # Docker 配置文件
├── docs/                  # 文档文件
├── extern/                # 外部依赖库
├── gsgen/                 # GSGen 相关文件
├── threestudio/           # ThreeStudio 相关文件
├── utils/                 # 实用工具脚本
├── .editorconfig           # 编辑器配置文件
├── .gitignore             # Git 忽略文件
├── .pre-commit-config.yaml # pre-commit 配置文件
├── .pylintrc              # PyLint 配置文件
├── DOCUMENTATION.md       # 项目文档
├── LICENSE                # 项目许可证
├── README.md              # 项目说明文件
├── gradio_app.py          # Gradio 应用脚本
├── keyboard.py            # 键盘处理脚本
├── launch.py              # 启动脚本
├── requirements-dev.txt   # 开发环境依赖文件
├── requirements.txt       # 运行环境依赖文件

2. 项目的启动文件介绍

项目的启动文件是 launch.py。该脚本负责启动整个 Interactive3D 项目。以下是一些基本的启动命令：

python launch.py --config configs/fit_gs.yaml --train --gpu 0

这个命令会使用配置文件 fit_gs.yaml 启动训练过程，并指定 GPU 为 0。

3. 项目的配置文件介绍

配置文件位于 configs/ 目录下，用于定义项目的运行参数。以下是一些常见的配置文件及其用途：

• fit_gs.yaml: 定义了 Gaussian Splatting 的拟合过程参数。
• geo_refine.yaml: 定义了几何细化的参数。
• post_geo_refine.yaml: 定义了几何细化后的处理参数。
• interested_refine.yaml: 定义了感兴趣区域的选择和细化参数。

配置文件通常包含以下内容：

system:
  prompt_processor:
    prompt: "your prompt"
  init_type: 'gsgen'
  only_super: True
trainer:
  max_steps: 20000

在这个例子中，system 部分 定义了系统的初始化类型和超级采样标志，trainer 部分定义了训练的最大步骤数。

在启动项目之前，需要根据实际情况修改这些配置文件中的参数，以适应不同的需求和硬件环境。