The eqasim package is a collection of ready-to-run high-quality scenarios
for the agent- and activity-based transport simulation framework MATSim.
This repository contains the Java parts of the project which extend MATSim and
provide functionality to generate the simulation data.
Therefore, this repository has two functions: First, to provide the code to run
eqasim simulations (and extend them), second, to act as a dependency for the
various pipelines that generate runnable MATSim scenarios from raw data sets,
such as for:
To understand how to set up a simulation and run it, please refer to the respective repositories.
Additional topics:
- How to cut out smaller parts of existing simulations.
- How to run a simulation with on-demand mobility services (as a main mode and as a transit feeder).
- How to run the discrete mode choice model as a standalone
- How to use Volume Delay Functions for the network simulation
The main research reference for the eqasim-java framework:
Hörl, S. and M. Balac (2021) Introducing the eqasim pipeline: From raw data to agent-based transport simulation, Procedia Computer Science, 184, 712-719.
The current version of eqasim is 1.5.0 and is based on MATSim 15.0. You can access it through the v1.5.0 tag. The
develop branch is kept at version 1.5.0 until the next release is prepared,
but may include additional developments since the last release.
The code is available as a Maven package. To use it, add the following repository
to your pom.xml:
<repository>
<id>eqasim</id>
<url>https://packagecloud.io/eth-ivt/eqasim/maven2</url>
</repository>Afterwards, you can add various sub-packages to your project:
<dependency>
<groupId>org.eqasim</groupId>
<artifactId>core</artifactId>
<version>1.5.0</version>
</dependency>Besides the latest release based on MATSim 15.0, legacy versions 1.3.1, 1.2.1, 1.2.0, 1.0.6, and 1.0.5 are also available through packagecloud.
To keep scenario-based repositories up-to-date (for instance, ile-de-france), we provide the upstream branch, which contains a well-defined develop version of eqasim-java and is used in the develop version of the dependent repository. While this is useful for development purposes, their versioned releases will always depend on versioned releases of eqasim-java.