Skip to content

Commit

Permalink
Merge branch 'master' into shiny-dashboard
Browse files Browse the repository at this point in the history
  • Loading branch information
tschlenther committed Jul 30, 2024
2 parents 8365351 + b0baffc commit 2975463
Show file tree
Hide file tree
Showing 21 changed files with 1,535 additions and 260 deletions.
8 changes: 4 additions & 4 deletions CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -34,8 +34,8 @@ authors:
affiliation: Technische Universität Berlin
orcid: 'https://orcid.org/0000-0003-2775-6898'
url: "https://github.com/matsim-scenarios/matsim-kelheim"
doi: 10.5281/zenodo.8322240
date-released: 2023-09-06
year: 2023
version: 3.1
doi: 10.5281/zenodo.8322239
date-released: 2024-06-25
year: 2024
version: 3.1.1
license: AGPL-3.0
15 changes: 7 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,20 +3,18 @@
[![Build Status](https://github.com/matsim-scenarios/matsim-kelheim/actions/workflows/build.yaml/badge.svg)](https://github.com/matsim-scenarios/matsim-kelheim/actions/workflows/build.yaml)
![license](https://img.shields.io/github/license/matsim-scenarios/matsim-kelheim.svg)
[![DOI (v3.0)](https://zenodo.org/badge/360167859.svg)](https://zenodo.org/badge/latestdoi/360167859)
[![DOI (v3.1.1)](https://zenodo.org/badge/DOI/10.5281/zenodo.13132756.svg)](https://doi.org/10.5281/zenodo.13132756)
![JDK](https://img.shields.io/badge/JDK-17+-green.svg)

![Kelheim MATSim network and agents](visualization-kelheim.png "Kelheim MATSim network and agents")






### About this project

This repository provides an open MATSim transport model for Kelheim, provided by the [Transport Systems Planning and Transport Telematics group](https://www.tu.berlin/vsp) of [Technische Universität Berlin](http://www.tu-berlin.de).
It is developed as part of the [KelRide](https://kelride.com/) project and thus funded by the [German Federal Minstery for Digital and Transport](https://bmdv.bund.de/DE/Home/home.html).

<a rel="TU Berlin" href="https://www.vsp.tu-berlin.de"><img src="https://svn.vsp.tu-berlin.de/repos/public-svn/ueber_uns/logo/TUB_Logo.png" width="15%" height="15%"/></a>
<a rel="TU Berlin" href="https://www.vsp.tu-berlin.de"><img src="https://svn.vsp.tu-berlin.de/repos/public-svn/ueber_uns/logo/TU_BERLIN_Logo_Lang_RGB_SR_rot.svg" width="15%" height="15%"/></a>

This scenario contains a 25pct sample of Kelheim and its surrounding area; road capacities are accordingly reduced. The scenario is calibrated taking into consideration the traffic counts, modal split and mode-specific trip distance distributions.

Expand Down Expand Up @@ -58,15 +56,15 @@ It can be used by using either of these methods:
(Requires either cloning or downloading the repository and java)

1. Open the cmd and go to your project directory
2. Build the scenario using `mvnw package`. Add the option `-Dskiptests=true` in order to skip tests and speed up the process.
2. Build the scenario using `./mvnw package`. Add the option `-DskipTests=true` in order to skip tests and speed up the process.
3. There should be a file directly in the `matsim-kelheim` directory with name approximately as `matsim-kelheim-3.x-SNAPSHOT-<commitId>.jar`.
4. Run this file from the command line using `java -jar matsim-kelheim-3.x-SNAPSHOT-<commitId>.jar --help` to see all possible options.
1. For example, one can disable lanes or run smaller sample sizes using the available options
5. Start this scenario using the default config by running `java -jar matsim-kelheim-3.x-SNAPSHOT-<commitId>.jar`.
1. If you want to run the scenario somewhere else, e.g. on a computation cluster, make sure to not only copy the jar but also the 'input' directory and put it right next to the jar.
6. "Open" the output directory.
1. You can drag files into VIA as was already done above.
2. You can also browse the output directory on vsp.berlin/simwrapper and analyze some of your results with interactive dashboards.
2. You can also browse the output directory on vsp.berlin/simwrapper and analyse some of your results with interactive dashboards.

----
### Results and analysis
Expand All @@ -78,14 +76,15 @@ Here are the most common ways to analyse and visualize the results (and inputs):
1. (use Google for the best experience)
2. Browse your local output directory or [the public matsim-kelheim data repo](https://vsp.berlin/simwrapper/public/de/kelheim)
2. Explore and create many interactive visualisations and dashboards
3. Analysis the output .csv tables using the R language and [the matsim-r package](https://github.com/matsim-vsp/matsim-r)
3. Analyse the output .csv tables using the R language and [the matsim-r package](https://github.com/matsim-vsp/matsim-r)

If you have questions, feel free to contact us [(VSP)](https://www.tu.berlin/vsp) any time :)

---
## More information

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

## Internal documentation

Internal documentation can be found here:
Expand Down
Loading

0 comments on commit 2975463

Please sign in to comment.