Tutorial: Learning MATSim in 8 Lessons

 

OVERVIEW OF THE TUTORIAL

In this tutorial, we will develop step-by-step a MATSim small-scale real-world scenario for the region of Zurich. While doing this, you will learn much about the basic functionality of MATSim. After having finished this tutorial you will be able to perform a simple policy study using the developed scenario. And you will be eager to apply MATSim to your own studies.

 

1. Introduction

[30 minutes]

Lecturers: ...

During this lesson, you will be given a general overview of MATSim. The basic principles of MATSim will be highlighted and you will for example know why it is called a co-evolutionary model. Furthermore, the practical experiences gathered in a couple of large-scale projects will be reported to you. The general context of microsimulations as a sampling tool is briefly introduced such that you know how to apply these methods

Slides

 

2. Installation

[60 minutes]

Lecturers: ...

In this lesson, we will install all the components necessary to run MATSim and to develop your own code. These are the Java SE Development Kit, Eclipse as the software development environment and of course MATSim.

  

3. Getting Started: Running the Simulation For the First Time

[150 minutes]

Lecturers: ...

In this lesson you will run MATSim for the first time. You will also have a first look into the configuration file, a key part when using MATSim. The complete scenario is handed out to you. However, during the next lessons we will reconstruct it such that you understand its basic components and such that you are able to build a scenario for your study region.

Slides

 

4. Generating the Input

[300 minutes]

Lecturers: ...

 

If you like to daydream, do not do it in this lesson! This lessons is about one of the crucial steps in setting up any MATSim scenario: the generation of the input data. These data is derived from various sources. Basically, any data that you can get for your study region! In a short presentation we will make you familiar with the input data for Switzerland. "But, I am not simulating Switzerland!" you may say. No worries! The procedures are always similar.

Finally, in this lesson you will generate the input given the source data.

Slides

 

5. Looking at the Output

[120 minutes]

Lecturers: ...

 

Events are the essence of MATSim. Hence, many online analyses and also post-precessing analyses are based on events.  You will get in touch with events in this lesson. This forms the basis for Lesson 7, where you will develop your own events handler.

In the second part of this lesson, the two most useful analyses tools of MATSim are presented. These are on the one hand a powerful visualizer tool developed and distributed by senozon AG. On the other hand the count data analyzer will be introduced.

Slides

 

6. Configuring the Scenario

[90 minutes]

Lecturers: ...

In this lesson, we will look closer at the configuration file. You will also get a rough idea of the MATSim scoring and the replanning modules of MATSim.

 Slides

 

 

 

7. Extending Your Controler

[120 minutes]

Lecturers: ...

If you want to add analyses that are be executed online (i.e., in the course of the iterations) you can add our own controler listeners. In this lesson you will  further develop your own controler and add your own events handler to it.

 Slides

 

 

8. Bringing It All Together: Policy Study

[120 minutes]

Lecturers: ...

In this lesson we will bring all the components together and do a policy study using our scenario created.