/matsim-example-project

Primary LanguageJavaGNU General Public License v2.0GPL-2.0

matsim-example-project

A small example of how to use MATSim as a library.

By default, this project uses the latest (pre-)release. In order to use a different version, edit pom.xml.

A recommended directory structure is as follows:

  • src for sources
  • original-input-data for original input data (typically not in MATSim format)
  • scenarios for MATSim scenarios, i.e. MATSim input and output data. A good way is the following:
    • One subdirectory for each scenario, e.g. scenarios/mySpecialScenario01.
    • This minimally contains a config file, a network file, and a population file.
    • Output goes one level down, e.g. scenarios/mySpecialScenario01/output-from-a-good-run/....

Import into eclipse

  1. download a modern version of eclipse. This should have maven and git included by default.
  2. file->import->git->projects from git->clone URI and clone as specified above. It will go through a sequence of windows; it is important that you import as 'general project'.
  3. file->import->maven->existing maven projects

Sometimes, step 3 does not work, in particular after previously failed attempts. Sometimes, it is possible to right-click to configure->convert to maven project. If that fails, the best thing seems to remove all pieces of the failed attempt in the directory and start over.

Java program

  • /src/main/java/com/xenon/maven/
    • Osm_transfer_Xml: transfer the .osm network to .xml network.
    • Plan_Generate: genertate plans.xml base on network.xml.
  • /src/main/java/org/matsim/
    • gui: start MATSim GUI.
    • project: one simple MATSim example.