What is SUMO

[“Simulation of Urban MObility” (SUMO)](https://sumo.dlr.de/) is an open source, highly portable, microscopic traffic simulation package designed to handle large road networks and different modes of transport.

It is mainly developed by employees of the [Institute of Transportation Systems at the German Aerospace Center](https://www.dlr.de/ts).

Where to get it

You can download SUMO via our [downloads site](https://sumo.dlr.de/docs/Downloads.html).

As the program is still under development and is extended continuously, we advice you to use the latest sources from our GitHub repository. Using a command line client the following command should work:

git clone –recursive https://github.com/eclipse/sumo

Contact

To stay informed, we have a mailing list for SUMO [you can subscribe](https://dev.eclipse.org/mailman/listinfo/sumo-user) to. Messages to the list can be sent to sumo-user@eclipse.org. SUMO announcements will be made through the sumo-announce@eclipse.org list; [you can subscribe](https://dev.eclipse.org/mailman/listinfo/sumo-announce) to as well. For further contact information have a look at the [this page](https://sumo.dlr.de/docs/Contact.html).

Build and Installation

For Windows we provide pre-compiled binaries and CMake files to generate Visual Studio projects. If you want to develop under Windows, please also clone the dependent libraries using

git clone –recursive https://github.com/DLR-TS/SUMOLibraries

Using Linux you should have a look whether your distribution already contains sumo. There is also a [ppa for ubuntu users](https://launchpad.net/~sumo) and an [open build service instance](https://build.opensuse.org/project/show/home:behrisch). If you want to build yourself, the steps for ubuntu are:

sudo apt-get install cmake python g++ libxerces-c-dev libfox-1.6-dev libgdal-dev libproj-dev libgl2ps-dev swig cd <SUMO_DIR> # please insert the correct directory name here export SUMO_HOME=”$PWD” mkdir build/cmake-build && cd build/cmake-build cmake ../.. make -j$(nproc)

For [detailed build instructions have a look at our Documentation](https://sumo.dlr.de/docs/Developer/Main.html#build_instructions).

Getting started

To get started with SUMO, take a look at the docs/tutorial and examples directories, which contain some example networks with routing data and configuration files. There is also user documentation provided in the docs/ directory and on the homepage.

Bugs

Please use for bugs and requests the [GitHub bug tracking tool](https://github.com/eclipse/sumo/issues) or file them to the list sumo-user@eclipse.org. Before filing a bug, please consider to check with a current repository checkout whether the problem has already been fixed.

We welcome patches, pull requests and other contributions! For details see [our contribution guidelines](CONTRIBUTING.md).

License

SUMO is licensed under the [Eclipse Public License Version 2](https://eclipse.org/legal/epl-v20.html). For the licenses of the different libraries and supplementary code information is in the subdirectories and the [Documentation](https://sumo.dlr.de/docs/Libraries_Licenses.html).