适用于 Windows 和 Mac OS X 的二进制版本

为了方便使用 3dfier，我们创建了预构建的二进制文件，可以从发布页面下载。

下载最新版本并将存档解压缩到易于查找的位置，而不是浏览器的下载文件夹中。

为了能够快速测试 3dfier，可以下载示例数据集并将存档解压缩到 3dfier 的文件夹中。

测试数据

在文件夹example_data（下载示例数据集）中有一小部分BGT数据集（荷兰的2D 1:1k地形数据集）和AHN3 LIDAR数据集的一部分可以用于测试。生成的模型（在 OBJ 中）可以在example_data/output/test_area.obj

此外，还有一个开放数据网站，其中包含使用 3dfier 生成的几个荷兰城市的 3D 模型。

验证配置文件

配置以YAML 格式存储，需要有效才能让解析器读取文件。配置文件可以使用YAML Lint进行架构验证

运行 3dfier：

Windows 打开命令行（单击开始并键入command或cmd）。使用命令行浏览到您提取示例文件的文件夹并运行： 3dfier myconfig.yml -o output.ext

Mac OS X 和 Linux 打开控制台。使用控制台浏览到您提取示例文件的文件夹并运行： $ ./3dfier myconfig.yml --OBJ output.obj

码头工人

3dfier 提供了一个高山基础图像，它试图为您的矢量数据源提供尽可能多的自由。矢量数据由 GDAL/OGR 读取。

要在 Docker 上运行 3dfier，只需执行：

$ docker run --rm --name 3dfier -v <local path where your files are>:/data tudelft3d/3dfier:<tag> 3dfier <name of config file> <... 3dfier parameters>

您所有的输入数据都需要在<local path where your files are>配置文件中，您需要在配置文件中引用您的输入数据相对于<local path where your files are>. 要实现这一点，要么将您的数据和配置移动到<local path where your files are>（和子目录），要么设置<local path where your files are>为包含您需要的所有数据和配置文件的最低公共祖先。

请记住，<local path where your files are>任何用户都需要可写，否则您的输出将不会被保存。

例如在示例数据集上运行它（在 Linux 上）：

$ cd 3dfier/example_data
$ docker run --rm -it -v 3dfier/example_data:/data tudelft3d/3dfier:latest 3dfier testarea_config_unix.yml --OBJ test.obj

还有一个关于如何使用 3dfier 生成 3D 模型的教程。

准备 BGT 数据

要准备 BGT 数据作为 3dfier 的输入，请查看resources/BGT_prepare/ReadMe.md