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 (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 dangling lines.
- Return type:
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)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 busfictitious (optional):
True
if the dangling line is part of the model and not of the actual networkucte-xnode-code: the UCTE Xnode code associated to the dangling line, to be used for creating tie lines.
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