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.
- Full support for CityGML versions 2.0.0 and 1.0.0
- Support for CityGML Application Domain Extensions (ADEs) through software extensions
- Support for Oracle Locator/Spatial and PostgreSQL/PostGIS
- Reading/writing CityGML instance documents of arbitrary file size
- Export of KML/COLLADA/glTF models including tiling schemas for visualization and interactive exploration of large city models in Digital Earth Browsers, 3D GIS, and computer graphics software
- Generic KML information balloons
- Export of thematic object data into tables. Supported data formats are CSV and Microsoft Excel
- Resolving and preservation of forward and backwards XLinks in CityGML datasets
- Full support of 3D Coordinate Reference Systems (CRS) and 3D coordinate transformations; support for user-defined CRS
- Coordinate transformations for CityGML exports
- XML validation of CityGML instance documents
- Multithreaded programming facilitating high-performance CityGML processing
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.
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.
The latest stable release of the 3D City Database Importer/Exporter is 4.0.
Download a Java-based executable installer for the software here. Previous releases are available from the releases section.
- Java JRE or JDK >= 1.8
- 3D City Database on
- Oracle DBMS >= 10G R2 with Spatial or Locator option
- PostgreSQL DBMS >= 9.3 with PostGIS extension >= 2.0
The 3D City Database Importer/Exporter can be run on any platform providing appropriate Java support.
A complete and comprehensive documentation on the 3D City Database and the Importer/Exporter tool is installed with the software and 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.
- To file bugs found in the software create a GitHub issue.
- To contribute code for fixing filed issues create a pull request with the issue id.
- To propose a new feature create a GitHub issue and open a discussion.
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:
3DCityDB-Importer-Exporter.bat(Microsoft Windows family)3DCityDB-Importer-Exporter(UNIX/Linux family, macOS)
On most platforms, double-clicking the start script or its shortcut launches the application.
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.
The 3D City Database Importer/Exporter has been developed by and with the support from the following cooperation partners:
- Chair of Geoinformatics, Technical University of Munich
- virtualcitySYSTEMS GmbH, Berlin
- M.O.S.S. Computer Grafik Systeme GmbH, Taufkirchen
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.