Downloads - SUMO Documentation (2024)

Downloads

Downloads

Release date: 07.05.2024

Windows#

Binaries (64 bit), all dlls needed, the examples,tools, and documentation in HTML format. For an explanation of the contents and thelicensing (especially concerning the "extra" build which contains GPL code to support GeoTIFFs, shapefiles and 3D models), see the notes below.

64-bit installer: sumo-win64-1.20.0.msi136.8 MB
64-bit zip: sumo-win64-1.20.0.zip117.1 MB
64-bit installer with all extras (contains GPL code): sumo-win64extra-1.20.0.msi169.9 MB
64-bit zip with all extras (contains GPL code): sumo-win64extra-1.20.0.zip150 MB

SUMO is also available via winget so winget install --name sumo should give you the latest release (but not the extra version).

SUMO-Game#

Windows binaries: sumo-game-1.20.0.zip72.7 MB

Linux#

The community maintains several repositories notably at theopen build service.For a detailed list of repositories see below.

Furthermore there are a debian and an ubuntulaunchpad project as well as an archlinux package:

There is also a flatpak available for SUMO.

To add the most recent sumo to your ubuntu you will need to do:

sudoadd-apt-repositoryppa:sumo/stablesudoapt-getupdatesudoapt-getinstallsumosumo-toolssumo-doc

Repositories#

If the repositories donot contain the libraries (like proj and gdal) they are either part ofthe distribution or you will need them from another repository (you maytry one of the build service repositories here too, e.g.Application:Geo).At the moment there is no documentation included in the packages. Therepositories include a nightly build as well (called sumo-git).

Examples#

Adding the repository and installing (the quick and dirty way without checking GPG keys!) looks like this, for yum on CentOS 7:

yum-config-manager --add-repo=https://download.opensuse.org/repositories/science:/dlr/CentOS_7/yum install -y --nogpgcheck epel-releaseyum install -y --nogpgcheck sumo-1.20.0

and like this, for zypper on openSUSE Leap 15.3:

zypper ar https://download.opensuse.org/repositories/science:/dlr/15.3/ science:dlrzypper in sumo=1.20.0

I you leave out the version number it will install the latest nightly build.

macOS#

You can read the Homebrew-based installation guide here or follow the Build instructions here.

"Bottles" are available for installing withHomebrew. They are built for the three most recentmacOS versions (currently Monterey, Ventura and Sonoma) and are builtfrom source with minimal requirements (fox, proj, xerces-c). If you needoptional libraries, you can specify these on the brew command line andbrew will compile SUMO from source. For details, see the Formula'sREADME.

Application launchers#

In order to have a more native feel on macOS, we provide some application launchers (icons / shortcuts). These launchers work with all versions of SUMO and do not need to be updated.

Download SUMO launchers0.8 MB

These launchers allow you to select sumo-gui as the default application to open .sumocfg files on macOS, and even add sumo-gui, netedit and the OSM Web Wizard to the dock.

Important notice

In order to use the launchers, make sure you have installed SUMO beforehand (any version) and have set the SUMO_HOME environment variable.

Sources#

Download the sources, examples, and CMake-files for creating Visual Studiosolutions or Linux Makefiles. This download does not contain tests. Download as:

sumo-src-1.20.0.tar.gz72.4 MB
sumo-src-1.20.0.zip76.3 MB

Python packages / Virtual environments#

Starting with SUMO 1.8.0 (for macOS since 1.12.0) the installation is also possible from the Python packaging index.

You can install either the applications: pip install eclipse-sumo or only traci (pip install traci), libsumo (pip install libsumo) or sumolib (pip install sumolib).

This should work for Windows, macOS and all Linux versions which are more recent than 2014.The applications are available for Python 2 and Python 3, libsumo only for Python 3.6 and above. This gives an easy way to testa new SUMO version via virtual environments or a nightly build using the following commands (on Linux):

python -m venv sumo_testcd sumo_test. bin/activatepip install eclipse-sumo

macOS dependencies

In order to use the Python wheels on macOS you need to have all the dependencies installed and up to date via brew for instance by following the standard installation once.

To take full advantage of all Python toolsplease install the dependencies via pip install -r $SUMO_HOME/tools/requirements.txt.

SUMO is under active development. You can find a continuously updatedlist of bug-fixes and enhancements at ourChangeLog. To make use of the latest features(and to give us pre-release feedback) we encourageyou to use the latest version from our code repository.

Every push to our main branch also triggers a build for Windows, Linux and macOS. The results can be foundby clicking on the relevant commit here and downloading theappropriate file for your platform (you may need to sign in to GitHub).

