From 6970bcc4d4a7fffb8476e36d5778e114ed58a98e Mon Sep 17 00:00:00 2001 From: Tiphaine Mouminous Date: Mon, 24 Jun 2024 15:06:23 +0200 Subject: [PATCH 1/3] add Sld parameters in doc Signed-off-by: Tiphaine Mouminous --- .../images/ieee14_SldParam_centername.svg | 364 +++++++++ .../ieee14_SldParam_complib_flatdesign.svg | 350 +++++++++ .../images/ieee14_SldParam_default.svg | 364 +++++++++ .../images/ieee14_SldParam_diagonallabel.svg | 364 +++++++++ .../images/ieee14_SldParam_nodesinfos.svg | 371 +++++++++ .../ieee14_SldParam_tooltipenabledtrue.png | Bin 0 -> 13352 bytes ...ee14_SldParam_topologicalcoloringfalse.svg | 635 ++++++++++++++++ ...eee14_SldParam_topologicalcoloringtrue.svg | 704 ++++++++++++++++++ .../images/ieee14_SldParam_usename.svg | 364 +++++++++ docs/user_guide/network_visualization.rst | 101 +++ 10 files changed, 3617 insertions(+) create mode 100644 docs/_static/images/ieee14_SldParam_centername.svg create mode 100644 docs/_static/images/ieee14_SldParam_complib_flatdesign.svg create mode 100644 docs/_static/images/ieee14_SldParam_default.svg create mode 100644 docs/_static/images/ieee14_SldParam_diagonallabel.svg create mode 100644 docs/_static/images/ieee14_SldParam_nodesinfos.svg create mode 100644 docs/_static/images/ieee14_SldParam_tooltipenabledtrue.png create mode 100644 docs/_static/images/ieee14_SldParam_topologicalcoloringfalse.svg create mode 100644 docs/_static/images/ieee14_SldParam_topologicalcoloringtrue.svg create mode 100644 docs/_static/images/ieee14_SldParam_usename.svg diff --git a/docs/_static/images/ieee14_SldParam_centername.svg b/docs/_static/images/ieee14_SldParam_centername.svg new file mode 100644 index 0000000000..2241860614 --- /dev/null +++ b/docs/_static/images/ieee14_SldParam_centername.svg @@ -0,0 +1,364 @@ + + + + + + + + B4 + + + + + + + + + + + + + + + 48 + + + + + -4 + + + + + + + + + + + + + + + B4-L + + + + + + + + + + + + + + + + 3 + + + + + -54 + + + + + + + + + + + + L2-4-1 + + + + + + + + + + + + + + + + 24 + + + + + -5 + + + + + + + + + + + + L3-4-1 + + + + + + + + + + + + + + + + 16 + + + + + -61 + + + + + + + + + + + + L4-5-1 + + + + + + + + + + + + + + + + 28 + + + + + -10 + + + + + + + + + + + + + + T4-7-1 + + + + + + + + + + + + + + + + -0 + + + + + 16 + + + + + + + + + + + + + + T4-9-1 + + + + diff --git a/docs/_static/images/ieee14_SldParam_complib_flatdesign.svg b/docs/_static/images/ieee14_SldParam_complib_flatdesign.svg new file mode 100644 index 0000000000..a6a239f0b6 --- /dev/null +++ b/docs/_static/images/ieee14_SldParam_complib_flatdesign.svg @@ -0,0 +1,350 @@ + + + + + + + + B4 + + + + + + + + + + + + + + + 48 + + + + + -4 + + + + + + + + + + + + + B4-L + + + + + + + + + + + + + + + + 3 + + + + + -54 + + + + + + + + + + + + L2-4-1 + + + + + + + + + + + + + + + + 24 + + + + + -5 + + + + + + + + + + + + L3-4-1 + + + + + + + + + + + + + + + + 16 + + + + + -61 + + + + + + + + + + + + L4-5-1 + + + + + + + + + + + + + + + + 28 + + + + + -10 + + + + + + + + + + + + + + T4-7-1 + + + + + + + + + + + + + + + + -0 + + + + + 16 + + + + + + + + + + + + + + T4-9-1 + + + + diff --git a/docs/_static/images/ieee14_SldParam_default.svg b/docs/_static/images/ieee14_SldParam_default.svg new file mode 100644 index 0000000000..318bff2078 --- /dev/null +++ b/docs/_static/images/ieee14_SldParam_default.svg @@ -0,0 +1,364 @@ + + + + + + + + B4 + + + + + + + + + + + + + + + 48 + + + + + -4 + + + + + + + + + + + + + + + B4-L + + + + + + + + + + + + + + + + 3 + + + + + -54 + + + + + + + + + + + + L2-4-1 + + + + + + + + + + + + + + + + 24 + + + + + -5 + + + + + + + + + + + + L3-4-1 + + + + + + + + + + + + + + + + 16 + + + + + -61 + + + + + + + + + + + + L4-5-1 + + + + + + + + + + + + + + + + 28 + + + + + -10 + + + + + + + + + + + + + + T4-7-1 + + + + + + + + + + + + + + + + -0 + + + + + 16 + + + + + + + + + + + + + + T4-9-1 + + + + diff --git a/docs/_static/images/ieee14_SldParam_diagonallabel.svg b/docs/_static/images/ieee14_SldParam_diagonallabel.svg new file mode 100644 index 0000000000..7917bd9979 --- /dev/null +++ b/docs/_static/images/ieee14_SldParam_diagonallabel.svg @@ -0,0 +1,364 @@ + + + + + + + + B4 + + + + + + + + + + + + + + + 48 + + + + + -4 + + + + + + + + + + + + + + + B4-L + + + + + + + + + + + + + + + + 3 + + + + + -54 + + + + + + + + + + + + L2-4-1 + + + + + + + + + + + + + + + + 24 + + + + + -5 + + + + + + + + + + + + L3-4-1 + + + + + + + + + + + + + + + + 16 + + + + + -61 + + + + + + + + + + + + L4-5-1 + + + + + + + + + + + + + + + + 28 + + + + + -10 + + + + + + + + + + + + + + T4-7-1 + + + + + + + + + + + + + + + + -0 + + + + + 16 + + + + + + + + + + + + + + T4-9-1 + + + + diff --git a/docs/_static/images/ieee14_SldParam_nodesinfos.svg b/docs/_static/images/ieee14_SldParam_nodesinfos.svg new file mode 100644 index 0000000000..d66cda4647 --- /dev/null +++ b/docs/_static/images/ieee14_SldParam_nodesinfos.svg @@ -0,0 +1,371 @@ + + + + + + + + B4 + + + + + + + + + + + + + + + 48 + + + + + -4 + + + + + + + + + + + + + + + B4-L + + + + + + + + + + + + + + + + 3 + + + + + -54 + + + + + + + + + + + + L2-4-1 + + + + + + + + + + + + + + + + 24 + + + + + -5 + + + + + + + + + + + + L3-4-1 + + + + + + + + + + + + + + + + 16 + + + + + -61 + + + + + + + + + + + + L4-5-1 + + + + + + + + + + + + + + + + 28 + + + + + -10 + + + + + + + + + + + + + + T4-7-1 + + + + + + + + + + + + + + + + -0 + + + + + 16 + + + + + + + + + + + + + + T4-9-1 + + + + + + 137.4 kV + -10.3° + + + + diff --git a/docs/_static/images/ieee14_SldParam_tooltipenabledtrue.png b/docs/_static/images/ieee14_SldParam_tooltipenabledtrue.png new file mode 100644 index 0000000000000000000000000000000000000000..2a99d594fc268076fa64d022e11c6f891d78c6bc GIT binary patch literal 13352 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 MyoOx0jAh9G0(;~pzW@LL literal 0 HcmV?d00001 diff --git a/docs/_static/images/ieee14_SldParam_topologicalcoloringfalse.svg b/docs/_static/images/ieee14_SldParam_topologicalcoloringfalse.svg new file mode 100644 index 0000000000..d264f21e81 --- /dev/null +++ b/docs/_static/images/ieee14_SldParam_topologicalcoloringfalse.svg @@ -0,0 +1,635 @@ + + + + + + + VL4 + + + + B4 + + + + + + + + + + + + + + + 48 + + + + + -4 + + + + + + + + + + + + + + + B4-L + + + + + + + + + + + + + + + + 3 + + + + + -54 + + + + + + + + + + + + L2-4-1 + + + + + + + + + + + + + + + + 24 + + + + + -5 + + + + + + + + + + + + L3-4-1 + + + + + + + + + + + + + + + + 16 + + + + + -61 + + + + + + + + + + + + L4-5-1 + + + + + + + + + + + + + + + + 28 + + + + + -10 + + + + + + + + + + + + T4-7-1 + + + + + + + + + + + + + + + + -0 + + + + + 16 + + + + + + + + + + + + T4-9-1 + + + + VL7 + + + + B7 + + + + + + + + + + + + + + + -28 + + + + + 11 + + + + + + + + + + + + T4-7-1 + + + + + + + + + + + + + + + + -17 + + + + + 0 + + + + + + + + + + + + L7-8-1 + + + + + + + + + + + + + + + + 28 + + + + + 6 + + + + + + + + + + + + L7-9-1 + + + + VL9 + + + + B9 + + + + + + + + + + + + + + + 30 + + + + + 17 + + + + + + + + + + + + + + + B9-L + + + + + + + + + + + + + + + + -21 + + + + + 0 + + + + + + + + + + + + + + + + B9-SH + + + + + + + + + + + + + + + + -16 + + + + + 2 + + + + + + + + + + + + T4-9-1 + + + + + + + + + + + + + + + + -5 + + + + + -28 + + + + + + + + + + + + L7-9-1 + + + + + + + + + + + + + + + + 5 + + + + + 4 + + + + + + + + + + + + L9-10-1 + + + + + + + + + + + + + + + + 4 + + + + + 9 + + + + + + + + + + + + L9-14-1 + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/_static/images/ieee14_SldParam_topologicalcoloringtrue.svg b/docs/_static/images/ieee14_SldParam_topologicalcoloringtrue.svg new file mode 100644 index 0000000000..4117f93723 --- /dev/null +++ b/docs/_static/images/ieee14_SldParam_topologicalcoloringtrue.svg @@ -0,0 +1,704 @@ + + + + + + + VL4 + + + + B4 + + + + + + + + + + + + + + + 48 + + + + + -4 + + + + + + + + + + + + + + + B4-L + + + + + + + + + + + + + + + + 3 + + + + + -54 + + + + + + + + + + + + L2-4-1 + + + + + + + + + + + + + + + + 24 + + + + + -5 + + + + + + + + + + + + L3-4-1 + + + + + + + + + + + + + + + + 16 + + + + + -61 + + + + + + + + + + + + L4-5-1 + + + + + + + + + + + + + + + + 28 + + + + + -10 + + + + + + + + + + + + T4-7-1 + + + + + + + + + + + + + + + + -0 + + + + + 16 + + + + + + + + + + + + T4-9-1 + + + + VL7 + + + + B7 + + + + + + + + + + + + + + + -28 + + + + + 11 + + + + + + + + + + + + T4-7-1 + + + + + + + + + + + + + + + + -17 + + + + + 0 + + + + + + + + + + + + L7-8-1 + + + + + + + + + + + + + + + + 28 + + + + + 6 + + + + + + + + + + + + L7-9-1 + + + + VL9 + + + + B9 + + + + + + + + + + + + + + + 30 + + + + + 17 + + + + + + + + + + + + + + + B9-L + + + + + + + + + + + + + + + + -21 + + + + + 0 + + + + + + + + + + + + + + + + B9-SH + + + + + + + + + + + + + + + + -16 + + + + + 2 + + + + + + + + + + + + T4-9-1 + + + + + + + + + + + + + + + + -5 + + + + + -28 + + + + + + + + + + + + L7-9-1 + + + + + + + + + + + + + + + + 5 + + + + + 4 + + + + + + + + + + + + L9-10-1 + + + + + + + + + + + + + + + + 4 + + + + + 9 + + + + + + + + + + + + L9-14-1 + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/_static/images/ieee14_SldParam_usename.svg b/docs/_static/images/ieee14_SldParam_usename.svg new file mode 100644 index 0000000000..0c319e6136 --- /dev/null +++ b/docs/_static/images/ieee14_SldParam_usename.svg @@ -0,0 +1,364 @@ + + + + + + + + Bus 4 HV + + + + + + + + + + + + + + + 48 + + + + + -4 + + + + + + + + + + + + + + + B4-L + + + + + + + + + + + + + + + + 3 + + + + + -54 + + + + + + + + + + + + L2-4-1 + + + + + + + + + + + + + + + + 24 + + + + + -5 + + + + + + + + + + + + L3-4-1 + + + + + + + + + + + + + + + + 16 + + + + + -61 + + + + + + + + + + + + L4-5-1 + + + + + + + + + + + + + + + + 28 + + + + + -10 + + + + + + + + + + + + + + T4-7-1 + + + + + + + + + + + + + + + + -0 + + + + + 16 + + + + + + + + + + + + + + T4-9-1 + + + + diff --git a/docs/user_guide/network_visualization.rst b/docs/user_guide/network_visualization.rst index 996843999e..48116008c1 100644 --- a/docs/user_guide/network_visualization.rst +++ b/docs/user_guide/network_visualization.rst @@ -28,6 +28,107 @@ Note that a loadflow can be run before writing the diagram so that it displays r .. image:: ../_static/images/ieee14_vl4.svg :class: forced-white-background +Single-line diagrams can be customized through SldParameters: + +.. code-block:: python + + >>> 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 node with a different colour (default value true) + - component_library: choose component library (default value 'Convergence') + +Let's see some examples down below: + +- with default parameters +.. code-block:: python + + >>> import pypowsybl.network as pn + >>> param = pn.SldParameters() #default parameters + >>> network.get_single_line_diagram('VL4', parameters = param) + +.. image:: ../_static/images/ieee14_SldParam_default.svg + :class: forced-white-background + +- with use_name = true +.. code-block:: python + + >>> param = pn.SldParameters(use_name = True) + >>> network.get_single_line_diagram('VL4', parameters = param) + +.. image:: ../_static/images/ieee14_SldParam_usename.svg + :class: forced-white-background + +- with center_name = true +.. code-block:: python + + >>> param = pn.SldParameters(center_name = True) + >>> network.get_single_line_diagram('VL4', parameters = param) + +.. image:: ../_static/images/ieee14_SldParam_centername.svg + :class: forced-white-background + +- with diagonal_label = true +.. code-block:: python + + >>> param = pn.SldParameters(diagonal_label = True) + >>> network.get_single_line_diagram('VL4', parameters = param) + +.. image:: ../_static/images/ieee14_SldParam_diagonallabel.svg + :class: forced-white-background + +- with nodes_infos = true +.. code-block:: python + + >>> param = pn.SldParameters(nodes_infos = True) + >>> network.get_single_line_diagram('VL4', parameters = param) + +.. image:: ../_static/images/ieee14_SldParam_nodesinfos.svg + :class: forced-white-background + +- with tooltip enabled +.. code-block:: python + + >>> param = pn.SldParameters(tooltip_enabled = True) + >>> network.get_single_line_diagram('VL4', parameters = param) + +.. image:: ../_static/images/ieee14_SldParam_tooltipenabledtrue.png + :class: forced-white-background + +- with topological coloring = true (we need to get a whole substation here to see the difference) +.. code-block:: python + + >>> param = pn.SldParameters(topological_coloring = True) + >>> network.get_single_line_diagram('S4', parameters = param) + +.. image:: ../_static/images/ieee14_SldParam_topologicalcoloringtrue.svg + :class: forced-white-background + +- with topological coloring = false +.. code-block:: python + + >>> param = pn.SldParameters(topological_coloring = False) + >>> network.get_single_line_diagram('S4', parameters = param) + +.. image:: ../_static/images/ieee14_SldParam_topologicalcoloringfalse.svg + :class: forced-white-background + +- with component_library = "FlatDesign" +.. code-block:: python + + >>> param = pn.SldParameters(component_library = "FlatDesign") + >>> network.get_single_line_diagram('VL4', parameters = param) + +.. image:: ../_static/images/ieee14_SldParam_complib_flatdesign.svg + :class: forced-white-background + + It is also possible to display a multi-substation single line diagram (currently a beta feature): .. code-block:: python From c8e8af558986c1930f4c5190ef3c1b019eef95e2 Mon Sep 17 00:00:00 2001 From: Tiphaine Mouminous Date: Tue, 25 Jun 2024 11:11:42 +0200 Subject: [PATCH 2/3] correct topological_coloring Signed-off-by: Tiphaine Mouminous --- .../SldParam_topologicalcoloringfalse.svg | 632 ++++++++++++++++ .../SldParam_topologicalcoloringtrue.svg | 701 ++++++++++++++++++ docs/user_guide/network_visualization.rst | 15 +- 3 files changed, 1342 insertions(+), 6 deletions(-) create mode 100644 docs/_static/images/SldParam_topologicalcoloringfalse.svg create mode 100644 docs/_static/images/SldParam_topologicalcoloringtrue.svg diff --git a/docs/_static/images/SldParam_topologicalcoloringfalse.svg b/docs/_static/images/SldParam_topologicalcoloringfalse.svg new file mode 100644 index 0000000000..7f1683feec --- /dev/null +++ b/docs/_static/images/SldParam_topologicalcoloringfalse.svg @@ -0,0 +1,632 @@ + + + + + + + + S1VL2_BBS1 + + + + S1VL2_BBS2 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 5 + + + + + 80 + + + + + + + + + + + + + + + + + + + + + + + + TWT + + + + + + + + + + + + + + + + + + + + + + -421 + + + + + 10 + + + + + + + + + + + + + + + + + + + + + AC / DC - VSC + HVDC1 + + + + + + + + + + + + + + + + + + + + + + -85 + + + + + -681 + + + + + + + + + + + + + + + + + + + + + + + + GH1 + + + + + + + + + + + + + + + + + + + + + + -419 + + + + + -90 + + + + + + + + + + + + + + + + + + + + + + + + GH2 + + + + + + + + + + + + + + + + + + + + + + -155 + + + + + -526 + + + + + + + + + + + + + + + + + + + + + + + + GH3 + + + + + + + + + + + + + + + + + + + + + + 5 + + + + + 60 + + + + + + + + + + + + + + + + + + + + + + + + LD2 + + + + + + + + + + + + + + + + + + + + + + 60 + + + + + 5 + + + + + + + + + + + + + + + + + + + + + + + + LD3 + + + + + + + + + + + + + + + + + + + + + + 5 + + + + + 40 + + + + + + + + + + + + + + + + + + + + + + + + LD4 + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + 1,920 + + + + + + + + + + + + + + + + + + + + + + + + SHUNT + + + + + + + + + + + + + + + + + + + + + + 80 + + + + + 107 + + + + + + + + + + + + + + + + + + + + + AC / DC - LCC + HVDC2 + + + + diff --git a/docs/_static/images/SldParam_topologicalcoloringtrue.svg b/docs/_static/images/SldParam_topologicalcoloringtrue.svg new file mode 100644 index 0000000000..8f3dfd0d92 --- /dev/null +++ b/docs/_static/images/SldParam_topologicalcoloringtrue.svg @@ -0,0 +1,701 @@ + + + + + + + + S1VL2_BBS1 + + + + S1VL2_BBS2 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 5 + + + + + 80 + + + + + + + + + + + + + + + + + + + + + + + + TWT + + + + + + + + + + + + + + + + + + + + + + -421 + + + + + 10 + + + + + + + + + + + + + + + + + + + + + AC / DC - VSC + HVDC1 + + + + + + + + + + + + + + + + + + + + + + -85 + + + + + -681 + + + + + + + + + + + + + + + + + + + + + + + + GH1 + + + + + + + + + + + + + + + + + + + + + + -419 + + + + + -90 + + + + + + + + + + + + + + + + + + + + + + + + GH2 + + + + + + + + + + + + + + + + + + + + + + -155 + + + + + -526 + + + + + + + + + + + + + + + + + + + + + + + + GH3 + + + + + + + + + + + + + + + + + + + + + + 5 + + + + + 60 + + + + + + + + + + + + + + + + + + + + + + + + LD2 + + + + + + + + + + + + + + + + + + + + + + 60 + + + + + 5 + + + + + + + + + + + + + + + + + + + + + + + + LD3 + + + + + + + + + + + + + + + + + + + + + + 5 + + + + + 40 + + + + + + + + + + + + + + + + + + + + + + + + LD4 + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + 1,920 + + + + + + + + + + + + + + + + + + + + + + + + SHUNT + + + + + + + + + + + + + + + + + + + + + + 80 + + + + + 107 + + + + + + + + + + + + + + + + + + + + + AC / DC - LCC + HVDC2 + + + + diff --git a/docs/user_guide/network_visualization.rst b/docs/user_guide/network_visualization.rst index 805c6efffd..ecef8259f1 100644 --- a/docs/user_guide/network_visualization.rst +++ b/docs/user_guide/network_visualization.rst @@ -41,7 +41,7 @@ Single-line diagrams can be customized through SldParameters: - 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 node with a different colour (default value true) + - topological_coloring: if true, set each electrical nodes with a different colour (default value true) - component_library: choose component library (default value 'Convergence') Let's see some examples down below: @@ -101,27 +101,30 @@ Let's see some examples down below: .. image:: ../_static/images/ieee14_SldParam_tooltipenabledtrue.png :class: forced-white-background -- with topological coloring = true (we need to get a whole substation here to see the difference) +- with topological coloring = true (for nodes breaker) .. code-block:: python + >>> 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('S4', parameters = param) + >>> network.get_single_line_diagram('S1VL2', parameters = param) -.. image:: ../_static/images/ieee14_SldParam_topologicalcoloringtrue.svg +.. image:: ../_static/images/SldParam_topologicalcoloringtrue.svg :class: forced-white-background - with topological coloring = false .. code-block:: python >>> param = pn.SldParameters(topological_coloring = False) - >>> network.get_single_line_diagram('S4', parameters = param) + >>> network.get_single_line_diagram('S1VL2', parameters = param) -.. image:: ../_static/images/ieee14_SldParam_topologicalcoloringfalse.svg +.. image:: ../_static/images/SldParam_topologicalcoloringfalse.svg :class: forced-white-background - with component_library = "FlatDesign" .. code-block:: python + >>> #network = pn.create_ieee14() >>> param = pn.SldParameters(component_library = "FlatDesign") >>> network.get_single_line_diagram('VL4', parameters = param) From 3b31e52f88f4e37c767c51b4f5232dd444ec135a Mon Sep 17 00:00:00 2001 From: Tiphaine Mouminous Date: Tue, 25 Jun 2024 12:37:49 +0200 Subject: [PATCH 3/3] final changes Signed-off-by: Tiphaine Mouminous --- docs/user_guide/network_visualization.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/user_guide/network_visualization.rst b/docs/user_guide/network_visualization.rst index ecef8259f1..31ac1ef907 100644 --- a/docs/user_guide/network_visualization.rst +++ b/docs/user_guide/network_visualization.rst @@ -101,7 +101,7 @@ Let's see some examples down below: .. image:: ../_static/images/ieee14_SldParam_tooltipenabledtrue.png :class: forced-white-background -- with topological coloring = true (for nodes breaker) +- with topological coloring = true .. code-block:: python >>> network = pn.create_four_substations_node_breaker_network() @@ -124,7 +124,7 @@ Let's see some examples down below: - with component_library = "FlatDesign" .. code-block:: python - >>> #network = pn.create_ieee14() + >>> network = pn.create_ieee14() >>> param = pn.SldParameters(component_library = "FlatDesign") >>> network.get_single_line_diagram('VL4', parameters = param)