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')
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')
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()
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)
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)
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)
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:
>>> 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_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)
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.
>>> n.get_extension('substationPosition')
latitude longitude
id
87f7002b-056f-4a6a-a872-1744eea757e3 51.3251 4.25926
37e14a0f-5e34-4647-a062-8bfd9305fa9d 50.8038 4.30089
>>> n.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
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
When we generate a network area diagram, an automatic force layout is performed by default. The diagram looks like this:
>>> n.write_network_area_diagram('be.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)
>>> n.write_network_area_diagram('be.svg', nad_parameters=parameter)
