pg2b3dm 项目使用教程

pg2b3dm 项目使用教程

1. 项目的目录结构及介绍

pg2b3dm 项目的目录结构如下：

pg2b3dm/
├── github/
│   └── workflows/
├── dataprocessing/
├── sample_data/
├── src/
├── .gitignore
├── LICENSE
├── README.md
├── cesium_notes.md
├── delaware_cesium.png
├── delaware_mapbox.png
├── demo_pg2b3dm.gif
├── getting_started.md
├── mapbox_notes.md
└── styling.md

目录结构介绍

• github/workflows/: 包含 GitHub Actions 的工作流配置文件。
• dataprocessing/: 包含数据处理相关的脚本和配置文件。
• sample_data/: 包含示例数据文件，用于测试和演示。
• src/: 包含项目的源代码文件。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目的开源许可证文件。
• README.md: 项目的介绍和使用说明。
• cesium_notes.md: Cesium 相关的笔记和说明。
• delaware_cesium.png: 示例图片，展示 Delaware 地区在 Cesium 中的效果。
• delaware_mapbox.png: 示例图片，展示 Delaware 地区在 Mapbox 中的效果。
• demo_pg2b3dm.gif: 项目演示的 GIF 动画。
• getting_started.md: 项目入门指南。
• mapbox_notes.md: Mapbox 相关的笔记和说明。
• styling.md: 项目样式相关的说明。

2. 项目的启动文件介绍

pg2b3dm 项目的启动文件主要是 src/ 目录下的源代码文件。具体来说，核心的启动文件是 pg2b3dm 可执行文件，它负责将 PostGIS 中的 3D 几何数据转换为 3D Tiles 格式。

启动文件介绍

• pg2b3dm: 这是一个命令行工具，用于从 PostGIS 数据库中提取 3D 几何数据并将其转换为 3D Tiles 格式。启动该工具时，可以通过命令行参数指定数据库连接信息、几何数据表、输出路径等。

启动命令示例

$ pg2b3dm -h localhost -U postgres -c geom -d postgres -t sibbe -a identificatie

3. 项目的配置文件介绍

pg2b3dm 项目的配置文件主要包括数据库连接配置和输出路径配置。这些配置可以通过命令行参数进行设置。

配置文件介绍

• 数据库连接配置: 通过命令行参数 -h（主机）、-U（用户名）、-d（数据库名）、-p（端口）等参数指定数据库连接信息。
• 输出路径配置: 通过命令行参数 -o（输出路径）指定生成的 3D Tiles 文件的输出目录。

配置示例

$ pg2b3dm -h localhost -U postgres -d postgres -t sibbe -o output

以上命令将连接到本地 PostgreSQL 数据库，并从 sibbe 表中提取 3D 几何数据，生成的 3D Tiles 文件将存储在 output 目录中。

---

通过以上步骤，您可以成功启动并配置 pg2b3dm 项目，将 PostGIS 中的 3D 几何数据转换为 3D Tiles 格式。