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

Creates a coupling device on the network between two busbar sections of a same voltage level.

  • network (Network) – the network in which the busbar sections are.

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

  • raise_exception (bool) – an optional boolean indicating if an exception should be raised in case an error occurs during

  • default (computation. By) –

  • true.

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

  • report_node (ReportNode | None) – an optional reporter to store the funtional logs.

  • 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:



The voltage level containing the busbar sections can be described in node/breaker or bus/breaker topology. In node/breaker topology, a closed breaker will be created as well as a closed disconnector on both given busbar sections to connect them. If the topology extensions are present on the busbar sections then on every parallel busbar section, an open disconnectors will be created to connect them to the breaker. If the two given busbar sections are the only two parallel busbar sections, and they have the same section index then, only two closed disconnectors will be created. In bus/breaker topology, a closed breaker will be created between two buses.

The input dataframe expects these attributes:

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

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

  • switch_prefix_id: an optional prefix for all the switches

                network, bus_or_busbar_section_id_1='BBS1', bus_or_busbar_section_id_2='BBS2',