Network visualization#

Single line diagram#

To create a single line diagram in SVG format from a substation or a voltage level:

>>> network = pp.network.create_ieee14()
>>> network.write_single_line_diagram_svg('VL4', 'vl4.svg')

Or in a Jupyter notebook, the SVG can be directly rendered in the notebook:

>>> network.get_single_line_diagram('VL4')

Note that a loadflow can be run before writing the diagram so that it displays reactive and active powers:

>>> network = pp.network.create_ieee14()
>>> result = pp.loadflow.run_ac(network)
>>> network.write_single_line_diagram_svg('VL4', 'vl4.svg')
../_images/ieee14_vl4.svg

Single-line diagrams can be customized through SldParameters:

>>> network = pp.network.create_ieee14()
>>> result = pp.loadflow.run_ac(network)
>>> network.get_single_line_diagram('VL4',parameters = pp.network.SldParameters(use_name = False, center_name = False, diagonal_label = False, nodes_infos = False, tooltip_enabled = False, topological_coloring = True, component_library = 'Convergence'))

  • use_name: if true, display components names instead of their id (default value false)

  • center_name: if true, center the names of feeders (default value false)

  • diagonal_label: if true, display labels diagonally (default value false)

  • nodes_infos: if true, display nodes infos (caption on bottom left) (default value false)

  • tooltip_enabled: if true, display the name of the component pointed by the cursor (default value false)

  • topological_coloring: if true, set each electrical nodes with a different colour (default value true)

  • component_library: choose component library (default value ‘Convergence’)

  • active_power_unit: display unit of active power (default value “”)

  • reactive_power_unit: display unit of reactive power (default value “”)

  • current_unit: display unit of current (default value “”)

  • display_current_feeder_info: if true, display current feeder value (default value False)

Let’s see some examples down below:

  • with default parameters

>>> import pypowsybl.network as pn
>>> param = pn.SldParameters() #default parameters
>>> network.get_single_line_diagram('VL4', parameters = param)
../_images/ieee14_SldParam_default.svg

  • with use_name = True

>>> param = pn.SldParameters(use_name = True)
>>> network.get_single_line_diagram('VL4', parameters = param)
../_images/ieee14_SldParam_usename.svg

  • with center_name = True

>>> param = pn.SldParameters(center_name = True)
>>> network.get_single_line_diagram('VL4', parameters = param)
../_images/ieee14_SldParam_centername.svg

  • with diagonal_label = True

>>> param = pn.SldParameters(diagonal_label = True)
>>> network.get_single_line_diagram('VL4', parameters = param)
../_images/ieee14_SldParam_diagonallabel.svg

  • with nodes_infos = True

>>> param = pn.SldParameters(nodes_infos = True)
>>> network.get_single_line_diagram('VL4', parameters = param)
../_images/ieee14_SldParam_nodesinfos.svg

  • with tooltip_enabled = True

>>> param = pn.SldParameters(tooltip_enabled = True)
>>> network.get_single_line_diagram('VL4', parameters = param)
../_images/ieee14_SldParam_tooltipenabledtrue.png

  • with topological_coloring = True

>>> network = pn.create_four_substations_node_breaker_network()
>>> network.update_switches(id="S1VL2_COUPLER",open=True)
>>> param = pn.SldParameters(topological_coloring = True)
>>> network.get_single_line_diagram('S1VL2', parameters = param)
../_images/SldParam_topologicalcoloringtrue.svg

  • with topological_coloring = False

>>> param = pn.SldParameters(topological_coloring = False)
>>> network.get_single_line_diagram('S1VL2', parameters = param)
../_images/SldParam_topologicalcoloringfalse.svg

  • with component_library = “FlatDesign”

>>> network = pn.create_ieee14()
>>> param = pn.SldParameters(component_library = "FlatDesign")
>>> network.get_single_line_diagram('VL4', parameters = param)
../_images/ieee14_SldParam_complib_flatdesign.svg

  • with display_current_feeder_info = True

>>> param = pn.SldParameters(display_current_feeder_info = True)
>>> network.get_single_line_diagram('VL4', parameters = param)
../_images/ieee14_SldParam_displaycurrentfeederinfo.svg

  • with active_power_unit = “MW”

