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 80:80 -p 443:443 -p 55010:55010 -e WS_PORT=55010 --name OpalScenarioBuilder anrunie/opalscenariobuilder:latest
Where WS_PORT exposes an internal port needed for the service.
Notice that you can decide the external ports mapping.
Once it is running, you can access the scenario builder with your browser at https://localhost.
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.
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
-
I insist. Expect errors: OSM overpass has now very strict limits for downloading, even if the scenario is built, you can find runtime errors in the browser. The solution: just use the map to download the scenario (use the check button
to just download) and then use the downloaded data to build your scenario with the Unity Editor.
- 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