pypowsybl.network.Network.get_dangling_lines#

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

Get a dataframe of dangling lines.

Parameters:

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

  • attributes (List[str] | None) – 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 (_SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | bool | int | float | complex | str | bytes | _NestedSequence[bool | int | float | complex | str | bytes]) – the data to be selected, as named arguments.

Returns:

A dataframe of dangling lines.

Return type:

DataFrame

Notes

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

  • r: The resistance of the dangling line (Ohm)

  • x: The reactance of the dangling line (Ohm)

  • g: the conductance of dangling line (in Siemens)

  • b: the susceptance of dangling line (in Siemens)

  • p0: The active power setpoint

  • q0: The reactive power setpoint

  • p: active flow on the dangling line, NaN if no loadflow has been computed (in MW)

  • q: the reactive flow on the dangling line, NaN if no loadflow has been computed (in MVAr)

  • i: The current on the dangling line, NaN if no loadflow has been computed (in A)

  • boundary_p (optional): active flow on the dangling line at boundary bus side, NaN if no loadflow has been computed (in MW)

  • boundary_q (optional): reactive flow on the dangling line at boundary bus side, NaN if no loadflow has been computed (in MW)

  • boundary_v_mag (optional): voltage magnitude of the boundary bus, NaN if no loadflow has been computed (in kV)

  • boundary_v_angle (optional): voltage angle of the boundary bus, NaN if no loadflow has been computed (in degree)

  • voltage_level_id: at which substation the dangling line is connected

  • bus_id: bus where this line is connected

  • bus_breaker_bus_id (optional): bus of the bus-breaker view where this line is connected

  • node (optional): node where this line is connected, in node-breaker voltage levels

  • connected: True if the dangling line is connected to a bus

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

  • pairing_key: the pairing key associated to the dangling line, to be used for creating tie lines.

  • ucte-xnode-code: deprecated for pairing key.

  • paired: if the dangling line is paired with a tie line

  • tie_line_id: the ID of the tie line if the dangling line is paired

This dataframe is indexed by the id of the dangling lines

Examples

net = pp.network._create_dangling_lines_network()
net.get_dangling_lines()

will output something like:

r

x

g

b

p0

q0

p

q

i

voltage_level_id

bus_id

connected

id

DL

10.0

1.0

0.0001

0.00001

50.0

30.0

NaN

NaN

NaN

VL

VL_0

True

 
net = pp.network._create_dangling_lines_network()
net.get_dangling_lines(all_attributes=True)

will output something like:

r

x

g

b

p0

q0

p

q

i

voltage_level_id

bus_id

connected

id

DL

10.0

1.0

0.0001

0.00001

50.0

30.0

NaN

NaN

NaN

VL

VL_0

True

 
net = pp.network._create_dangling_lines_network()
net.get_dangling_lines(attributes=['p','q','i','voltage_level_id','bus_id','connected'])

will output something like:

p

q

i

voltage_level_id

bus_id

connected

id

DL

NaN

NaN

NaN

VL

VL_0

True