pypowsybl.network.Network.get_busbar_sections#

Network.get_busbar_sections(all_attributes=False, attributes=None, **kwargs)[source]#

Get a dataframe of busbar sections.

Parameters:
  • all_attributes (bool) – flag for including all attributes in the dataframe, default is false

  • attributes (Optional[List[str]]) – attributes to include in the dataframe. The 2 parameters are mutually exclusive. If no parameter is specified, the dataframe will include the default attributes.

  • kwargs (Union[_SupportsArray[dtype[Any]], _NestedSequence[_SupportsArray[dtype[Any]]], bool, int, float, complex, str, bytes, _NestedSequence[Union[bool, int, float, complex, str, bytes]]]) – the data to be selected, as named arguments.

Returns:

A dataframe of busbar sections.

Return type:

DataFrame

Notes

The resulting dataframe, depending on the parameters, will include the following columns:

  • fictitious (optional): True if the busbar section is part of the model and not of the actual network

  • v: The voltage magnitude of the busbar section (in kV)

  • angle: the voltage angle of the busbar section (in degree)

  • voltage_level_id: at which substation the busbar section is connected

  • bus_id: bus this busbar section belongs to

  • bus_breaker_bus_id (optional): bus of the bus-breaker view this busbar section belongs to

  • node (optional): node associated to the this busbar section, in node-breaker voltage levels

  • connected: True if the busbar section is connected to a bus

This dataframe is indexed by the id of the busbar sections

Examples

net = pp.network.create_four_substations_node_breaker_network()
net.get_busbar_sections()

will output something like:

fictitious

v

angle

voltage_level_id

connected

id

S1VL1_BBS

False

224.6139

2.2822

S1VL1

True

S1VL2_BBS1

False

400.0000

0.0000

S1VL2

True

S1VL2_BBS2

False

400.0000

0.0000

S1VL2

True

S2VL1_BBS

False

408.8470

0.7347

S2VL1

True

S3VL1_BBS

False

400.0000

0.0000

S3VL1

True

S4VL1_BBS

False

400.0000

-1.1259

S4VL1

True

net = pp.network.create_four_substations_node_breaker_network()
net.get_busbar_sections(all_attributes=True)

will output something like:

fictitious

v

angle

voltage_level_id

connected

id

S1VL1_BBS

False

224.6139

2.2822

S1VL1

True

S1VL2_BBS1

False

400.0000

0.0000

S1VL2

True

S1VL2_BBS2

False

400.0000

0.0000

S1VL2

True

S2VL1_BBS

False

408.8470

0.7347

S2VL1

True

S3VL1_BBS

False

400.0000

0.0000

S3VL1

True

S4VL1_BBS

False

400.0000

-1.1259

S4VL1

True

net = pp.network.create_four_substations_node_breaker_network()
net.get_busbar_sections(attributes=['v','angle','voltage_level_id','connected'])

will output something like:

v

angle

voltage_level_id

connected

id

S1VL1_BBS

224.6139

2.2822

S1VL1

True

S1VL2_BBS1

400.0000

0.0000

S1VL2

True

S1VL2_BBS2

400.0000

0.0000

S1VL2

True

S2VL1_BBS

408.8470

0.7347

S2VL1

True

S3VL1_BBS

400.0000

0.0000

S3VL1

True

S4VL1_BBS

400.0000

-1.1259

S4VL1

True