Download/Install

Some options to get hold of MATSim are described in the following.
 

(1) MATSim example project on github

You can fork or clone a so-called example project on github, see example project on GitHub.  

This version is targeted to programmers who are fluent with an IDE (e.g. eclipse, IntelliJ) and Java, and who want program against MATSim.  The approach will automatically download MATSim, allow you to browse the source code, and keep you up-to-date with releases or snapshots.  It will not allow you to modify the existing MATSim code -- which, in most cases, also should not be necessary: it is preferred that you contact the developers in such situations and we will try to help or implement missing extension points.

 

(2) Standalone

The "Standalone" version is targeted to users who are not fluent with an IDE (e.g. eclipse) and Java, and want to use MATSim by editing the input files, including config.xml .  A basic GUI is provided.

  Latest Release

Version 0.9.0 "Spring 2017", released August 2017

Download ZIP  ca. 20 MB

  Extensions / Contribs

Older versions

Even older versions (on sourceforge)

  Development Version

These versions are typically less stable and don't come with up-to-date documenation, but may contain new features.

  Download a Nightly Build.

  How to use Nightly Builds

 

 

(3) Maven

The "Maven" version is targeted to programmers who know about Maven, and want to include MATSim into an already existing Maven project.  Similar to the "MATSim example project" above, the Maven approach will maven-download MATSim, allow you to browse the source code, and keep you up-to-date with releases or snapshots (depending on your pom.xml).  It will not allow you to modify the existing MATSim code -- which, in most cases, also should not be necessary: it is preferred that you contact the developers in such situations and we will try to help or implement missing extension points.

  Latest Release

Version 0.9.0

<repositories>
	<repository>
		<id>matsim</id>
		<name>MATSim release repository</name>
		<url>http://dl.bintray.com/matsim/matsim</url>
	</repository>
</repositories>
<dependencies>
	<dependency>
		<groupId>org.matsim</groupId>
		<artifactId>matsim</artifactId>
		<version>0.9.0</version>
	</dependency>
</dependencies>

You can also clone the example project on GitHub which includes a correct pom.xml.

Extensions can be added in the same way; see the example project pom.xml for a commented-out example.

  Development Version

These versions are typically less stable and don't come with up-to-date documenation, but may contain new features.

<repositories>
	<repository>
		<id>ojo-snapshots</id>
		<name>MATSim snapshot repository</name>
		<url>http://oss.jfrog.org/libs-snapshot</url>
		<snapshots>
			<enabled>true</enabled>
		</snapshots>
	</repository>
</repositories>
<dependencies>
	<dependency>
		<groupId>org.matsim</groupId>
		<artifactId>matsim</artifactId>
		<version>0.10.0-SNAPSHOT</version>
	</dependency>
</dependencies>

You can also clone the example project on GitHub and edit its pom.xml to use the SNAPSHOT version.

Extensions can be added in the same way; see the example project pom.xml for a commented-out example.

 

  Benchmark

Download Benchmark  ZIP, ca. 35MB

More information about the MATSim Benchmark.

  Source Code

The source code to MATSim is available on  GitHub.

This is targeted to developers who change the MATSim core (a relatively small circle of persons), or persons who maintain one or more contribs.  For a variety of reasons, we also have "playgrounds" in a second GitHub Repository, although they should be less necessary in the future than they were in the past.

 

  Example Code Project

To get you started writing your own code with MATSim, we provide an example project on GitHub you can fork, which includes a complete pom.xml to use MATSim as a Maven dependency for your own code.