3D City Database Importer/Exporter

The 3D City Database Importer/Exporter is a Java based front-end for the 3D City Database. It allows for high-performance loading and extracting 3D city model data.

The 3D City Database Importer/Exporter comes with both a Graphical User Interface (GUI) and a Command Line Interface (CLI). The CLI allows for employing the tool in batch processing workflows and third party applications.

License

The 3D City Database Importer/Exporter is licensed under the Apache License, Version 2.0. See the LICENSE file for more details.

Note that releases of the software before version 3.3.0 continue to be licensed under GNU LGPL 3.0. To request a previous release of the 3D City Database Importer/Exporter under Apache License 2.0 create a GitHub issue.

Latest release

The latest stable release of the 3D City Database Importer/Exporter is 4.2.3.

Download a Java-based executable installer for the software here. Previous releases are available from the releases section.

System requirements

The 3D City Database Importer/Exporter can be run on any platform providing appropriate Java support.

Documentation and literature

A complete and comprehensive documentation on the 3D City Database and the Importer/Exporter tool is available online.

An Open Access paper on the 3DCityDB has been published in the International Journal on Open Geospatial Data, Software and Standards 3 (5), 2018: Z. Yao, C. Nagel, F. Kunde, G. Hudra, P. Willkomm, A. Donaubauer, T. Adolphi, T. H. Kolbe: 3DCityDB - a 3D geodatabase solution for the management, analysis, and visualization of semantic 3D city models based on CityGML. Please use this reference when citing the 3DCityDB project.

Contributing

Installing and running

The easiest way to get the Importer/Exporter running on your computer is to download an installer from the releases section. The installers are named 3DCityDB-Importer-Exporter-<version>-Setup.jar and are packaged as executable JAR file. So double-clicking the JAR file should run the installer. The installer will guide you through the steps of the installation process.

After installation, start scripts are available in the bin subfolder of the installation directory. During setup you can additionally choose to create shortcuts on your desktop and in the start menu of your preferred OS.

Simply execute the start script suitable for your platform:

On most platforms, double-clicking the start script or its shortcut launches the application.

Building

The Importer/Exporter uses Gradle as build system. To build the application from source, clone the repository to your local machine and run the following command from the root of the repository.

> gradlew installDist

The script automatically downloads all required dependencies for building and running the Importer/Exporter. So make sure you are connected to the internet. The build process runs on all major operating systems and only requires a Java 8 JDK or higher to run.

If the build was successful, you will find the Importer/Exporter package under impexp-client/build/install. To launch the application, simply use the starter scripts in the bin subfolder.

You may also choose to build an installer for the Importer/Exporter with the following command.

> gradlew buildInstaller

The installer package will be available under impexp-client/build/distributions.

Cooperation partners and supporters

The 3D City Database Importer/Exporter has been developed by and with the support from the following cooperation partners:

More information

OGC CityGML is an open data model and XML-based format for the storage and exchange of semantic 3D city models. It is an application schema for the Geography Markup Language version 3.1.1 (GML3), the extendible international standard for spatial data exchange issued by the Open Geospatial Consortium (OGC) and the ISO TC211. The aim of the development of CityGML is to reach a common definition of the basic entities, attributes, and relations of a 3D city model.

CityGML is an international OGC standard and can be used free of charge.