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')
See also