【亲测免费】 Replica-Dataset 项目使用教程

1. 项目目录结构及介绍

Replica-Dataset 项目的目录结构如下：

Replica-Dataset/
├── 3rdparty/
│   └── ReplicaSDK/
├── assets/
├── cmake/
├── .gitignore
├── .gitmodules
├── CMakeLists.txt
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── build.sh
├── download.sh
├── win_download.bat
└── ...

目录结构介绍

• 3rdparty/: 包含第三方依赖库，如 ReplicaSDK。
• assets/: 包含项目所需的资源文件。
• cmake/: 包含 CMake 配置文件。
• .gitignore: Git 忽略文件配置。
• .gitmodules: Git 子模块配置。
• CMakeLists.txt: CMake 项目构建配置文件。
• CODE_OF_CONDUCT.md: 行为准则文件。
• CONTRIBUTING.md: 贡献指南文件。
• LICENSE: 项目许可证文件。
• README.md: 项目介绍和使用说明文件。
• build.sh: 构建脚本，用于编译项目。
• download.sh: 下载脚本，用于下载数据集。
• win_download.bat: Windows 平台下的下载脚本。

2. 项目启动文件介绍

Replica-Dataset 项目的主要启动文件是 ReplicaViewer 和 ReplicaRenderer。

ReplicaViewer

ReplicaViewer 是一个交互式 UI，用于探索 Replica 数据集。启动 ReplicaViewer 的命令如下：

./build/bin/ReplicaViewer mesh.ply /path/to/atlases [mirrorFile]

• mesh.ply: 场景的网格文件。
• /path/to/atlases: 纹理文件的路径。
• mirrorFile: 可选参数，用于指定镜面文件。

ReplicaRenderer

ReplicaRenderer 用于从 Replica 数据集中渲染图像，适用于程序化定义的轨迹，无需 UI。启动 ReplicaRenderer 的命令如下：

./build/bin/ReplicaRenderer mesh.ply textures glass.sur

• mesh.ply: 场景的网格文件。
• textures: 纹理文件的路径。
• glass.sur: 玻璃和镜面表面的参数文件。

3. 项目配置文件介绍

Replica-Dataset 项目的主要配置文件包括 CMakeLists.txt 和 replica_stage_config.json。

CMakeLists.txt

CMakeLists.txt 是 CMake 项目的构建配置文件，定义了项目的构建规则和依赖项。主要内容包括：

• 项目名称和版本号。
• 包含目录和库目录。
• 编译选项和链接库。

replica_stage_config.json

replica_stage_config.json 是 AI Habitat 的场景配置文件，定义了场景级别的参数。主要内容包括：

• 场景名称和路径。
• 导航网格配置。
• 纹理和材质配置。

通过这些配置文件，用户可以自定义项目的构建和运行环境，以满足不同的需求。