Simulation/Basic Definition

generated on 2018-10-19 00:15:55.512597 from the wiki page for Simulation/Basic_Definition for SUMO git

In the following, the inputs needed by the simulation modules SUMO and SUMO-GUI are described.

Input Files

Road Network

For a simulation, a SUMO Road Network must be given using the option --net-file <NETWORK_FILE> (or -n <NETWORK_FILE>). The network is normally built using NETCONVERT or NETGENERATE.

Traffic Demand (Routes)

The vehicles to simulate must be given. Their description normally includes vehicle types, vehicles, and vehicle routes. Routes are normally given to the simulation modules using the option --route-files <ROUTES_FILE>[,<ROUTES_FILE>]* (or -r <ROUTES_FILE>[,<ROUTES_FILE>]*). As you can see, you can use more than one route file within a single simulation run.

The routes MUST be sorted. The reason is that we want to simulate large road networks with up to millions of routes. Using a plain PC this is only possible if you do not keep all routes in memory. All files given as parameter to --route-files <ROUTES_FILE>[,<ROUTES_FILE>]* are read step-wise. Starting at the begin time step, new routes are loaded every n time steps for the next n time steps. n may be controlled using the --route-steps <INT> where <=0 forces SUMO/SUMO-GUI to load the file completely. Fetching routes for the next steps only implies that the vehicle types - or maybe "global" routes - must be given in prior to the routes that use them.

You may also give routes including vehicle definitions as additional-file to SUMO/SUMO-GUI.

Additional Files

One ore more additional-file(s) are used to load additional entities:

All these additional structures / definitions are given to the simulation using the --additional-files <FILE>[,<FILE>]*. The list of given files is processed incrementally, this means each file is read completely from top to bottom and the list is processed starting with the first file of the list.

Parsing Order

To ensure the correct resolution of references, it is important to know what is loaded when. The order is as follows:

  1. the network is read
  2. the additional files are read (completely from top to bottom) in the order in which they are given in the option
  3. the route files are opened and the first n steps are read
  4. each n time steps, the routes for the next n time steps are read

Defining the Time Period to Simulate

Each simulation requires the definition about the time period to be simulated. This is given to SUMO or SUMO-GUI using the options --begin <TIME> (or -b <TIME> for short) and --end <TIME> (-e <TIME>). Please note that whether the option --end was given influences the simulation's behavior. The details are described below.

The simulation starts at the time given in --begin, which defaults to 0. All vehicles with a departure time (depart) lower than the begin time are discarded.

The simulation performs each time step one-by-one.

The simulation ends in the following cases:

  • The final time step was given using --end and this time step was reached (time after a step is >= end).
  • No value for --end has been given and all vehicles have been simulated. The state of the simulation is the one in which the last vehicle has left the simulated area. If a TraCI connection is active, the simulation will continue even after the last vehicle (potentially "forever").
  • A close command has been received via TraCI

Defining the Time Step Length

SUMO/SUMO-GUI use a time step of one second per default. You may override this using the --step-length <TIME> option. <TIME> is here given in seconds, but you may enter a real number. In conclusion giving --step-length 0.01 will run the simulation using time steps of 10ms.

Specifying the option --default.action-step-length <TIME> implies that vehicles perform calculations for the adaption of accelerations or lane-change maneuvers only at intervals of the given length and not within every simulations step (which is the default). Using an action-step-length different from the simulation step length automatically switches the integration method to 'ballistic'.

Choosing the action step length larger than the simulation step length may speed up the simulation, but note that a value larger than the assumed reaction time tau may induce collisions. See the description of vehicle type and car-following parameters for details.

Please note that some of the available car-following models were developed for simulation step lengths of exactly one second. The modeled dynamics may not work properly if a different time step length is used.

Defining the Integration Method

There are two numerical integration methods available, which control the dynamical update of the simulation. Currently, the default is an Euler update, which considers the vehicle's speed constant during one time step. As an alternative, SUMO offers the ballistic update, which considers the acceleration constant during one time step. It can be activated by giving the option --step-method.ballistic or including the following into the configuration file:

     <step-method.ballistic value="true"/>

Especially for larger time-steps (e.g. 1sec.) ballistic update yields more realistic dynamics for car-following models based on continuous dynamics. See also Martin Treiber, Venkatesan Kanagaraj, Comparing Numerical Integration Schemes for Time-Continuous Car-Following Models.

Ballistic update causes positions to be updated with the average speed between time steps instead of the speed of the current time step. Consider this example with step-length 1s:

Vehicle at position x drives with speed 4.5m/s in step t and brakes to speed 0 in step t+1.

  • Euler-update: Vehicle is stopped at position x in step t+1 (instant deceleration)
  • Ballistic-update: Vehicle is stopped at position x + 2.25 in step t+1 (continuous deceleration)
The ballistic update is currently not working well in combination with the sublane-model. See Issue #2581.

This page was last modified on 15 December 2017, at 12:28.