This tutorial will make you familiar with MATSim. You will learn

• how to run and simulate a simple scenario,
• to understand the configuration settings so you can change them correspondingly for your own scenarios,
• how to integrate an external, custom mobility simulation,
• how to integrate a custom, external re-planning module.

Finally, the tutorial will give an introduction at the code so you will be able to extend the previously mentioned examples to create further sophisticated simulations.

This tutorial is also included in the MATSim download.

This  version of the tutorial (supposedly) matches the code in the latest release.

If you plan to use later versions, you will need to keep the following Path-changes in mind:

•     The classpath (-cp in commands) is not MATSim.jar, but consists of the directory that contains the compiled classes (usually classes or bin) as well as of all depending jar-files 

Also see here for more modern ways to obtain and install MATSim.  The tutorials have not yet been adapted.