matsim-episim-libs

Epidemic simulation for MATSim

https://github.com/matsim-org/matsim-episim-libs

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
  • Committers with academic emails
    20 of 39 committers (51.3%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.6%) to scientific vocabulary

Keywords

covid-19 epidemic epidemic-simulations matsim matsim-episim

Keywords from Contributors

interactive packaging network-simulation hacking autograding embedded optim standardization projection generic
Last synced: 6 months ago · JSON representation ·

Repository

Epidemic simulation for MATSim

Basic Info
  • Host: GitHub
  • Owner: matsim-org
  • License: agpl-3.0
  • Language: Java
  • Default Branch: develop
  • Homepage: https://covid-sim.info
  • Size: 106 MB
Statistics
  • Stars: 23
  • Watchers: 7
  • Forks: 31
  • Open Issues: 4
  • Releases: 11
Topics
covid-19 epidemic epidemic-simulations matsim matsim-episim
Created almost 6 years ago · Last pushed 11 months ago
Metadata Files
Readme License Citation

README.md

MATSim Episim

build license JDK Coverage

This repository contains an epidemic simulation based on MATSim, provided by the Transport Systems Planning and Transport Telematics group of Technische Universität Berlin.

Dissemination of some scenarios and results produced with the methods in this repository can be found at https://matsim-vsp.github.io/covid-sim/.

How to use Episim

In order perform an epidemic simulation you first need an MATSim events file. To get started you can also use a provided event file from the OpenBerlin Scenario.

It is best to run the scenarios with your IDE from the org.matsim.run package. In org.matsim.run.modules you can find example scenarios that you may adapt or use to create your own configuration.

To run them you can create a standalone jar file with:

mvn package

and run it with (where OpenBerlinScenario is the name of the scenario you want to run):

java -jar matsim-episim-1.0-SNAPSHOT.jar --modules OpenBerlinScenario

Generating mobility traces events file

If you have a MATSim scenario you can also create your own event file to be used for an epidemic simulation. All that is needed is the population and the event file of one iteration.

Run DownSampleScenario to extract the necessary information:

java -jar matsim-episim-1.0-SNAPSHOT.jar scenarioCreation downSample 0.1 \
    --population <Path to plans.xml> --events <Path to events.xml>

This example will write a 10% sample into output that can be used in the subsequent steps.

Licenses

The MATSim program code in this repository is distributed under the terms of the GNU Affero General Public License. The MATSim program code are files that reside in the src directory hierarchy and typically end with *.java.

The MATSim input files, output files, analysis data and visualizations are licensed under a Creative Commons Attribution 4.0 International License. Creative Commons License
MATSim input files are those that are used as input to run MATSim. They often, but not always, have a header pointing to matsim.org. They typically reside in the scenarios directory hierarchy. MATSim output files, analysis data, and visualizations are files generated by MATSim runs, or by postprocessing. They typically reside in a directory hierarchy starting with output.

Other data files, in particular in original-input-data, have their own individual licenses that need to be individually clarified with the copyright holders.

More information

For more information about the methodology and preliminary results, see VSP working paper https://dx.doi.org/10.14279/depositonce-9835 .

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

Owner

  • Name: MATSim
  • Login: matsim-org
  • Kind: organization

Multi-Agent Transport Simulation

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: MATSim Episim
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - given-names: Christian
    family-names: Rakow
    email: rakow@vsp.tu-berlin.de
    affiliation: Technische Universität Berlin
    orcid: 'https://orcid.org/0000-0003-3760-2243'
  - given-names: Sebastian
    family-names: Müller
    email: mueller@vsp.tu-berlin.de
    affiliation: Technische Universität Berlin
    orcid: 'https://orcid.org/0000-0002-3103-8955'
  - email: rehmann@vsp.tu-berlin.de
    given-names: Jakob
    family-names: Rehmann
    affiliation: Technische Universität Berlin
  - given-names: Sydney
    family-names: Paltra
    email: paltra@vsp.tu-berlin.de
    affiliation: Technische Universität Berlin
  - given-names: Ricardo
    family-names: Ewert
    email: ewert@vsp.tu-berlib.de
    affiliation: Technische Universität Berlin
    orcid: 'https://orcid.org/0000-0002-6973-3099'
  - given-names: Kai
    family-names: Nagel
    email: nagel@vsp.tu-berlin.de
    affiliation: Technische Universität Berlin
    orcid: 'https://orcid.org/0000-0003-2775-6898'
