Scenario builder for Veneris

You can now download the scenario builder as a Docker container and run it on your own PC. To do this download here the container. You can install it with the following command: docker run -d -p 27025:80 -p PORT:PORT -e WS_PORT=PORT --name OpalScenarioBuilder anrunie/opalscenariobuilder:latest
Where PORT exposes the port for the service, and WS_PORT exposes an internal port needed for the service. You have to select those ports. Once it is running, you can access the scenario builder with your browser at http://localhost:PORT. Please, do this to decrease the load on our server and to have the scenario builder always available

You can select an area from OpenStreetMap which will be used to build a Veneris scenario with road network, traffic demand and environment.
In the map below, select an area and press "Generate scenario".
When created, the scenario will be run on the browser below with the Veneris WebGL builder.

You can just generate the scenario files for downloading by checking here, without running the scenario on the browser, which may be problematic depending on the memory and browser you are using (see tips below).

The scenario builder uses a modified version of the SUMO osmWebWizard tool to generate the XML SUMO files (net, rou and polys) which are then converted to JSON and read by the Veneris builders.
You can also download and inspect the JSON files generated.

We are using SUMO 0.32.0 for generating the files. Be aware that using other versions of SUMO may not work because of changes in the XML elements used, that may not be understood by Veneris.

The builder now does not build non-vehicle class edges. Since we only simulate motor vehicles they usually only cause trouble for the builder. So we have used the netconvert option --remove-edges.by-vclass delivery,transport,lightrail,cityrail,rail_slow,rail_fast,motorcycle,bicycle,pedestrian for generating the files. If you want to use (or see them), you have to generate the files yourself with the SUMO web wizard.

Do not uncheck the Cars or the Add Polygons in the option tabs of the map below. Otherwise the scenario builder will not work. If you do not really need cars and polygons, just ignore the osm.poly and osm.rou files generated when you download the scenario.

Tips

Please, take into account the following, when you run a scenario with Veneris WebGL builder:

  • The quality of the scenario depends on the quality of the map. If the OSM map area is poorly developed, such as with inconsistent roads, dead ends, wrong shapes, etc. Veneris will not likely be able to build it. Even if it can be built, you can find unexpected behaviors later. So, if you are interested in an area, download the scenario with osmWebWizard , build it in the Unity editor and edit it to correct issues
  • Be patient. Veneris builder starts once the Unity loadbar has finished. Then, it needs to load the scenario and then fetch some more data from OSM. If, at the end, you do not see roads, and buildings, or a "Quit" button and some info on the player, there may have been some problem with the scenario. Reload the page and try another area.
  • Try to use a small area. The larger the area, the longer to build. In addition, you may run out of memory, depending on your browser. Start with an area with a size similar to what you see in the map below. If you try Veneris in the Unity editor you can use much larger areas.
  • Try to use a moderate demand. The default demand will result in only a few vehicles, depending on the size of the area, which is usually OK for testing purposes. See the documentation on osmWebWizard to set the Count variable. In addition, try to set a high Through Traffic Factor to generate the vehicle insertions in the edge of the network. If you generate a large demand, such as more than a few dozens of active vehicles, you may probably also run out of memory. To use a large demand, again download the scenario with osmWebWizard and run it on the Unity editor or build an executable.
  • The area you see in the map below, Berlin, has roads with unrealistically low speeds and vehicles are going to comply with the maximum speed of the road, so expect to see vehicles moving very slowly. In addition, with the default demand settings and a small area you should see very few vehicles and very sparsely inserted. Try changing the settings.
  • If it does not seems to work, open the web console on your browser and look for messages
  • It has been tested on Firefox 64.0 (64-bit). Should also work in other modern browsers

Controls

  • Toggle UI: I
  • Orbit: Alt+Left-Mouse
  • Pan: Right-Mouse
  • Zoom: Wheel-Mouse
  • Follow vehicle with camera: F (Press again to follow another vehicle)
  • Set orbit camera: Ctrl+ F
  • Quit: Q
  • Display route on selected vehicle: P (after clicking on vehicle)
  • Pause/Unpase: Space/G

Copyright Esteban Egea-Lopez - 2019-2021. Last modified: 05-2021