City3D 项目下载及安装教程

1. 项目介绍

City3D 是一个用于从机载 LiDAR 点云数据中进行大规模 LoD2 建筑重建的开源项目。该项目实现了基于假设和选择的建筑重建方法，能够处理大规模的城市数据，生成高质量的建筑模型。City3D 不仅是一个研究原型，还被用于创建城市规模的建筑模型，展示了其在实际应用中的潜力和局限性。

2. 项目下载位置

要下载 City3D 项目，请访问项目的 GitHub 仓库。你可以通过以下命令克隆项目到本地：

git clone https://github.com/tudelft3d/City3D.git

3. 项目安装环境配置

在安装 City3D 之前，你需要确保系统中安装了以下依赖项：

• Qt（v5.12 及以上版本）：仅 GUI 演示需要。
• CGAL（v5.6 及以上版本）：建议使用最新版本以获得更好的性能。
• OpenCV（v4.0 及以上版本）：仅需要主模块。
• Gurobi：用于核心优化步骤，建议使用。

环境配置示例

以下是配置环境的示例步骤：

1. 安装 Qt：

   sudo apt-get install qt5-default
   

2. 安装 CGAL：

   sudo apt-get install libcgal-dev
   

3. 安装 OpenCV：

   sudo apt-get install libopencv-dev
   

4. 安装 Gurobi：

   • 下载并安装 Gurobi 软件包。
   • 配置 Gurobi 环境变量。

环境配置图片示例

4. 项目安装方式

City3D 的安装可以通过多种方式进行，以下是其中一种常用的方法：

使用 CMake 构建

1. 进入项目根目录：

   cd City3D
   

2. 创建构建目录：

   mkdir build
   cd build
   

3. 使用 CMake 生成构建文件：

   cmake ..
   

4. 编译项目：

   make
   

使用 IDE 构建

你也可以使用支持 CMake 的 IDE（如 CLion 或 QtCreator）直接打开项目根目录中的 CMakeLists.txt 文件，然后进行构建。

5. 项目处理脚本

City3D 项目包含多个可执行程序，用于处理不同类型的建筑重建任务。以下是一些常用的处理脚本示例：

CLI_Example_1

该脚本用于从点云和足迹数据中重建多个建筑：

./CLI_Example_1 -i input_point_cloud.ply -f input_footprint.obj -o output_model.obj

CLI_Example_2

该脚本用于从点云数据中重建预分割的建筑：

./CLI_Example_2 -i input_point_cloud.ply -o output_model.obj

City3D GUI

该脚本用于启动带有图形用户界面的 City3D 演示程序：

./City3D

通过这些脚本，你可以轻松地处理大规模的建筑重建任务，生成高质量的 3D 建筑模型。