PowSyBl Tutorials

Tutorials forPowSyBl, an open source framework written in Java that makes it easy to write complex software for power systems’ simulations and analysis.
https://github.com/powsybl/powsybl-tutorials

Category: Sustainable Development
Sub Category: Education

Keywords

powsybl tutorials

Keywords from Contributors

power-systems cim energy-system extensible groovy modular power-system-simulation user-stories powerflow power-flow

Last synced: about 20 hours ago
JSON representation

Repository metadata

Tutorials

README.md

PowSyBl Tutorials

Actions Status
Quality Gate
MPL-2.0 License
Slack

PowSyBl (Power System Blocks) is an open source framework written in Java that makes it easy to write complex software for power systems’ simulations and analysis. Its modular approach allows developers to extend or customize its features.

PowSyBl is part of the LF Energy Foundation, a project of The Linux Foundation that supports open source innovation projects within the energy and electricity sectors.

Read more at https://www.powsybl.org!

This project and everyone participating in it is governed by the PowSyBl Code of Conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to powsybl.ddl@rte-france.com.

Tutorials

This document describes how to build and run small tutorial projects. For more in-depth explanations on each tutorial, please visit the documentation.

Environment requirements

  • JDK (21 or greater)
  • Maven (3.9.0 or greater)

Most tutorials show simple code and can be run directly from maven using the exec:exec@run goal on them:

$ cd <TUTORIAL-FOLDER>
$ mvn compile exec:exec@run

Example:

$ cd csv-exporter
$ mvn compile exec:exec@run
[INFO] Scanning for projects...
[INFO] 
[INFO] ------------------------------------------------------------------------
[INFO] Building Export Network to CSV 2.0.0
[INFO] ------------------------------------------------------------------------
[INFO] 
[...snip...]
[INFO] --- exec:3.5.1:java (default-cli) @ csv-exporter ---
[com.powsybl.tutorials.csv.export.Main.main()] INFO com.powsybl.commons.config.PlatformConfig - Using platform configuration provider classic
[com.powsybl.tutorials.csv.export.Main.main()] INFO com.powsybl.commons.config.PlatformConfig - Platform configuration defined by YAML file /home/rolnic/.itools/config.yml
[com.powsybl.tutorials.csv.export.Main.main()] INFO com.powsybl.tutorials.csv.export.CsvLinesExporter - CSV export done in 4 ms
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS

$ cat /tmp/test.csv
LineId,SubstationId1,SubstationId2,VoltageLevelId1,VoltageLevelId2,BusId1,BusId2,R,X,G1,B1,G2,B2
NHV1_NHV2_1,P1,P2,VLHV1,VLHV2,NHV1,NHV2,3.00000,33.0000,0.00000,0.000193000,0.00000,0.000193000
NHV1_NHV2_2,P1,P2,VLHV1,VLHV2,NHV1,NHV2,3.00000,33.0000,0.00000,0.000193000,0.00000,0.000193000

Alternatively, you can easily launch a tutorial from the root by using mvn compile exec:exec@run -pl <TUTORIAL-FOLDER> or import the projects in your favorite IDE and use its facilities to run code and start experimenting!


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 3 days ago

Total Commits: 75
Total Committers: 19
Avg Commits per committer: 3.947
Development Distribution Score (DDS): 0.853

Commits in past year: 12
Committers in past year: 6
Avg Commits per committer in past year: 2.0
Development Distribution Score (DDS) in past year: 0.5

Name Email Commits
Mathieu BAGUE m****e@r****m 11
Anne Tilloy 4****l 10
MioRtia m****a@r****m 9
Coline Piloquet 5****t 9
Sophie Frasnedo s****o@r****m 7
Nicolas Rol n****l@r****m 6
Agnès Leroy a****y@r****m 4
Jon Harper j****7@g****m 4
Geoffroy Jamgotchian g****n@g****m 3
OpenSuze 4****e 2
armic-artelys 7****s 2
Abdelsalem 4****i 1
Antoine Bouhours 1****s 1
CARON Alice a****n@r****m 1
Luma z****m@a****s 1
Samir Romdhani s****e@r****m 1
TheMaskedTurtle 5****e 1
Thomas ADAM 5****0 1
walid-sahnoun w****n@r****m 1

Committer domains:


Issue and Pull Request metadata

Last synced: 21 days ago

Total issues: 6
Total pull requests: 76
Average time to close issues: 15 days
Average time to close pull requests: about 1 month
Total issue authors: 6
Total pull request authors: 21
Average comments per issue: 0.67
Average comments per pull request: 1.01
Merged pull request: 60
Bot issues: 0
Bot pull requests: 1

Past year issues: 1
Past year pull requests: 4
Past year average time to close issues: N/A
Past year average time to close pull requests: 4 days
Past year issue authors: 1
Past year pull request authors: 4
Past year average comments per issue: 0.0
Past year average comments per pull request: 1.5
Past year merged pull request: 2
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/powsybl/powsybl-tutorials

Top Issue Authors

  • miovd (1)
  • NathanDissoubray (1)
  • OpenSuze (1)
  • yolou (1)
  • agnesLeroy (1)
  • alicecaron (1)

