Getting Started with MATSim

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.

 

The attached version of the tutorial matches the code in the latest release. If you plan to use the latest code from the subversion repository, use the (regularly updated) tutorial included in the checkout in the directory examples/tutorial/.

Using DEQSim with MATSim

The Deterministic Event-driven Queue-based Traffic Flow Micro-Simulation (DEQSim) is a fast traffic
simulation written in C++. It can read the usual MATSim XML files for input, which allows it to be
integrated in MATSim.
This tutorial will show you how you can use DEQSim together with MATSim.

The tutorial is also included in the download of the MATSim Extension "DEQSim".

Using Nightly Builds of MATSim

We provide nightly builds of MATSim for download. These builds are are not official releases of MATSim, but are automatically created each night after the code has passed some tests to ensure a certain minimal quality standard. The nightly builds of MATSim require additional libraries to run, which are also provided for download in a separate package, as they do not change that often.

Initial setup to use a MATSim nightly build

Using a nightly build of MATSim is as simple as following these 3 steps:

1. Download the current MATSim jar-file (MATSim_r####.jar).
2. Download the current collection of required 3rd-party libraries into the same directory as the MATSim jar-file (MATSim_libs_r####.zip).
3. Unzip the collection of 3rd-party libraries, you should then get a directory libs with several jar-files inside.

Now you can run MATSim by specifying the jar-file as classpath, e.g.:

java -cp MATSim_r####.jar org.matsim.run.Controler

If the directory libs is in the same directory as the MATSim jar-file, the libraries are found automatically and must not be added to the classpath manually.

Updating to a newer MATSim nightly build

If you are already using a nightly build of MATSim, it is in most cases sufficient to just replace the nightly MATSim jar-file with a newer version, as the libraries do no change that often.

Evacuation Tutorial

This tutorial describes the EvacuationQueueSimulation. Because the evacuation package is not part of the current release you  have to checkout MATSim from SVN.