Nightly Snapshots#

v1_20_0+1629-53d0e27b5f3

The code within the repository is compiled eachnight. All Windows builds are for the 64bit platform. For an explanation of the contents and thelicensing (especially concerning the "extra" build which contains GPL code to support GeoTIFFs, shapefiles and 3D models),see the notes below. The following packages can be obtained:

Sources: https://sumo.dlr.de/daily/sumo-src-git.tar.gzAugust 19 2024 22:12:09 UTC72 MB
Sources: https://sumo.dlr.de/daily/sumo-src-git.zipAugust 19 2024 22:12:02 UTC75.8 MB
Sources and static HTML documentation: https://sumo.dlr.de/daily/sumo_git.orig.tar.gzAugust 19 2024 22:12:16 UTC75.6 MB
Windows installer: https://sumo.dlr.de/daily/sumo-win64-git.msiAugust 19 2024 23:24:11 UTC138.5 MB
Windows zip: https://sumo.dlr.de/daily/sumo-win64-git.zipAugust 19 2024 23:22:21 UTC118.4 MB
Windows installer with all extras (contains GPL code): https://sumo.dlr.de/daily/sumo-win64extra-git.msiAugust 20 2024 03:35:39 UTC171.3 MB
Windows zip with all extras (contains GPL code): https://sumo.dlr.de/daily/sumo-win64extra-git.zipAugust 20 2024 03:33:29 UTC151.1 MB
Windows 64-bit binaries of the SUMO game: https://sumo.dlr.de/daily/sumo-game-win64-git.zipAugust 19 2024 23:25:00 UTC70.4 MB
Windows 64-bit debug version: https://sumo.dlr.de/daily/sumo-win64Debug-git.zipAugust 19 2024 23:35:12 UTC312.2 MB

The nightly builds are also available as Python wheels.To install the latest nightly version (it is strongly encouraged to do this in a virtual environment) use the instructions above replacing the install line with:

pip install -f https://sumo.dlr.de/daily/wheels/ eclipse-sumo

Although this is a python package, it contains all compiled SUMO binaries and should be fully functional (see the requirements in the section above).The nightly python wheels are also available for libsumo, sumolib and traci.

The Linux repositories at the open build service contain a nightly build as well.This is unfortunately not the case for the Debian, Ubuntu and Arch versions.

The corresponding documentation isalso visible live including Doxygendocs. Additional artifacts such astests results and code coverageanalysis are generated everynight.

Caution

The available Windows binary packages may lag behind the latest Git revision due to being compiled only once per day (around midnight, Berlin time).

If you need even more recent builds, have a look at the artifacts of the GitHub actions. You will need to click on the commit and the platform you are interested in, e.g. windows for Windows binaries.

The release directory contains all release files since 1.2.0.Those and older releases can also be obtained via the sourceforge download portal.If you want to try out an older version you can also use the virtual environment approach(explained above) with a fixed version, e.g.pip install eclipse-sumo==1.9.0 (works only for 1.8.0 and later).

If you need a complete zipped snapshot of the repository (including tests) for an older version have a look at the tags in yourlocal repository or at GitHub tags.

Direct repository access#

You can get the very latest sources directly from our Git repository, seethe FAQ on repository access.Normally, they should compile and complete our test suite successfully.To assess the current state of the build, you may take a look at thenightly test statistics.

Packages#

SUMO is available as different packages. The contents of each package islisted in the table below.

	bin	build	src (source code)	user docs	data	examples	tutorials	tools (except jars)	jars
sumo-src-XXX.tar.gz sumo-src-XXX.zip		✔	✔		✔	✔	✔	✔
sumo-win??-XXX.zip sumo-win??-XXX.msi	✔			✔	✔	✔	✔	✔	✔
rpm	(✔)			✔	✔	✔	✔	✔

Dependencies for developers#

For the Windows platform you can retrieve all dependencies by cloningthis repository: https://github.com/DLR-TS/SUMOLibraries, if you wantto develop with Visual Studio. If you just want to run SUMO, use thebinary downloads above which already contain the runtime dependencies.

Scenarios and other Data#

complete scenarios
networks
traffic data
Test cases

SUMO is licensed under theEPL-2.0 with GPL v2 or later as a secondary license option using only opensource libraries.

The standard Windows build only contains code and Windows binaries with Eclipseapproved licenses (especially no GPL code). If you needfeatures like shapefile import, GeoTIFF processing, the OpenSceneGraph 3D GUI, orvideo generation, download the "extra" build.

The Linux packages do not contain external libraries at all.