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_i (optional): current on the dangling line at boundary bus side, NaN if no loadflow has been computed (in A)

  • 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

Note

This note applies only if you are using the per-unit mode in your network (i.e., network.per_unit=True).

If two dangling lines are paired in a tie-line and have different nominal voltages, the per-unit values for boundary_i and boundary_v_mag will differ between the two dangling lines.

Currently, PowSyBl network model does not support the concept of nominal voltage for the boundary fictitious bus. Therefore, the nominal voltage at the dangling line network side is used for per-unit calculations. While this is generally not an issue, this produces counterintuitive results in the case of dangling lines of different nominal voltages.