debjitbhowmick / matsim_example-project

An example project for getting started with the MATSim Melbourne model

example-project

master dev

An example MATSim model for Melbourne for learning and training purposes. This model uses VISTA 2012-16 exact travel plans and a MATSim generated OSM-based network as its inputs.

NOTE The model of this repository is NOT based the latest developments from MATSim Melbourne project and must not be considered as the baseline model. The Baseline MATSim Melbourne Model can be found in its own dedicated repository here.

By default, this project uses the latest MATSim development head. In order to use a different version, edit pom.xml.

Import into IntelliJ

File -> New -> Project from Version Control paste the repository url and hit 'clone'. IntelliJ usually figures out that the project is a maven project. If not: Right click on pom.xml -> import as maven project.

Java version

The project uses Java 11. Usually a suitable SDK is packaged within IntelliJ or Eclipse. Otherwise, one must install a suitable sdk manually, which is available here.

Building the model

You can build an executable jar-file by executing the following command:

mvn clean package

This will download all necessary dependencies (it might take a while the first time it is run) and create java -jar target/example-project-1.0-SNAPSHOT-jar-with-dependencies.jar.

Running the example scenario

Getting the scenario data: Large scenario related input files are not stored in this git repository and must first be downloaded (see ./scenario/data/README.md).

This example model jar-file can then be executed with Java on the command line using:

java -jar -Xmx8g -Xms8g target/example-project-1.0-SNAPSHOT-jar-with-dependencies.jar