Install MATSim

Some options to get hold of MATSim are described here. These are in the recommended order for most users.

(1) MATSim example project on GitHub

The recommended approach to getting started with MATSim is to clone the example project on GitHub. This approach targets programmers who are comfortable with Java and an IDE (e.g. Eclipse or IntelliJ). This will automatically download MATSim, allow you to browse the source code, and keep you up-to-date with releases or snapshots.

You will not be able to modify the existing MATSim source code – which, in most cases, 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) MATSim code examples on GitHub

There is also a MATSim code examples project, which contains code examples of how to work with MATSim. You can clone this project to have it locally on your computer, or browse the code in github directly. This project is meant to be used in parallel with (1).

(3) Standalone

The “Standalone” version is targeted to users who want to use MATSim by editing the input files, including config.xml directly. A basic GUI is provided.

Latest Release

Version 0.9.0 “Spring 2017”, released August 2017

Development Version

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

(4) 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 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.

  Benchmark

Download Benchmark ZIP, ca. 35MB</p>

More information about the MATSim Benchmark.