3D City Database - The Open Source CityGML Database

Version 3.3.1

  This software is free software and is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.


0. Index
--------

1. License
2. Copyright
3. About
4. System requirements
5. Database setup
6. Database deletion
7. Documentation
8. Cooperation partners and supporters
9. Active Developers
10. Contact
11. Websites
12. Disclaimer


1. License
----------

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this software except in compliance with the License.
You may obtain a copy of the License at
 
    http://www.apache.org/licenses/LICENSE-2.0


2. Copyright
------------

(C) 2013 - 2017
Chair of Geoinformatics
Technical University of Munich, Germany
https://www.gis.bgu.tum.de/


3. About
--------

The 3D City Database is a free 3D geo database to store, represent, and
manage virtual 3D city models on top of a standard spatial relational
database. The database model contains semantically rich, hierarchically
structured, multi-scale urban objects facilitating complex GIS modeling and
analysis tasks, far beyond visualization. The schema of the 3D City Database
is based on the City Geography Markup Language (CityGML), an international
standard for representing and exchanging virtual 3D city models issued
by the Open Geospatial Consortium (OGC).

The 3D City Database has been realized as Oracle Spatial/Locator and
PostgreSQL/PostGIS database schema, supporting following key features:

    * Full support for CityGML versions 2.0.0 and 1.0.0
    * Complex thematic modelling
    * Five different Levels of Detail (LODs)
    * Appearance information (textures and materials)
    * Digital terrain models (DTMs)
    * Representation of generic and prototypical 3D objects
    * Free, also recursive aggregation of geo objects
    * Flexible 3D geometries
	
The 3D City Database comes as a collection of SQL scripts that allow
for creating and dropping database instances.

The 3D City Database is an open source project and a joint development 
of the cooperation partners:
    * Chair of Geoinformatics, Technische Universität München,
    * virtualcitySYSTEMS GmbH, and 
    * M.O.S.S. Computer Grafik Systeme GmbH. 

In 2012, the 3D City Database received the Oracle Spatial Excellence Award
for Education and Research.


4. System requirements
----------------------

* Oracle DBMS >= 10g R2 with Spatial or Locator option
* PostgreSQL DBMS >= 9.1 with PostGIS extension >= 2.0


5. Database setup
-----------------

To create a new database instance of the 3D City Database, simply execute
the SQL script "CREATE_DB.sql", which is available for both Oracle and
PostgreSQL and can be found in the respective subfolder of the distribution
package. The script will start the setup procedure and invoke additional
scripts in the background.

The execution of the script substantially differs for Oracle and PostgreSQL.
Please refer to the documentation of the 3D City Database for a
comprehensive step-by-step installation guide.

The setup procedure requires the following mandatory user inputs:
1) Spatial Reference Identifier for newly created geometry objects (SRID),
2) Corresponding GML conformant URN encoding for gml:srsName attributes.

For Oracle, two additional inputs are required:
3) Decision whether the database instance should be versioning enabled,
4) Whether the Oracle DBMS runs with Locator or Spatial option. 


6. Database deletion
--------------------

To drop an existing database instance of the 3D City Database, simply execute
the SQL script "DROP_DB.sql" for your database system (Oracle or PostgreSQL).
Please refer to the PDF documentation of the 3D City Database for a
comprehensive step-by-step guide.


7. Documentation
----------------

A complete and comprehensive documentation on the 3D City Database is provided
in the distribution package and can be downloaded from the project's website at
http://www.3dcitydb.org/3dcitydb/documentation/ 


8. Cooperation partners and supporters  
--------------------------------------

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

* Chair of Geoinformatics, Technical University of Munich
  https://www.gis.bgu.tum.de/
* virtualcitySYSTEMS GmbH, Berlin
  http://www.virtualcitysystems.de/
* M.O.S.S. Computer Grafik Systeme GmbH, Taufkirchen
  http://www.moss.de/

  
9. Active Developers
--------------------

Claus Nagel <cnagel@virtualcitysystems.de>
Felix Kunde <felix-kunde@gmx.de>
Zhihang Yao <zhihang.yao@tum.de>
György Hudra <ghudra@moss.de>
Arda Müftüoglu <amueftueoglu@moss.de>
Richard Redweik <richard.redweik@posteo.de>
Thomas H. Kolbe <thomas.kolbe@tum.de>

Version 3.0 is based on earlier versions of the 3D City Database.
Please refer to the 3D City Database documentation for the list of
all contributors to previous versions.


10. Contact
-----------

thomas.kolbe@tum.de
cnagel@virtualcitysystems.de
pwillkomm@moss.de


11. Websites
------------

Official 3D City Database website: 
http://www.3dcitydb.org/

Related websites:
https://github.com/3dcitydb/
http://www.gis.bgu.tum.de/
http://www.citygml.org/
http://www.citygmlwiki.org/
http://www.opengeospatial.org/standards/citygml


12. Disclaimer
--------------

THIS SOFTWARE IS PROVIDED BY THE CHAIR OF GEOINFORMATION FROM TU MUNICH
(TUMGI) "AS IS" AND "WITH ALL FAULTS." 
TUMGI MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND CONCERNING THE 
QUALITY, SAFETY OR SUITABILITY OF THE SOFTWARE, EITHER EXPRESSED OR 
IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED WARRANTIES OF 
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.

TUMGI MAKES NO REPRESENTATIONS OR WARRANTIES AS TO THE TRUTH, ACCURACY OR 
COMPLETENESS OF ANY STATEMENTS, INFORMATION OR MATERIALS CONCERNING THE 
SOFTWARE THAT IS CONTAINED ON AND WITHIN ANY OF THE WEBSITES OWNED AND 
OPERATED BY TUMGI.

IN NO EVENT WILL TUMGI BE LIABLE FOR ANY INDIRECT, PUNITIVE, SPECIAL, 
INCIDENTAL OR CONSEQUENTIAL DAMAGES HOWEVER THEY MAY ARISE AND EVEN IF 
TUMGI HAVE BEEN PREVIOUSLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.