This repository has been archived by the owner on Jan 28, 2021. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
223 lines (165 loc) · 7.6 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
3D City Database Importer/Exporter v1.6-postgis
This program is free software and comes WITHOUT ANY WARRANTY.
See the DISCLAIMER at the end of this document for more details.
0. Index
--------
1. License
2. Copyright
3. About
4. System requirements
5. (Un)Installation
6. Running the application
7. Cooperation partners and supporters
8. Developers
9. Contact
10. Websites
11. Disclaimer
1. License
----------
The 3D City Database Importer/Exporter is free software under
the GNU Lesser General Public License Version 3.0. See the file LICENSE
for more details. For a copy of the GNU Lesser General Public License see
the files COPYING and COPYING.LESSER or visit http://www.gnu.org/licenses/.
2. Copyright
------------
(c) 2007 - 2013
Institute for Geodesy and Geoinformation Science (IGG)
Technische Universität Berlin, Germany
http://www.igg.tu-berlin.de/
3. About
--------
The 3D City Database Importer/Exporter is a Java based front-end for
the 3D City Database version 2.0. It allows for high-performance
importing and exporting spatial data for a virtual 3D city model.
Main characteristics:
* Full support for CityGML version 1.0.0 and 0.4.0
* Full support of 3D CRS and 3D coordinate transformations
* Export of KML/COLLADA models
* Generic KML information balloons
* Reading/writing CityGML instance documents of arbitrary file size
* Resolving of forward and backwards XLinks
* User-defined Coordinate Reference System
* Coordinate transformations for CityGML exports
* Map window for graphical selection of bounding boxes
* XML validation of CityGML instance documents
* Multithreaded programming facilitating high-performance CityGML
processing
* Matching/merging of building features within the database
* Proxy support for HTTP, HTTPS, and SOCKS protocols
The 3D City Database Importer/Exporter is shipped with both a Graphical
User Interface (GUI) for end-user interaction and a Command Line
Interface (CLI). The latter one allows for employing the tool in batch
processing workflows or embedding its functionality into third party
programs.
4. System requirements
----------------------
* Java JRE or JDK >= 1.6.0_05
* 3D City Database version 2.0.6 on an PostgreSQL DBMS >= 9.0 with PostGIS Extension >= 2.0
The 3D City Database Importer/Exporter can be run on any platform
providing appropriate Java support. It has been tested on the
following platforms:
- Microsoft Windows XP, Vista, Windows 7
- Apple Mac OS X 10.6
- Ubuntu 9, 10, 11
5. (Un)Installation
-------------------
It is recommended to use the universal installer to unpack the
3D City Database Importer/Exporter application files to your local
computer. The universal installer will guide you through the steps of the
installation process. Afterwards, you can immediately run the application
(see next section).
When you successfully install the 3D City Database Importer/Exporter,
an uninstaller is automatically generated in the 'uninstaller' subfolder
of the installation folder. Please use this uninstaller in order to remove
the 3D City Database Importer/Exporter application files from your
computer. Alternatively, you can simply delete the entire installation
folder.
6. Running the application
--------------------------
For running the 3D City Database Importer/Exporter use one of the
following options:
a) Recommended:
Use the provided starter scripts to launch the application. The starter
scripts can be found in the installation folder. During setup you can
choose to additionally create shortcuts for the starter scripts on your
desktop and in the start menu of your preferred OS.
Depending on the platform, please run one the following starter scripts:
- 3DCityDB-Importer-Exporter.bat (Microsoft Windows family)
- 3DCityDB-Importer-Exporter.sh (UNIX/Linux and derivates, Mac OS X)
Execute the starter script by simply double-clicking on it. This will
work for most platforms.
PLEASE NOTE:
The starter scripts override default settings of the Java Virtual
Machine (JVM). The provided values should be reasonable for most
systems. Please edit the starter scripts in case you need to adapt
these values (e.g., in order to increase Java heap space size).
On some UNIX/Linux derivates you will have to run the starter script
from within a shell environment. Please open your favorite shell and
check whether execution permission is set for the starter script.
Change to the installation folder and enter the following to make the
starter script executable for the owner of the file:
chmod u+x 3DCityDB-Importer-Exporter.sh
Afterwards, simply run the starter script by typing:
./3DCityDB-Importer-Exporter.sh
b) Alternatively, you can directly run the 3dcitydb-impexp.jar
from within a shell environment without using the starter scripts. The
runnable JAR archive can be found in the 'lib' subfolder of the
installation folder.
Open a shell and type the following:
java -jar 3dcitydb-impexp.jar [-options]
Make sure to define the memory limits for the Java heap space.
Otherwise you might quickly run into heap space memory lacks due
to restrictive JVM default values.
This is the recommended way to use the CLI version of the program.
See the provided starter scripts for further examples.
Type 'java -jar 3dcitydb-impexp.jar -help' to get a list of supported
command line parameters.
7. Cooperation partners and supporters
--------------------------------------
The development of the 3D City Database Importer/Exporter has been
supported by the following cooperation partners:
* Business Location Center, Berlin
http://www.businesslocationcenter.de/
* virtualcitySYSTEMS GmbH, Berlin
http://www.virtualcitysystems.de/
* Berlin Senate of Business, Technology and Women
http://www.berlin.de/sen/wtf/
* M.O.S.S. Computer Grafik Systeme GmbH, Taufkirchen
http://www.moss.de/
8. Developers
-------------
Claus Nagel <cnagel@virtualcitysystems.de>
Javier Herreruela <javier.herreruela@tu-berlin.de>
Felix Kunde <fkunde@virtualcitysystems.de>
Alexandra Lorenz <alexandra.lorenz@tu-berlin.de>
Gerhard König <gerhard.koenig@tu-berlin.de>
Thomas H. Kolbe <thomas.kolbe@tum.de>
9. Contact
----------
cnagel@virtualcitysystems.de
javier.herreruela@tu-berlin.de
fkunde@virtualcitysystems.de
10. Websites
------------
Official 3D City Database Importer/Exporter website:
http://www.3dcitydb.net/
Related websites:
http://www.igg.tu-berlin.de/
http://www.opportunity.bv.tu-berlin.de/
http://www.citygml.org/
http://www.citygmlwiki.org/
http://www.opengeospatial.org/standards/citygml
11. Disclaimer
--------------
THIS SOFTWARE IS PROVIDED BY IGG "AS IS" AND "WITH ALL FAULTS."
IGG 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.
IGG 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 IGG.
IN NO EVENT WILL IGG BE LIABLE FOR ANY INDIRECT, PUNITIVE, SPECIAL,
INCIDENTAL OR CONSEQUENTIAL DAMAGES HOWEVER THEY MAY ARISE AND EVEN IF
IGG HAVE BEEN PREVIOUSLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.