simona

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

https://github.com/ie3-institute/simona

Science Score: 62.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
  • Academic publication links
  • Committers with academic emails
    14 of 20 committers (70.0%) from academic institutions
  • Institutional organization owner
    Organization ie3-institute has institutional domain (ie3.etit.tu-dortmund.de)
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (19.0%) to scientific vocabulary

Keywords

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

Keywords from Contributors

interactive cryptocurrencies charts transformation generic diffusion meshes annotation embedded pypi
Last synced: 6 months ago · JSON representation ·

Repository

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

Basic Info
  • Host: GitHub
  • Owner: ie3-institute
  • License: bsd-3-clause
  • Language: Scala
  • Default Branch: dev
  • Homepage:
  • Size: 91.6 MB
Statistics
  • Stars: 32
  • Watchers: 4
  • Forks: 6
  • Open Issues: 95
  • Releases: 2
Topics
agent-based-simulation electricity energy energy-transition powersystem research simulation
Created over 4 years ago · Last pushed 6 months ago
Metadata Files
Readme Changelog Contributing License Citation Codeowners Authors

README.md

simona logo

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:

Owner

  • Name: Institute of Energy Systems, Energy Efficiency and Energy Economics - ie3
  • Login: ie3-institute
  • Kind: organization
  • Location: Dortmund, Germany

Official github account of the ie3 - one of the leading German higher education research institutes in the field of energy

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:
  - name: "ie³ - Institute of Energy Systems, Energy Efficiency and Energy Economics - TU Dortmund University"
    alias: ie³
    address: "Martin-Schmeißer-Weg 12"
    city: Dortmund
    country: DE
    post-code: 44227
    website: "https://ie3.etit.tu-dortmund.de/"
  - 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
    orcid: https://orcid.org/0009-0005-3309-5258
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: 4.0.0
date-released: 2025-05-09

GitHub Events

Total
  • Create event: 273
  • Release event: 1
  • Issues event: 362
  • Watch event: 9
  • Delete event: 265
  • Issue comment event: 207
  • Push event: 1,862
  • Pull request review event: 848
  • Pull request review comment event: 636
  • Pull request event: 519
  • Fork event: 3
Last Year
  • Create event: 273
  • Release event: 1
  • Issues event: 362
  • Watch event: 9
  • Delete event: 265
  • Issue comment event: 207
  • Push event: 1,862
  • Pull request review event: 848
  • Pull request review comment event: 636
  • Pull request event: 519
  • Fork event: 3

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 4,086
  • Total Committers: 20
  • Avg Commits per committer: 204.3
  • Development Distribution Score (DDS): 0.624
Past Year
  • Commits: 1,865
  • Committers: 10
  • Avg Commits per committer: 186.5
  • Development Distribution Score (DDS): 0.591
Top Committers
Name Email Commits
danielfeismann d****n@t****e 1,535
Sebastian Peter s****r@t****e 1,055
dependabot[bot] 4****] 374
staudtMarius m****t@t****e 365
Philipp Schmelter p****p@s****e 242
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
Marvin Heintze m****e@w****e 36
Thomas t****n@g****m 34
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 (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 536
  • Total pull requests: 1,333
  • Average time to close issues: 4 months
  • Average time to close pull requests: about 1 month
  • Total issue authors: 16
  • Total pull request authors: 18
  • Average comments per issue: 0.28
  • Average comments per pull request: 1.13
  • Merged pull requests: 982
  • Bot issues: 2
  • Bot pull requests: 586
Past Year
  • Issues: 215
  • Pull requests: 586
  • Average time to close issues: 17 days
  • Average time to close pull requests: 9 days
  • Issue authors: 9
  • Pull request authors: 10
  • Average comments per issue: 0.1
  • Average comments per pull request: 0.36
  • Merged pull requests: 427
  • Bot issues: 2
  • Bot pull requests: 203
Top Authors
Issue Authors
  • sebastian-peter (202)
  • danielfeismann (151)
  • staudtMarius (61)
  • t-ober (49)
  • ckittl (31)
  • PhilippSchmelter (12)
  • johanneshiry (9)
  • jo-bao (6)
  • SimonHuette (4)
  • pierrepetersmeier (3)
  • lararou (2)
  • dependabot[bot] (2)
  • marvinheintze (1)
  • kkarthik11 (1)
  • julianhohmann (1)
Pull Request Authors
  • dependabot[bot] (586)
  • sebastian-peter (216)
  • danielfeismann (182)
  • staudtMarius (167)
  • PhilippSchmelter (43)
  • pierrepetersmeier (40)
  • ckittl (28)
  • marvinheintze (19)
  • t-ober (12)
  • vickybung1 (12)
  • jo-bao (11)
  • SimonHuette (8)
  • johanneshiry (2)
  • amdadulbari (2)
  • imoverclocked (2)
Top Labels
Issue Labels
enhancement (133) bug (130) code quality (83) documentation (51) dependencies (41) good first issue (31) test (30) ci (23) config (18) pekko typed (15) em (14) HiWiStart (9) dbfs (8) question (7) speed (7) log (5) format (4) internal (3) blocked externally (3) release (3) akka typed (2) wontfix (2) java (2) invalid (1) windows (1) duplicate (1)
Pull Request Labels
dependencies (628) java (345) enhancement (189) code quality (162) bug (156) python (83) documentation (63) test (58) ci (40) em (23) config (22) pekko typed (19) wontfix (8) speed (8) good first issue (7) HiWiStart (6) log (5) format (3) dbfs (3) blocked externally (2) internal (2) duplicate (1) invalid (1) release (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