pypowsybl.network.Network.get_static_var_compensators#

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

Get a dataframe of static var compensators.

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 static var compensators.

Return type:

DataFrame

Notes

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

  • b_min: the minimum susceptance

  • b_max: the maximum susceptance

  • target_v: The voltage setpoint

  • target_q: The reactive power setpoint

  • regulation_mode: The regulation mode

  • regulated_element_id: The ID of the network element where voltage is regulated

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

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

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

  • voltage_level_id: at which substation the var compensator is connected

  • bus_id: bus where this SVC is connected

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

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

  • connected: True if the var compensator is connected to a bus

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

This dataframe is indexed by the id of the var compensator

Examples

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

will output something like:

b_min

b_max

target_v

target_q

regulation_mode

regulated_element_id

p

q

i

voltage_level_id

bus_id

connected

id

SVC

-0.05

0.05

400.0

NaN

VOLTAGE

SVC

NaN

-12.5415

NaN

S4VL1

S4VL1_0

True

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

will output something like:

b_min

b_max

voltage_setpoint

reactive_power_setpoint

regulation_mode

regulated_element_id

p

q

i

voltage_level_id

bus_id

connected

id

SVC

-0.05

0.05

400.0

NaN

VOLTAGE

SVC

NaN

-12.5415

NaN

S4VL1

S4VL1_0

True

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

will output something like:

p

q

i

voltage_level_id

bus_id

connected

id

SVC

NaN

-12.5415

NaN

S4VL1

S4VL1_0

True