SIMONA

Provides a simulation toolbox to run and implement large-scale agent-based electricity grid simulations with focus on distribution grids.
https://github.com/ie3-institute/simona

Category: Energy Systems
Sub Category: Grid Analysis and Planning

Keywords

agent-based-simulation electricity energy energy-transition powersystem research simulation

Keywords from Contributors

datamodel opendata powersystems measurements converter observability generation electrical-engineering annotation featured

Last synced: about 11 hours ago
JSON representation

Repository metadata

simona is an agent-based discrete-event power system simulation model developed @ie3-institute

README.md

SIMONA

CI
Quality Gate Status
Coverage
Documentation Status
License
Maven Central

The agent-based simulation environment SIMONA provides a simulation toolbox to run and implement large-scale agent-based
electricity grid simulations with focus on distribution grids. As a result, close-to-reality time series are
generated from various system participants and grid assets that can be used to analyze a given power grid.
Application cases are for example distribution grid planning purposes but also flexibility analysis or coupled
sector interdependency analysis. The framework contains several out-of-the-box available models for a wide variety of grid participants as well as their
operational behavior.

More information are provided in the project's documentation.

Usage and Contribution

SIMONA is part of several ongoing research projects and will be part of future research projects. Hence, the codebase
is continuously under development from different perspectives, needs and developers.

We invite everyone to use SIMONA for their own research or for usage in a research project. If you use SIMONA for your
own projects or research, please provide a reference to this repository. Furthermore, if you publish your scientific work
please give appropriate credit by citing one of the introduction papers of SIMONA.

We're also happy for any feedback and contributions. For details on how to contribute, please take a look at the
CONTRIBUTING.md file in the root directory of this repository.

Questions

For all SIMONA related questions please feel free to contact people involved in the development and maintenance of SIMONA.
For the moment, these people are:

Citation (CITATION.cff)

cff-version: 1.2.0
title: "SIMONA - A Discrete-Event Distribution Grid Simulation Environment"
message: "If you use this software, please cite it as below."
type: software
authors:
  - family-names: Hiry
    given-names: Johannes
    orcid: https://orcid.org/0000-0002-1447-0607
  - family-names: Kittl
    given-names: Chris
    orcid: https://orcid.org/0000-0002-1187-0568
  - family-names: Sen Sarma
    given-names: Debopama
    orcid: https://orcid.org/0000-0003-3311-3020
  - family-names: Oberließen
    given-names: Thomas
    orcid: https://orcid.org/0000-0001-5805-5408
  - family-names: Peter
    given-names: Sebastian
    orcid: https://orcid.org/0000-0001-6311-6113
  - family-names: Feismann
    given-names: Daniel
    orcid: https://orcid.org/0000-0002-3531-9025
  - family-names: Bao
    given-names: Johannes
    orcid: https://orcid.org/0009-0008-3641-6469
  - family-names: Hohmann
    given-names: Julian
  - family-names: Staudt
    given-names: Marius
repository-code: https://github.com/ie3-institute/simona
url: https://simona.ie3.e-technik.tu-dortmund.de
repository-artifact: https://central.sonatype.com/artifact/com.github.ie3-institute/simona
keywords:
  - agent-based
  - discrete-event simulation
  - powerflow
  - electricity distribution grid
license: BSD-3-Clause
version: 3.0.0
date-released: 2023-08-07

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 9 days ago

Total Commits: 3,658
Total Committers: 20
Avg Commits per committer: 182.9
Development Distribution Score (DDS): 0.648

Commits in past year: 1,708
Committers in past year: 11
Avg Commits per committer in past year: 155.273
Development Distribution Score (DDS) in past year: 0.636

Name Email Commits
danielfeismann d****n@t****e 1288
Sebastian Peter s****r@t****e 1005
dependabot[bot] 4****] 347
staudtMarius m****t@t****e 270
Philipp Schmelter p****p@s****e 237
pierrepetersmeier p****r@t****e 136
Kittl, Chris c****l@t****e 103
Simon Hütte s****e@t****e 59
Vicky Bung v****g@t****e 45
Johannes Hiry j****y@t****e 45
Thomas t****n@g****m 34
Marvin Heintze m****e@w****e 32
pierrepetersmeier p****r@t****e 17
Johannes Bao j****o@t****e 16
marvinheintze m****e@w****e 10
lararou l****s@t****e 5
Johannes Bao s****o@i****e 4
Daniel Feismann s****s@i****e 2
Julian Hohmann j****n@t****e 2
aa 1

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 574
Total pull requests: 932
Average time to close issues: 3 months
Average time to close pull requests: about 1 month
Total issue authors: 14
Total pull request authors: 17
Average comments per issue: 0.32
Average comments per pull request: 1.38
Merged pull request: 734
Bot issues: 0
Bot pull requests: 443