Top Pull Request Authors

  • colinepiloquet (14)
  • mathbagu (10)
  • annetill (10)
  • miovd (9)
  • armic-artelys (4)
  • jonenst (4)
  • agnesLeroy (4)
  • So-Fras (4)
  • geofjamg (3)
  • OpenSuze (2)
  • zamarrenolm (2)
  • AbdelHedhili (1)
  • antoinebhs (1)
  • samirromdhani (1)
  • dependabot[bot] (1)

Top Issue Labels

  • bug (1)

Top Pull Request Labels

  • PR: waiting-for-review (3)
  • PR: ready-to-be-merged (1)
  • PR: next-release (1)
  • PR: do-not-merge (1)
  • dependencies (1)
  • PR: corrected (1)
  • PR: conflict-with-master (1)

Dependencies

cgmes/pom.xml maven
  • com.powsybl:powsybl-cgmes-conversion
  • com.powsybl:powsybl-config-classic
  • com.powsybl:powsybl-iidm-impl
  • com.powsybl:powsybl-open-loadflow
  • com.powsybl:powsybl-triple-store-impl-rdf4j
  • org.slf4j:log4j-over-slf4j
  • org.slf4j:slf4j-simple
count-network-lines/pom.xml maven
  • com.google.auto.service:auto-service
  • com.powsybl:powsybl-iidm-converter-api
  • com.powsybl:powsybl-tools
csv-exporter/pom.xml maven
  • com.google.auto.service:auto-service
  • com.powsybl:powsybl-iidm-converter-api
  • com.powsybl:powsybl-iidm-impl
  • com.powsybl:powsybl-iidm-test
  • org.slf4j:slf4j-simple
csv-importer/pom.xml maven
  • com.google.auto.service:auto-service
  • com.powsybl:powsybl-iidm-converter-api
  • com.powsybl:powsybl-iidm-impl
  • net.sourceforge.javacsv:javacsv ${javacsv.version}
  • org.slf4j:slf4j-simple
downscaling/complete/pom.xml maven
  • com.powsybl:powsybl-metrix-mapping 1.0.0-SNAPSHOT compile
  • com.powsybl:powsybl-cgmes-conversion 4.0.0
  • com.powsybl:powsybl-config-classic 4.0.0
  • com.powsybl:powsybl-iidm-api 4.0.0
  • com.powsybl:powsybl-iidm-converter-api 4.0.0
  • com.powsybl:powsybl-iidm-impl 4.0.0
  • com.powsybl:powsybl-time-series-api 4.0.0
  • com.powsybl:powsybl-triple-store-impl-rdf4j 4.0.0
  • org.slf4j:slf4j-simple 1.7.22
emf/pom.xml maven
  • com.powsybl:powsybl-action-util
  • com.powsybl:powsybl-balances-adjustment
  • com.powsybl:powsybl-cgmes-conversion
  • com.powsybl:powsybl-cgmes-extensions
  • com.powsybl:powsybl-commons
  • com.powsybl:powsybl-config-classic
  • com.powsybl:powsybl-entsoe-cgmes-balances-adjustment
  • com.powsybl:powsybl-iidm-converter-api
  • com.powsybl:powsybl-iidm-impl
  • com.powsybl:powsybl-iidm-mergingview
  • com.powsybl:powsybl-open-loadflow
  • com.powsybl:powsybl-triple-store-impl-rdf4j
  • org.slf4j:log4j-over-slf4j
  • org.slf4j:slf4j-api
  • org.slf4j:slf4j-simple
itools-packager/pom.xml maven
  • ch.qos.logback:logback-classic
  • com.powsybl:powsybl-computation-local
  • com.powsybl:powsybl-config-classic
  • com.powsybl:powsybl-tools
loadflow/pom.xml maven
  • com.powsybl:powsybl-config-classic
  • com.powsybl:powsybl-iidm-api
  • com.powsybl:powsybl-iidm-impl
  • com.powsybl:powsybl-open-loadflow
  • org.slf4j:slf4j-simple
pom.xml maven
  • com.powsybl:powsybl-dependencies 1.2.1 import
sensitivity/pom.xml maven
  • com.powsybl:powsybl-config-classic
  • com.powsybl:powsybl-iidm-api
  • com.powsybl:powsybl-iidm-impl
  • com.powsybl:powsybl-open-loadflow
  • org.slf4j:slf4j-simple
topology/pom.xml maven
  • com.powsybl:powsybl-iidm-impl
  • org.slf4j:slf4j-simple
.github/workflows/maven.yml actions
  • actions/checkout v1 composite
  • actions/setup-java v1 composite
sld-custom-node/pom.xml maven
  • com.powsybl:powsybl-config-classic
  • com.powsybl:powsybl-iidm-api
  • com.powsybl:powsybl-iidm-impl
  • com.powsybl:powsybl-single-line-diagram-core
  • org.slf4j:slf4j-simple
downscaling/initial/pom.xml maven
merging/pom.xml maven
  • com.powsybl:powsybl-cgmes-conversion
  • com.powsybl:powsybl-config-classic
  • com.powsybl:powsybl-iidm-impl
  • com.powsybl:powsybl-iidm-xml-converter
  • com.powsybl:powsybl-loadflow-api
  • com.powsybl:powsybl-open-loadflow
  • com.powsybl:powsybl-triple-store-impl-rdf4j
  • org.slf4j:slf4j-simple

Score: 6.240275845170769