The MATSim Open Berlin Scenario
Clone or download
Latest commit 196c630 Jan 11, 2019

README.md

The MATSim Open Berlin Scenario

About this project

This repository provides an open MATSim transport model for Berlin, provided by the Transport Systems Planning and Transport Telematics group of Technische Universität Berlin.

Currently, there are two versions of the MATSim Open Berlin model:

10pct scenario (scenarios/berlin-v5.2-10pct)

This scenario contains a 10pct sample of the Greater Berlin population; road capacities are accordingly reduced. The scenario is calibrated taking into consideration the traffic counts, modal split and mode-specific trip distance distributions.

1pct scenario (scenarios/berlin-v5.2-1pct)

This scenario contains a 1pct sample of the Greater Berlin population; road capacities are accordingly reduced. This scenario was not (!) calibrated and should only be used for testing purposes or pre-studies!

Simple things (without installing/running MATSim)

Movies

Go to https://svn.vsp.tu-berlin.de/repos/public-svn/matsim/scenarios/countries/de/berlin/berlin-v5.2-10pct/output-berlin-v5.2-10pct/ and look for movie-* files. You can't view them directly, but you there are various ways to download them, and you can view them then. Try that.

  1. Go into the scenarios directory.
  2. Decide for a scenario that you find interesting (e.g. berlin-v5.0-0.1pct-2018-06-18) and go into that directory.
  3. Inside there, look for an output-* directory that you find interesting and go into that directory.
  4. Inside there, look for movie-* files. You can't view them directly, but you there are various ways to download them, and you can view them then. Try that.
Run VIA on output files
  1. Get VIA from https://www.simunto.com/via/.
  2. For the 10pct scenario, go to https://svn.vsp.tu-berlin.de/repos/public-svn/matsim/scenarios/countries/de/berlin/berlin-v5.2-10pct/output-berlin-v5.2-10pct/. For the 1pct scenario, go to https://svn.vsp.tu-berlin.de/repos/public-svn/matsim/scenarios/countries/de/berlin/berlin-v5.2-1pct/output-berlin-v5.2-1pct/.
  3. Download output_network.xml.gz and output_events.xml.gz. Best make sure that they do not uncompress, e.g. by "Download linked file as ...".
  4. Get these files into VIA. This can be achieved in various ways; one is to open VIA and then drag the files from a file browser into VIA.
  5. Run VIA and enjoy.

Downloading the repository alternative 1: Download ZIP

  1. Click on Clone or download and then on Download ZIP.
  2. Unzip the repository.
  3. Go to "Run the MATSim Berlin scenario" below.

Downloading the repository alternative 2: Clone the repository

Initial stuff (needs to be done once)
  1. Install git for the command line.
  2. Type git clone https://github.com/matsim-vsp/matsim-berlin.git in the command line.

(Or use your IDE, e.g. Eclipse, IntelliJ, to clone the repository.)

This will result in a new matsim-berlin directory. Memorize where you have put it. You can move it, as a whole, to some other place.

Update your local clone of the repository.
  1. Go into the matsim-berlin directory.
  2. Type git pull

(Or use your IDE, e.g. Eclipse, IntelliJ, to update the repository.)

This will update your repository to the newest version.

Run the MATSim Berlin scenario

(Requires either cloning or downloading the repository.)

... using a runnable jar file
  1. There should be a file directly in the matsim-berlin directory with name approximately as matsim-berlin-5.2-jar-with-dependencies.jar.
  2. Double-click on that file (in a file system browser). A simple GUI should open.
  3. In the GUI, click on the "Choose" button for configuration file. Navigate to one of the scenario directories and load one of the configuration files.
  4. Increase memory in the GUI.
  5. Press the "Start MATSim" button. This should run MATSim.
  6. "Open" the output directory. You can drag files into VIA as was already done above.
  7. "Edit..." (in the GUI) the config file. Re-run MATSim.
... using an IDE, e.g. Eclipse, IntelliJ
  1. Set up the project in your IDE.
  2. Make sure the project is configured as maven project.
  3. Run the JAVA class src/main/java/org/matsim/run/RunBerlinScenario.java.
  4. "Open" the output directory. You can drag files into VIA as was already done above.
  5. Edit the config file or adjust the run class. Re-run MATSim.

More information

For more information about the scenario generation, see here: https://svn.vsp.tu-berlin.de/repos/public-svn/publications/vspwp/2019/19-01/ZiemkeEtAl2019OpenBerlinScenarioVSPWP.pdf

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