Osm2city.py: Difference between revisions

225 bytes removed ,  31 March 2020
Copy editing; Updating links to repository; -cat: Scenery software. Making the osm2city category a subcategory to it instead.
No edit summary
(Copy editing; Updating links to repository; -cat: Scenery software. Making the osm2city category a subcategory to it instead.)
Line 1: Line 1:
{{note|To use osm2city, you need to download both the {{gitlab source|user=osm2city|repo=osm2city|text=development repository}} and the {{gitlab source|user=osm2city|repo=osm2city-data|text=texture data}} from GitLab.}}
{{note|Please use the {{forum link|t=22809|title=osm2city.py development}} for discussion and support.}}
{{OSM Navigation}}
{{OSM Navigation}}


'''osm2city''' is a set of procedural programs, which create plausible FlightGear scenery objects (buildings, roads, power lines, piers, platforms etc.) based on {{wikipedia|OpenStreetMap}} (OSM) data.


== Overview ==
''osm2city'' is a set of procedural programs, which create plausible FlightGear scenery objects (buildings, roads, power lines, piers, platforms etc.) based on OpenStreetMap (OSM) data.
* The development [https://gitlab.com/osm2city/osm2city repository] is hosted on Gitlab. The same applies for related [https://gitlab.com/fg-radi/osm2city-data texture data]. '''You have to download both!'''
* Please use the forum thread [http://forum.flightgear.org/viewtopic.php?f=5&t=22809 osm2city.py development] for discussion and support.
* Documentation regarding installation and usage can be found on [http://osm2city.readthedocs.io/en/latest/index.html osm2citiy's Read The Docs site].
* Documentation regarding installation and usage can be found on [http://osm2city.readthedocs.io/en/latest/index.html osm2citiy's Read The Docs site].
* Written in Python 3.5, developed on Linux. It should also run on Windows and Mac OSX, however most testing is done on Linux.
* Written in Python 3.5, developed on Linux. It should also run on Windows and Mac OSX, however most testing is done on Linux.


== Programs and Feature Areas ==
== Programs and feature areas ==
''osm2city'' contains the following programs to generate scenery objects based on OSM data:
''osm2city'' contains the following programs to generate scenery objects based on OSM data:


* '''buildings.py''': generates buildings honoring OSM height and level tags as well as reads relations ('buildings with holes'). Includes lightmaps, complex sloped roofs (using Olivier Teboul's implementation of the straight skeleton algorithm), obstruction lights on tall buildings. Texturing of roofs and facades based on a texture manager, which find matching texture for given building (number of levels, modern/old building, etc).
; buildings.py
* '''roads.py''': generates different types of roads and railways incl. texturing and automatically calculated bridges.
: Generates buildings honoring OSM height and level tags as well as reads relations ('buildings with holes'). Includes lightmaps, complex sloped roofs (using Olivier Teboul's implementation of the straight skeleton algorithm), obstruction lights on tall buildings. Texturing of roofs and facades based on a texture manager, which find matching texture for given building (number of levels, modern/old building, etc).
* '''pylons.py''': generates pylons and cables between them for power lines, aerial ways, railway overhead lines as well as street-lamps, wind turbines and storage tanks.
 
* '''piers.py''': generates piers and boats.
; roads.py
* '''platforms.py''': generates railway platforms.
: Generates different types of roads and railways incl. texturing and automatically calculated bridges.
 
; pylons.py
: Generates pylons and cables between them for power lines, aerial ways, railway overhead lines as well as street-lamps, wind turbines and storage tanks.
 
; piers.py
: Generates piers and boats.
 
; platforms.py
: Generates railway platforms.


All generated objects are added as static or shared objects to FlightGear scenery with correct elevation read on the fly from existing FlightGear scenery. Tagging and topology in OSM are respected as far as possible and complemented with some heuristics (given the developer team's origin mostly inspired by how stuff looks in Europe).
All generated objects are added as static or shared objects to FlightGear scenery with correct elevation read on the fly from existing FlightGear scenery. Tagging and topology in OSM are respected as far as possible and complemented with some heuristics (given the developer team's origin mostly inspired by how stuff looks in Europe).


== Issues and Feature Requests ==
== Issues and feature requests ==
Please register issues and feature requests in the [https://gitlab.com/fg-radi/osm2city repository] as issues and label them accordingly.
Please register issues and feature requests in the {{gitlab source|user=osm2city|repo=osm2city|text=repository}} as issues and label them accordingly.
 
== Screenshots ==
[[File:LOWI with OSM buildings.jpg|thumb|800px|left|LOWI with OSM buildings]]
 
[[File:Wick_harbour_created_using_osm2city_and_osm2piers.png|thumb|800px|left|Example of piers.py output]]
 
[[File:Roed sand2.png|thumb|800px|left|osm2city placed wind turbines at Rød Sand 2 in Denmark.]]
 
[[File:Bridge and cables.png|thumb|800px|left|osm2city generated pylons with cables, street with bridge over railway with overhead cables.]]
 
[[File:Buildings and roads at night.png|thumb|800px|left|osm2city generated buildings and roads with light effects at night]]{{-}}


== Related content ==
== Related content ==
=== Documentation ===
=== Documentation ===
* http://osm2city.readthedocs.io/en/latest/index.html
* http://osm2city.readthedocs.io/en/latest/index.html
Line 31: Line 48:
=== Wiki articles ===
=== Wiki articles ===
* [[Areas populated with osm2city scenery]]
* [[Areas populated with osm2city scenery]]
* [[Project3000]] can be used together with osm2city
* [[Project3000]] - Can be used together with osm2city
* [[Using OSM2CITY on Windows]]
* [[Howto:Using osm2city.py on Windows]]


=== Forum topics ===
=== Forum topics ===
* [http://forum.flightgear.org/viewtopic.php?f=5&t=22809 Development and user discussions regarding osm2city]
* {{forum link|t=22809|title=osm2city.py development }} - Development and user discussions regarding osm2city
* [https://forum.flightgear.org/viewtopic.php?f=5&t=32254 Announcements of new available osm2city scenery]
* {{forum link|t=32254|title=osm2city available scenery}} - Announcements of new available osm2city scenery
* [https://forum.flightgear.org/viewtopic.php?f=5&t=35581 World build of osm2city scenery]
* {{forum link|t=35581|title=osm2city worldbuild}} - World build of osm2city scenery
* [http://forum.flightgear.org/viewtopic.php?f=5&t=19625 LOWI city buildings - where it all started]
* {{forum link|t=19625|title=LOWI city buildings}} - Where it all started
 
== Screenshots ==
=== LOWI with OSM buildings ===
[[File:LOWI with OSM buildings.jpg|LOWI with OSM buildings]]
=== Example of piers.py output ===
[[File:Wick_harbour_created_using_osm2city_and_osm2piers.png|Example of piers.py output]]
[[Category:Scenery software]]
=== osm2city placed wind turbines at Rød Sand 2 in Denmark ===
[[File:Roed sand2.png|osm2city placed wind turbines at Rød Sand 2 in Denmark.]]


=== osm2city generated pylons with cables, street with bridge over railway with overhead cables ===
=== Source code ===
[[File:Bridge and cables.png|osm2city generated pylons with cables, street with bridge over railway with overhead cables.]]
* {{gitlab source|user=osm2city|repo=osm2city}}
=== osm2city generated buildings and roads with light effects at night ===
[[File:Buildings and roads at night.png|osm2city generated buildings and roads with light effects at night]]