url: "https://github.com/matsim-org/matsim-episim-libs"
date-released: 2022-12-09
year: 2022
version: 22.12
license: AGPL-3.0

GitHub Events

Total
  • Watch event: 1
  • Delete event: 1
  • Push event: 44
  • Pull request event: 4
  • Create event: 4
Last Year
  • Watch event: 1
  • Delete event: 1
  • Push event: 44
  • Pull request event: 4
  • Create event: 4

Committers

Last synced: over 2 years ago

All Time
  • Total Commits: 3,091
  • Total Committers: 39
  • Avg Commits per committer: 79.256
  • Development Distribution Score (DDS): 0.703
Past Year
  • Commits: 43
  • Committers: 5
  • Avg Commits per committer: 8.6
  • Development Distribution Score (DDS): 0.372
Top Committers
Name Email Commits
Christian Rakow r****w@v****e 917
smuellervsp m****r@v****e 584
ikaddoura k****a@v****e 317
kainagel n****l@v****e 290
Jakob Rehmann j****n@g****m 263
leich l****h@v****e 189
tschlenther s****r@v****e 173
Ricardo Ewert r****t@c****e 98
rewert e****t@v****e 89
kturner m****r@v****e 30
Steffen Fürst (Mint@Home) f****t@z****e 25
Kai Nagel 2****8@k****g 19
rakow r****w 18
kainagel k****l 10
Hugo Alejandro Castro c****o@v****e 9
Sydney Paltra p****y@h****e 8
Michael Zilske m****e@t****e 7
Kai Martins-Turner k****r@c****e 6
hacas h****s@D****7 6
hao lutz n****y@s****g 3
sebastianmuller s****r@s****x 3
aravindsasi a****9@g****m 3
dziemke z****e@v****e 3
Paul Menzel p****l@m****e 2
erica e****a@D****2 2
dependabot[bot] 4****] 2
vsp-gleich v****h 2
Sydpaltra 6****a 2
Sydpaltra p****a@t****e 1
mrieser r****r@g****m 1
and 9 more...

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 0
  • Total pull requests: 2
  • Average time to close issues: N/A
  • Average time to close pull requests: about 1 month
  • Total issue authors: 0
  • Total pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 2
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 2
  • Average time to close issues: N/A
  • Average time to close pull requests: about 1 month
  • Issue authors: 0
  • Pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 2
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
  • jakobrehmann (8)
  • kainagel (2)
  • dependabot[bot] (1)
Top Labels
Issue Labels
Pull Request Labels
dependencies (1)

Dependencies

pom.xml maven
  • com.fasterxml.jackson.dataformat:jackson-dataformat-yaml 2.10.2
  • com.fasterxml.jackson.datatype:jackson-datatype-jsr310 2.10.2
  • com.github.ClickerMonkey:TrieHard 1.0
  • com.lmax:disruptor 3.4.2
  • com.typesafe:config 1.4.0
  • commons-io:commons-io 2.7
  • info.picocli:picocli 4.3.2
  • it.unimi.dsi:fastutil 8.5.4
  • org.apache.commons:commons-math3 3.6.1
  • org.apache.poi:poi 4.1.2
  • org.apache.poi:poi-ooxml 4.1.2
  • org.jgrapht:jgrapht-core 1.5.0
  • org.jgrapht:jgrapht-io 1.5.0
  • org.matsim.contrib:vsp 13.0
  • org.matsim:matsim 13.0
  • tech.tablesaw:tablesaw-core 0.38.1
  • tech.tablesaw:tablesaw-jsplot 0.38.1
  • junit:junit 4.13.1 test
  • org.assertj:assertj-core 3.15.0 test
  • org.matsim:matsim 13.0 test
  • org.mockito:mockito-core 3.3.3 test
  • org.openjdk.jmh:jmh-core 1.23 test
  • org.openjdk.jmh:jmh-generator-annprocess 1.23 test
src/main/python/requirements.txt pypi
  • numpy >=1.19
  • optuna ==1.5.0
  • pandas >=1.1.1
  • scikit-learn >=0.23
.github/workflows/build.yaml actions
  • actions/cache v2 composite
  • actions/checkout v2 composite
  • actions/setup-java v1 composite
.github/workflows/publish.yaml actions
  • actions/checkout v2 composite
  • actions/setup-java v1 composite