MATSim Documentation

Quick Links

For Users

For Developers

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

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 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.


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:


Sign up to our newsletter to get news about MATSim about every other month.

You can unsubscribe at any time by clicking the link in the footer of our emails.

We use MailChimp as our marketing platform. By clicking below to subscribe, you acknowledge that your information will be transferred to MailChimp for processing. Learn more about MailChimp's privacy practices here.

View previous newsletters.

MATSim Association

The MATSim Association was founded in fall 2022. Learn more about the MATSim Association.