The multi-agent simulation repository (MAS) enables the generation of base-scenarios for German subregions. It will resource data from InnoZ' Mobility DataHub (on the 'playground' server) and will store outdata there as well. Therefore this repo includes the following files:
Due to the constant development process of MATSim, we do not provide a documentation in this repo. For information about how to set up, run and interpret MATSim see
To run one of the scenarios from the terminal on your local machine you need a Java development kit (jdk). We strongly recommend to use the latest java version available!
There are several implementations of jdks available. The most common ones are the Oracle implementation and OpenJDK. Choose for yourself which one you prefer, they should work identically. To install Java on a Windows system, just download the installation file of the latest release and follow the instructions during the installation process.
The installation of Java under a Linux distribution can either be done in the software center or in the terminal. Compare here. To update e.g. OpenJDK, Version X you need to run
sudo apt-get install openjdk-X-jdk openjdk-X-source
If Ubuntu should not find the requested files, you need to add the ppa key with the following command
sudo add-apt-repository ppa:openjdk-r/ppa'
After that, run
sudo apt-get update
and execute the sudo apt-get install command again.
If you have further questions, have a look at this page.
If you want to write java scripts or your own java classes to extend or modify MATSim, you also need a software IDE (most of the MATSim developers use Eclipse IDE for Java Developers).
Windows: Download the zip-File and unzip it to wherever you want to place it. To install Eclipse in Linux follow the instructions here: http://www.krizna.com/ubuntu/install-eclipse-in-ubuntu-12-04/ or use the software center.
Window > Show view > other... > git repositories Add an existing local Git repository > got to local repo path > select > finish
To access the Mobility DataHub, you need a user account on the playground and a database user account. Just contact either Benno Bock, Daniel Hosse or Benjamin Stolte to create these for you.
You can access the playground via SecureShell (ssh). If your computer has a Linux or an OS operating system, you need nothing else than an existing user account, ssh should already be installed. On Windows, you need to install an ssh client program like PuTTY or WinSCP. More hints can be found here.
If you just want to execute the code, there are two ways of doing this. In either way, you will first need to get the latest released jar file (here). You can use this file as a command line tool by typing:
java -cp innoz-toolbox-[release].jar com.innoz.toolbox.run.Runner
or import it as a library into your eclipse workspace.
If you want to modify or extend the existing code, you will first need to clone this repo to your local machine.
In Eclipse, you need to add this repo to the "Git Repositories" view. Then, right click on the repo and select "Import Projects...". In the next view, select the radio button called "Import existing Eclipse projects". After clicking "Next" you should select only the innoz-toolbox project and click "Finish". And that's it. In case errors are displayed, update the project to fix them.
The external references are all imported by Maven, so you don't have to add anything else. The project also comes with full MATSim core functionality. If you want to use code from contribs or something else, you will have to add these references yourself.