>>> param = pn.SldParameters(active_power_unit = "MW")
>>> network.get_single_line_diagram('VL4', parameters = param)
../_images/ieee14_SldParam_activepowerunit.svg

  • with reactive_power_unit = “MVAR”

>>> param = pn.SldParameters(reactive_power_unit = "MVAR")
>>> network.get_single_line_diagram('VL4', parameters = param)
../_images/ieee14_SldParam_reactivepowerunit.svg

  • with current_unit = “A”

>>> param = pn.SldParameters(display_current_feeder_info = True, current_unit = "A")
>>> network.get_single_line_diagram('VL4', parameters = param)
../_images/ieee14_SldParam_currentunit.svg

It is also possible to display a multi-substation single line diagram (currently a beta feature):

>>> network = pp.network.create_ieee14()
>>> result = pp.loadflow.run_ac(network)
>>> network.write_matrix_multi_substation_single_line_diagram_svg([['S1', 'S2'],['S3','S4']], 's1_s2_s3_s4.svg')
../_images/ieee14_s1_s2_s3_s4.svg

Or in a Jupyter Notebook:

>>> network.get_matrix_multi_substation_single_line_diagram([['S1', 'S2'],['S3','S4']])

The substation diagrams will be arranged in a grid, based on the content of the matrix parameter. An empty string in the matrix will result in an empty spot in the grid.

Network area diagram#

To create a network area diagram in SVG format for the full network:

>>> network = pp.network.create_ieee9()
>>> network.write_network_area_diagram_svg('ieee9.svg')

Or in a Jupyter notebook, the SVG can be directly rendered in the notebook:

>>> network.get_network_area_diagram()
../_images/ieee9.svg

To render only a part of the network, we can specify a voltage level ID as the center of the sub network and a depth to control the size of the sub network:

>>> network = pp.network.create_ieee300()
>>> network.write_network_area_diagram_svg('ieee300.svg', 'VL1', 1)
../_images/ieee300_subnetwork_vl1.svg

Nominal voltage bounds can be defined to further filter the output network:

>>> network = pp.network.create_ieee300()
>>> network.write_network_area_diagram_svg('ieee300.svg', 'VL1', 1, low_nominal_voltage_bound=90, high_nominal_voltage_bound=240)
../_images/ieee300_subnetwork_vl1_filtered.svg

If no voltage level ID is given as an input, only nominal voltage bounds are used to filter the network:

>>> network = pp.network.create_ieee30()
>>> network.write_network_area_diagram_svg('ieee30.svg', low_nominal_voltage_bound=90, high_nominal_voltage_bound=240)
../_images/ieee30_subnetwork_filtered_no_vl_id.svg

Note that similarly to single-line diagrams, a loadflow can be run before writing the diagram so that it displays active powers, for instance:

>>> network = pp.network.create_ieee9()
>>> result = pp.loadflow.run_ac(network)
>>> network.write_network_area_diagram_svg('ieee9.svg')

Network-area diagrams can be customized through NadParameters:

>>> from pypowsybl.network import NadParameters
>>> network = pp.network.create_ieee14()
>>> nad = network.get_network_area_diagram('VL6', nad_parameters=NadParameters(edge_name_displayed=True, id_displayed=True, edge_info_along_edge=False, power_value_precision=1, angle_value_precision=0, current_value_precision=1, voltage_value_precision=0, bus_legend=False, substation_description_displayed=True, edge_info_displayed=EdgeInfoType.REACTIVE_POWER))

- edge_name_displayed: if true, names along lines and transformer legs are displayed (default value false)
- id_displayed: if true, the equipment ids are displayed. If false, the equipment names are displayed (if a name is null, then the id is displayed) (default value false)
- edge_info_along_edge: if true, the edge information (P or Q values for example) is displayed alongside the edge. If false, the edge information is displayed perpendicularly to the edge (default value true)
- power_value_precision: number of digits after the decimal point for power values (default value 0)
- angle_value_precision: number of digits after the decimal point for angle values (default value 1)
- current_value_precision: number of digits after the decimal point for current values (default value 0)
- voltage_value_precision: number of digits after the decimal point for voltage values(default value 1)
- bus_legend: if true, angle and voltage values associated to a voltage level are displayed in a text box. If false, only the voltage level name is displayed (default value true)
- substation_description_displayed: if true, the substation name is added to the voltage level info on the diagram (default value false)
- edge_info_displayed: type of info displayed (EdgeInfoType.ACTIVE_POWER(default),EdgeInfoType.REACTIVE_POWER or EdgeInfoType.CURRENT)

