pypowsybl.network.BusBreakerTopology#

class BusBreakerTopology(network_handle, voltage_level_id)[source]#

Bus-breaker representation of the topology of a voltage level.

The topology is actually represented as a graph, where vertices are buses while edges are switches (breakers and disconnectors).

For each element of the voltage level, we also provide the bus breaker bus where it is connected.

Parameters:
  • network_handle (pypowsybl._pypowsybl.JavaHandle) –

  • voltage_level_id (str) –

create_graph()[source]#

Representation of the topology as a networkx graph.

Return type:

Graph

property buses: DataFrame#

The list of buses of the bus breaker view, as a dataframe.

The dataframe includes the following columns:

  • name: Name of the bus breaker view bus

  • bus_id: id of the corresponding bus in the bus view.

This dataframe is indexed by the id of the bus breaker view bus.

property elements: DataFrame#

The list of elements (lines, generators…) of this voltage level, together with the bus of the bus breaker view where they are connected.

The dataframe includes the following columns:

  • type: Type of the connected element (GENERATOR, LINE, …)

  • bus_id: bus id of the bus breaker view

  • side: Side of the connected element

This dataframe is indexed by the id of the connected elements.

property switches: DataFrame#

The list of switches of the bus breaker view, together with their connection status, as a dataframe.

The dataframe includes the following columns:

  • kind: Switch kind (BREAKER, DISCONNECTOR, …)

  • open: True if the switch is opened

  • bus1_id: node where the switch is connected at side 1

  • bus2_id: node where the switch is connected at side 2

This dataframe is indexed by the id of the switches.