Chapter 1. Introduction

1.1. What is SUMO?

SUMO is a microscopic road traffic simulation package. In the near future it will be extended to model other transit modes simultaneously with ordinary car traffic.

1.2. Why open source?

Two thoughts stood behind the release of the package as open source. At first the fact that every traffic research organisation is forced to implement an own simulation package; some people are interested in traffic light optimisation, other try to find mistakes made during the design of a road network. Both need some kind of a simulation package and have to implement a framework containing input and output functions and other things from scratch. So the first idea was to give them a basic framework - containing all needed methods for a simulation - they can put own ideas into. The second idea is to supply a common test bed for models, especially car models, to the community to make them comparable. Due to different architectures of traffic simulations such comparisons on a wide scale are not possible by now.

1.3. Features

  • High portability (using standard - c++ and portable libraries only)
  • Collision free vehicle movement
  • Different vehicle types
  • Single-vehicle routing
  • Multi-lane streets with lane changing
  • Junction-based right-of-way rules
  • Hierarchy of junction types
  • A fast openGL graphical user interface
  • Dynamic routing
  • Manages networks with several 10.000 edges (streets)
  • Fast execution speed (up to 100.000 vehicle updates/s on a 1GHz machine)
  • Supports import of many network formats (Visum, Vissim, ArcView, XML-Descriptions)

1.4. About this Document

This document describes how to use each of the applications that come with the SUMO-package. We should remark, that this document only covers the usage of the software and some descriptions of the used models.

1.4.1. Described Applications

Table 1.1. Applications described within this document

ApplicationApplication Name (Windows)Application Name (Linux/UNIX)DescriptionDescribed in Chapter
NETCONVERTnetconvert.exesumo-netconvertA network converter/importerChapter 4
NETGENnetgen.exesumo-netgenA generator of abstract networksChapter 4
DFROUTERdfrouter.exesumo-dfrouterA router using detector flowsChapter 5
DUAROUTERduarouter.exesumo-durarouterA router for dynamic user assignmentChapter 5
JTRROUTERjtrrouter.exesumo-jtrrouterA router using junction turning ratiosChapter 5
SUMOsumo.exesumoThe microscopic simulationChapter 6
GUISIMguisim.exesumo-guisimThe gui-version of the microscopic simulationChapter 7
POLYCONVERTpolyconvert.exesumo-polyconvertA tool for importing polygons from other formatsChapter 8.3.1
other---------Chapter 8

Please remark that you may also find the applications "NETEDIT" and "GIANT" within the source distribution. Both are not supported, not working properly and will be not discussed, herein.

1.4.2. Notation

This document uses coloring to differ between different type of information. If you encounter something like this:

netconvert --visum=MyVisumNet.inp --output-file=MySUMONet.net.xml

you should know that this is a call on the command line. There may be also a '\' at the end of a line. This indicates that you have to continue typing without pressing return (ignoring both the '\' and the following newline). The following example means exactly the same as the one above:

netconvert --visum=MyVisumNet.inp \
   --output-file=MySUMONet.net.xml

Command line option names are normally coloured this way. Their values if optional <LIKE THIS>. XML-elements and attributes are shown are coloured like this. Their values if optional <LIKE THIS>. Complete examples of XML-Files are shown like the following:

<MyType>

   <MyElem myAttr1="0" myAttr2="0.0"/>
   <MyElem myAttr1="1" myAttr2="-500.0"/>

</MyType>

You may also find some notations from the EBNF; brackets '[' and ']' indicate that the enclosed information is optional. Brackets '<' and '>' indicate a type - insert your own value in here... All applications are shown like THIS. <SUMO_DIST> is the path you have saved your SUMO-package into.

1.4.3. Status

This document is still under development and grows with the software. Due to this, you may find it together with the sources within the SUMO repository at sourceforge (http://sumo.sourceforge.net/). It should always describe the current version.

1.5. Call for Help

Please let us know when either the document remains at any point unclear or any of the applications does not behave as expected. We would be very happy if you report broken links or misspelled words. We also seek for some participants and further users, not only to share the development tasks, but also to gain some feedback and critics or some usage examples.

To summarize: every help is appreciated. Thank you.


last change: Wednesday, 30-May-2007 02:13:48 PDT