:cityscape: CityGML2OBJ 2.0 :cityscape:
Command line converter of CityGML (.gml) to OBJ (.obj) files, while maintaining the semantics
:arrow_forward: How to run?
The CityGML2OBJs.py represents the starting point of the code, choose this file when configuring the runtime and pass the following parameters:
-i your-input-citygml-path-here
-o your-output-obj-path-here
Please make sure to use the absolute paths to the respective directories.
and Bob's your uncle! :construction_worker:
:wrench: Optional features
| Optional feature | specification |
|---|---|
| Semanitcs Option | -s 1 |
| Geometry Validation | -v 1 |
| Object Preservation | -g 1 |
| Skip the triangulation | -p 1 |
| Conversion of the resulting dataset into a local coordinate system | -t 1 |
| Translation of the CityGML dataset into a local coordinate system before further processing, without saving the translation parameters | -tC 1 |
| Translation of the CityGML dataset into a local coordinate system before further processing, with saving the translation parameters to a designated .txt file | -tCw 1 |
| Separation of every building component into an individual file. Works only for uilding-wise processing. The building's axis aligned bounding box (bufferd by 2m) is marked by 8 small triangles in all resulting files. | -sepC 1 |
| Addition of 8 small triangles that delimit the the buffered (8) bounding box of an entire building to every component file. This option only works along with the component separation functionality. | -adBB 1 |
| Approximation of intricate window geometriesby their convex hull. This option only works along with the component separation functionality. | -appW 1 |
:page_with_curl: Requirements
Python packages:
Optional:
Tested:
- Using Python 3.10 and Windows 10 OS
- Using Python 3.10 and Ubuntu 22.04.4 LTS (Jammy Jellyfish)
CityGML Requirements:
Mandatory:
- CityGML 1.0 or 2.0
- CityGML 3.0 shound in principal work,it is however not thoroughly tested.
- Files must end with
.gml,.GML,.xml, or.XML - Vertices in either
<gml:posList>or<gml:pos> - Your files must be valid (e.g., free check with CityDoctor
Optional, but recommended:
<gml:id>for each<bldg:Building>and other types of city objects<gml:id>for each<gml:Polygon>
Limitations
Information on the limitations can be found in this Wiki Page
:handshake: Credits
We are indebted to Filip Biljecki, Hugo Ledoux and Ravi Peters from TU Delft for their initial version of the CityGML2OBJs converter. The archived version of the repo can still be found here: https://github.com/tudelft3d/CityGML2OBJs; the paper:
Biljecki, F., & Arroyo Ohori, K. (2015). Automatic semantic-preserving conversion between OBJ and CityGML. Eurographics Workshop on Urban Data Modelling and Visualisation 2015, pp. 25-30.
:mailbox: Contact & Feedback
Feel free to open a discussion under Issues or write us an email