pypowsybl.network.create_line_bays#

create_line_bays(network, df=None, raise_exception=True, reporter=None, report_node=None, **kwargs)[source]#

Creates a line and connects it to buses or busbar sections through standard feeder bays.

In node/breaker topology, the created bays are composed of one breaker, and one disconnector for each busbar section parallel to the section specified in arguments. Only the disconnector on the specified section is closed, others are left open. In bus/breaker topology, the line is connected to the bus.

Parameters:
  • network (Network) – the network to which we want to add the new line

  • df (DataFrame | None) – Attributes as a dataframe.

  • raise_exception (bool) – optionally, whether the calculation should throw exceptions. In any case, errors will be logged. Default is True.

  • reporter (ReportNode | None) – deprecated, use report_node instead

  • report_node (ReportNode | None) – optionally, the reporter to be used to create an execution report, default is None (no report).

  • kwargs (_SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | bool | int | float | complex | str | bytes | _NestedSequence[bool | int | float | complex | str | bytes]) – Attributes as keyword arguments.

Return type:

None

Notes

The input dataframe expects same attributes as Network.create_lines(), except for the additional following attributes:

  • bus_or_busbar_section_id_1: the identifier of the bus or of the busbar section on side 1

  • position_order_1: in node/breaker, the position of the line on side 1

  • direction_1: optionally, in node/breaker, the direction, TOP or BOTTOM, of the line on side 1

  • bus_or_busbar_section_id_2: the identifier of the bus or of the busbar section on side 2

  • position_order_2: in node/breaker, the position of the line on side 2

  • direction_2: optionally, in node/breaker, the direction, TOP or BOTTOM, of the line on side 2

Examples

pp.network.create_line_bays(network, id='L', r=0.1, x=10, g1=0, b1=0, g2=0, b2=0,
                            bus_or_busbar_section_id_1='BBS1',
                            position_order_1=115,
                            direction_1='TOP',
                            bus_or_busbar_section_id_2='BBS2',
                            position_order_2=121,
                            direction_2='BOTTOM')