sebhoerl / matsim-episim

Epidemic simulation for MATSim

MATSim Episim

About this project

This repository contains an epidemic simulation based on MATSim, provided by the Transport Systems Planning and Transport Telematics group of Technische Universität Berlin.

How to use Episim

In order to perform a epidemic simulation multiple steps are necessary:

Generate mobility traces events file

First you need to run the MATSim scenario you want to analyze and generate an events file.

This step might be skipped if you use one of the provided event files.

Run DownSampleScenario to extract the necessary information for the epidemic simulation:

DownSampleScenario 0.1 --population <Path to plans.xml> --events <Path to events.xml>

This example will write a 10% sample into output that can be used in the subsequent steps.

Run epidemic simulation

It is best to run the scenarios with your IDE from the org.matsim.episim.run package. Please edit RunEpisim.class and change it according to your configuration.

You can also build the jar file, which will run the OpenBerlin scenario with a default configuration:

mvn package

And run it with:

java -jar target/matsim-episim-1.0-SNAPSHOT-jar-with-dependencies.jar

Perform analysis

TODO

Licenses

The MATSim program code in this repository is distributed under the terms of the GNU General Public License as published by the Free Software Foundation (version 2). The MATSim program code are files that reside in the src directory hierarchy and typically end with *.java.

The MATSim input files, output files, analysis data and visualizations are licensed under a Creative Commons Attribution 4.0 International License.
MATSim input files are those that are used as input to run MATSim. They often, but not always, have a header pointing to matsim.org. They typically reside in the scenarios directory hierarchy. MATSim output files, analysis data, and visualizations are files generated by MATSim runs, or by postprocessing. They typically reside in a directory hierarchy starting with output.

Other data files, in particular in original-input-data, have their own individual licenses that need to be individually clarified with the copyright holders.

More information

For more information about the methodology and preliminary results, see VSP working paper http://dx.doi.org/10.14279/depositonce-9835 .

For more information about MATSim, see here: https://www.matsim.org/.