In order to get a list of the displayed voltage levels from an input voltage level (or an input list of voltage levels) and a depth:

>>> network = pp.network.create_ieee300()
>>> list_vl = network.get_network_area_diagram_displayed_voltage_levels('VL1', 1)

Network area diagram using geographical data#

We can load a network with geographical data (in WGS84 coordinates system) for substations and lines (in that case, the geographical positions represent the line path). One way to do that is to load a CGMES file containing a GL profile (Graphical Layout). By default this profile is not read. To activate GL profile loading and creation of substations ans lines geographical positions in the PowSyBl network model we have to pass an additional parameter to the load function.

>>> network = pp.network.load('MicroGridTestConfiguration_T4_BE_BB_Complete_v2.zip', {'iidm.import.cgmes.post-processors': 'cgmesGLImport'})

We can now check loaded position by displaying SubstationPosition and LinePosition extensions.

>>> network.get_extension('substationPosition')
                                  latitude  longitude
id
87f7002b-056f-4a6a-a872-1744eea757e3   51.3251    4.25926
37e14a0f-5e34-4647-a062-8bfd9305fa9d   50.8038    4.30089

>>> network.get_extension('linePosition')
                                      latitude  longitude
id                                   num
b58bf21a-096a-4dae-9a01-3f03b60c24c7 0     50.8035    4.30113
                                     1     50.9169    4.34509
                                     2     51.0448    4.29565
                                     3     51.1570    4.38354
                                     4     51.3251    4.25926
ffbabc27-1ccd-4fdc-b037-e341706c8d29 0     50.8035    4.30113
                                     1     50.9169    4.34509
                                     2     51.0448    4.29565
                                     3     51.1570    4.38354
                                     4     51.3251    4.25926

When we generate a network area diagram, an automatic force layout is performed by default. The diagram looks like this:

>>> network.write_network_area_diagram('be.svg')
../_images/nad_microgridbe_force_layout.svg

Now that we have geographical positions in our data model, we can change the layout to render the diagram with the geographical layout:

>>> parameter = pp.network.NadParameters(layout_type=pp.network.NadLayoutType.GEOGRAPHICAL)
>>> network.write_network_area_diagram('be.svg', nad_parameters=parameter)
../_images/nad_microgridbe_geo.svg

Display diagrams using Jupyter widgets#

You can also display diagrams through Jupyter widgets.

Get a handle on Jupyter widgets#

You can use the explorer to check the example notebooks given in the pypowsybl-jupyter repository:

pip install pypowsybl_jupyter
jupyter lab

The network_explorer features three tabs:

  • A tab for network-area diagrams;

  • A tab for single-line diagrams;

  • A tab for a map viewer.

Explore the network_explorer tabs#

  • The network-area diagram tab

../_images/explorer_nad.png

The network-area diagram tab displays the network-area diagram of the selected voltage level in the left column at the desired depth. The depth is user-defined, thanks to the slide button above the display zone.

../_images/explorer_slide_button.png

  • The single-line diagram tab

../_images/explorer_sld.png

The single-line diagram tab displays the single-line diagram of the selected voltage level in the left column. You can navigate from voltage level to voltage level using the circled arrows.

../_images/explorer_navigate.png

  • The map viewer tab

../_images/explorer_map.png

The map viewer tab displays a geographical representation of the network with a background map. The vertices of the graph are substations and the edges are lines, tie lines or HVDC lines. Voltage levels are represented as concentric circles inside a substation:

../_images/explorer_map_substation.png

Selecting a voltage level on the left column will center the map on the corresponding substation.

Users can filter the displayed voltage levels through a nominal voltage filter. By default, only higher nominal voltages are selected.

Please note that if no geographical extensions are available for substations, the tab will be blank.

../_images/explorer_map_blank.png

Go further#

Check the complete documentation available on the widgets here.