Past year issues: 301
Past year pull requests: 394
Past year average time to close issues: 23 days
Past year average time to close pull requests: 15 days
Past year issue authors: 8
Past year pull request authors: 10
Past year average comments per issue: 0.2
Past year average comments per pull request: 0.45
Past year merged pull request: 309
Past year bot issues: 0
Past year bot pull requests: 122

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/ie3-institute/simona

Top Issue Authors

  • sebastian-peter (213)
  • danielfeismann (176)
  • staudtMarius (59)
  • t-ober (51)
  • ckittl (31)
  • PhilippSchmelter (14)
  • johanneshiry (9)
  • jo-bao (8)
  • SimonHuette (4)
  • pierrepetersmeier (3)
  • marvinheintze (2)
  • lararou (2)
  • julianhohmann (1)
  • vickybung1 (1)

Top Pull Request Authors

  • dependabot[bot] (443)
  • sebastian-peter (147)
  • danielfeismann (119)
  • staudtMarius (98)
  • pierrepetersmeier (23)
  • ckittl (22)
  • PhilippSchmelter (22)
  • t-ober (12)
  • vickybung1 (12)
  • marvinheintze (11)
  • jo-bao (8)
  • SimonHuette (7)
  • johanneshiry (2)
  • amdadulbari (2)
  • imoverclocked (2)

Top Issue Labels

  • enhancement (146)
  • bug (146)
  • code quality (91)
  • documentation (54)
  • dependencies (41)
  • test (34)
  • good first issue (32)
  • ci (30)
  • pekko typed (21)
  • config (21)
  • HiWiStart (17)
  • em (17)
  • question (9)
  • speed (7)
  • dbfs (7)
  • format (5)
  • log (5)
  • blocked externally (3)
  • internal (3)
  • akka typed (3)
  • wontfix (2)
  • invalid (1)
  • release (1)
  • windows (1)
  • duplicate (1)
  • java (1)

Top Pull Request Labels

  • dependencies (480)
  • java (220)
  • enhancement (115)
  • bug (109)
  • code quality (88)
  • python (65)
  • documentation (46)
  • test (37)
  • ci (25)
  • em (15)
  • config (12)
  • pekko typed (12)
  • speed (7)
  • good first issue (7)
  • HiWiStart (6)
  • wontfix (5)
  • dbfs (4)
  • log (4)
  • format (2)
  • blocked externally (2)
  • duplicate (1)
  • invalid (1)
  • release (1)
  • internal (1)

Dependencies

Dockerfile docker
  • openjdk 17-slim build
build.gradle maven
  • ch.qos.logback:logback-classic 1.4.5 implementation
  • com.github.carueda:tscfg_2.13 $tscfgVersion implementation
  • com.github.ie3-institute:PowerSystemDataModel 3.0-SNAPSHOT implementation
  • com.github.ie3-institute:PowerSystemUtils 2.0-SNAPSHOT implementation
  • com.github.ie3-institute:powerflow 0.1 implementation
  • com.github.ie3-institute:simonaAPI 0.1-SNAPSHOT implementation
  • com.typesafe:config 1.4.2 implementation
  • de.lmu.ifi.dbs.elki:elki 0.7.5 implementation
  • io.confluent:kafka-streams-avro-serde 7.2.2 implementation
  • javax.measure:unit-api 2.1.3 implementation
  • org.apache.commons:commons-csv 1.9.0 implementation
  • org.apache.commons:commons-math3 3.6.1 implementation
  • org.apache.poi:poi-ooxml 5.2.3 implementation
  • org.jgrapht:jgrapht-core 1.5.1 implementation
  • org.locationtech.jts.io:jts-io-common ${jtsVersion} implementation
  • org.locationtech.jts:jts-core ${jtsVersion} implementation
  • org.mockito:mockito-core 5.0.0 implementation
  • org.scala-lang:scala-library ${scalaBinaryVersion} implementation
  • org.scalanlp:breeze_2.13 1.3 implementation
  • tech.units:indriya 2.1.3 implementation
  • org.scalatestplus:mockito-3-4_2.13 3.2.10.0 testImplementation
  • org.spockframework:spock-core 2.3-groovy-4.0 testImplementation
  • com.vladsch.flexmark:flexmark-all 0.64.0 testRuntimeOnly
docs/readthedocs/requirements.txt pypi
  • Sphinx ==4.5.0
  • markdown-it-py ==2.1.0
  • myst-parser ==0.17.2
  • sphinx-hoverxref ==1.0.1
  • sphinx-rtd-theme ==1.0.0
  • sphinxcontrib-bibtex ==2.4.2
  • sphinxcontrib-plantuml ==0.23

Score: 7.986164860332726