CF-3DGS开源项目教程

CF-3DGS开源项目教程

CF-3DGS 项目地址: https://gitcode.com/gh_mirrors/cf/CF-3DGS

1. 项目目录结构及介绍

CF-3DGS项目的目录结构如下：

• arguments: 存储了一些参数设置的文件。
• assets: 包含项目所需的静态资源。
• gaussian_renderer: 实现高斯渲染器的相关代码。
• lpipsPyTorch: 实现LPIPS（学习到的感知图像相似性）的PyTorch版本的相关代码。
• scene: 场景相关的处理代码。
• submodules: 存储项目依赖的子模块。
• trainer: 训练模型的代码。
• utils: 工具类代码，包含一些常用的函数和工具。
• .gitignore: 指定git忽略的文件和目录。
• .gitmodules: 指定git子模块的相关信息。
• LICENSE: 项目许可证文件。
• LICENSE_inria.md: INRIA版本的许可证文件。
• README.md: 项目说明文件。
• convert.py: 视频转帧的工具脚本。
• environment.yml: 项目环境配置文件，用于anaconda环境。
• metrics.py: 评估指标的相关代码。
• render.py: 渲染相关的代码。
• requirements.txt: 项目依赖的Python包列表。
• run_cf3dgs.py: 项目的主启动文件。
• train.py: 训练模型的主脚本。

2. 项目的启动文件介绍

项目的启动文件是run_cf3dgs.py。该文件是项目的主入口，用于启动训练、评估等任务。以下是一些基本的启动命令：

• 启动训练：

  python run_cf3dgs.py -s ./data/Tanks/Francis --mode train --data_type tanks
  

• 启动评估（姿态估计）：

  python run_cf3dgs.py --source data/Tanks/Francis --mode eval_pose --data_type tanks --model_path ${CKPT_PATH}
  

• 启动评估（新视角合成）：

  python run_cf3dgs.py --source data/Tanks/Francis --mode eval_nvs --data_type tanks --model_path ${CKPT_PATH}
  

3. 项目的配置文件介绍

项目的配置主要通过requirements.txt和environment.yml两个文件进行。

• requirements.txt文件列出了项目运行所依赖的Python包，可以通过以下命令安装：

  pip install -r requirements.txt
  

• environment.yml文件用于配置anaconda环境，包含了项目运行所需的所有依赖，包括Python版本、CUDA版本以及必要的Python包。使用以下命令创建并激活环境：

  conda create -n cf3dgs python=3.10
  conda activate cf3dgs
  conda install -c pytorch -c nvidia pytorch-cuda=11.7
  conda install -c conda-forge cudatoolkit-dev=11.7.0
  pip install -r requirements.txt
  

CF-3DGS 项目地址: https://gitcode.com/gh_mirrors/cf/CF-3DGS