Tools

GeoScenario Editor (customized JOSM)

Since our format was developed on top of OSM primitives, we adapted its standard map editing tool: JOSM. By adding a set of custom presets and style sheets, we can now easily design and understand a Geoscenario on top of the Road Network (Lanelet layer) or other map layers (e.g., Bing Maps, ESRI maps) before its execution.

All presets are availabe in our repo https://github.com/rodrigoqueiroz/geoscenarioserver.

How to install:

  • Download JOSM at https://josm.openstreetmap.de/
  • Open the configuration dialog (press F12), then Settings for the map projection:
  • In "Tagging Presets" tab, add Geoscenario file "josm/geoscenario_presets_version.xml" to the list of Active Presets.
  • In "Map Paint Styles" tab, add Geoscenario file "josm/geoscenario_mapstyle_version" to the list of Active Styles.
  • In both tabs, go to "Icon paths" and add the Geoscenario icons directory "josm/icons"
  • To easily acess Goescenario presets, go to "Customize the elements in the tool bar" and add Presets>GeoScenario Tools to the list. JOSM must be restarted in order to apply the changes.

custom josm

Warning: GeoScenario files are not part of the OSM. Never upload GeoScenario files as maps to the official OSM data base. If you want to have an OSM server to host your maps, , you can set up your own server.

GeoScenario Parser

GeoScenario parser is part of GeoScenario Server geoscenarioserver/gsc/GSParser.py.

External Tools

Lanelet2

Is a C++ open source library to parse Lanelet2 OSM XML files, providing access to its structure and routing. fzi-forschungszentrum-informatik/Lanelet2/

GeographicLib

Open C++ library for performing conversions between geographic, UTM, UPS, MGRS, geocentric, and local cartesian coordinates. We recommend geographiclib to convert coordinates between GeoScenario and Lanelet maps to your simulation environment coordinate system. https://geographiclib.sourceforge.io/