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 interpret the output of the simulations

   

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

This  version of the tutorial matches the code in the Matsim Spring 2010 release 0.1.0. You can download the release following the instructions in the download section of matsim.org. After the download is completed follow the instructions that you can find in the README.txt within the .zip file.

If you instead plan to use the latest code from the subversion repository, you will need to keep the following path-change 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 the jar-files in the directory libs and libs/geotools . This results in a huge number of jars to be added to the classpath and may not work as expected (jar hell problem). We strongly recommend to go this way only as expert and to build the project with maven.

• In most cases, however, you will not need to check out the repository but can just stick to either the current release or the nightly build. See the last part of this tutorial for more information about including either of them into Eclipse