/powsybl-diagram

SVG diagrams generation: single-line substation diagrams and network graph diagrams

Primary LanguageJavaMozilla Public License 2.0MPL-2.0

PowSyBl Diagram

Actions Status Coverage Status Quality Gate MPL-2.0 License Slack

PowSyBl diagram allows users to generate customizable network graph diagrams (denominated network-area diagrams in PowSyBl) and single-line diagrams in SVG format files.

Diagrams available

PowSyBl framework

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.

PowSyBl Logo

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-tsc@lists.lfenergy.org.

PowSyBl Network Area Diagram

PowSyBl Network Area Diagram is a component built on top of the Network model available in the PowSyBl Core repository responsible for generating a concise diagram of the whole network or of a part of the network, showing in particular the interconnections between the different voltage levels. A network area diagram emphasizes the electrical structure of the network, and may differ substantially from the network physical geography. It displays a graph whose nodes are the network voltage levels, and whose edges are the lines and transformers between those voltage levels.

The main features are:

  • SVG diagram to be used in various front-end technologies.
  • Highly customizable rendering using CSS and configurable labels.
  • Built-in force-layout to place the voltage level nodes.
  • Displaying electrical nodes within a voltage level as concentric rings, and voltage / angle values for each electrical node is displayed by default.
  • Displaying lines, two- and three-winding transformers, converter stations and dangling lines with separate designs.
  • Displaying active (visible by default) or reactive (hidden by default) powers on each edge.

PowSyBl Single Line Diagram

PowSyBl Single Line Diagram is a component built on top of the Network model available in the PowSyBl Core repository responsible for generating a single line diagram.

The main features are:

  • Node/Breaker and Bus/Breaker topology.
  • SVG diagram to be used in various front-end technologies.
  • Voltage level, substation and zone diagrams.
  • Highly customizable rendering using equipment component libraries, CSS and configurable labels (position and content).
  • Multiple layout modes: fully automatic, semi-automatic (using relative positions for busbar sections and feeders), CGMES DL.

Getting started with PowSyBl diagram

  • Have a look at the tutorials presented here:

    • Discover network-area diagrams by generating SVG files from a test network here
    • Get your hands dirty by generating your first single-line diagrams here
    • Learn how to customize your single-line diagram here
  • Pop in the API guide page to get more examples on how to use PowSyBl diagrams!