MATSim Documentation

Quick Links

For Users

For Developers

Information for users

The “MATSim Book” is now the authoritative reference.

There is an extract of the first couple of chapters, which contains the most relevant topics for new users. This is sometimes also referred to as the ``MATSim user guide’’.

Some Terminology (i.e. correspondences between MATSim terminology and more standard transport modelling terminology, and reasons why ours is different) can be found here.

Information for developers

These documents …

  • … provide specification of key-aspects of MATSim (e.g. file formats, simulation events, …)
  • … list some guidelines for developers (e.g. coding conventions) to keep MATSim maintainable.
  • … give information about certain packages, how to (programmatically) use them and what features they offer. offers additional pieces of information that may/should be of interest to developers (e.g. how to use Eclipse for development, or some Java-tips)

Developer Resources

Getting and Building the Code

Contributing / Writing Code

MATSim Benchmark


We have prepared some tutorials which should help you getting started with MATSim. The “General Tutorials” section provides the most in-depth tutorials.


Being an open-source project heavily driven by research organizations world-wide, a lot of publications were written about MATSim. If you are interested in scientific publications about MATSim, the publication lists of the following institutions serve as a good entry point:

Old Website

Some links on third-party sites may refer to content that no longer exists on this website. You might have a look at the archived, old website and see if the content is still available there.