pypowsybl.network.create_2_windings_transformer_bays#

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

Creates a transformer 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 transformer is simply connected to the buses.

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_2_windings_transformers(), 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 topology, the position of the transformer on side 1

  • direction_1: optionally, in node/breaker, the direction, TOP or BOTTOM, of the transformer 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 transformer on side 2

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

Examples

pp.network.create_2_windings_transformers_bays(
                network, id='L', b=1e-6, g=1e-6, r=0.5, x=10, rated_u1=400, rated_u2=225,
                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

Network.create_2_windings_transformers()