Skip to content

Builder

Use the Builder application to generate new simulation scenarios. A scenario is composed of a road network and traffic demand.

Builder

Map

The builder has a map covering the entire screen. Navigate to the desired area either by dragging the map, searching for a location, entering a coordinate or using your current location. Coordinates of the cursor position are shown above the map scale, at the bottom left corner.

Searching

Enter a location name into the search field in the top left corner. A menu will show up, displaying the most relevant matches. You can also enter coordinates (e.g. 52.517, 13.38) into the search field.

Using your current location

If location services are enabled for the browser, clicking on the Use current location button will move the map, and display a blue dot on your approximate location.

Options

Area selection

An area selection is required to build a scenario. After selecting an area (and having a scenario name), the Build button will be enabled. To start the selection click on Start rectangle selection and click and drag anywhere on the map to draw a rectangle. A selection can be cleared by clicking on Remove selection or hitting Esc.

The selection can be resized (by dragging any corner) or moved (by clicking and dragging inside the selection). The size and boundary coordinates of the selection can be found inside the Area selection panel.

Scenario name

Replace the default provided name with your desired one. You could also get a name suggestion based on the road in the center of the area selection by clicking on the magic wand right next to the scenario name.

Magic Wand

Random traffic

Select the desired amount of random background traffic by vehicle category in order to populate the simulation. Use our suggested trough traffic factors1 and counts2 for low, normal or high demand, or choose your own custom values.

Background traffic

Traffic flows

Define specific traffic flows (repeated vehicles) by clicking on the + button inside the Traffic flows section. Select the desired vehicle type and amount. A flow name and vehicle color can also be selected.

Traffic flows section

Flows have a begin and end position, that are represented by markers with a green (begin) and red (end) dot. You can freely move the markers inside the selected area.

The flow will begin at the edge closest to the green marker's position. Similarly, the arrival edge will be chosen based on its proximity to the red marker.

Warning

Flows defined outside of the selected area will be cropped (if possible) or discarded.

Traffic flow

Please note that the line between the begin and end markers is only for visualization purposes (and to select and drag the flow). The actual route followed by the vehicles will be calculated as part of the scenario building process.

Other settings

Additional settings such as handedness of the road traffic, and a comment/description input field can be found in the Other settings section. Here you may also save the scenario in a project within your workspace.

Other settings

Starting the build

The Build button on the top will be enabled:

It is possible to create scenarios with no background traffic and no traffic flows.

Once the scenario build process is completed, the new scenario will be available in the Workspace.


  1. The Through Traffic Factor (TTF) defines how many times it is more likely for an edge at the boundary of the scenario being chosen as a depart or arrival edge for a random trip compared to an edge entirely located inside the simulation area. 

  2. The Vehicle Count parameter defines how many vehicles are generated per hour and lane-kilometer.