pypowsybl.network.Network.get_phase_tap_changer_steps#

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

Get a dataframe of phase tap changer steps.

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 phase tap changer steps.

Return type:

DataFrame

Notes

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

  • rho: The voltage ratio in per unit of the rated voltages (in per unit)

  • alpha: the angle difference (in degree)

  • r: The resistance deviation in percent of nominal value (%)

  • x: The reactance deviation in percent of nominal value (%)

  • g: The conductance deviation in percent of nominal value (%)

  • b: The susceptance deviation in percent of nominal value (%)

This dataframe is index by the id of the transformer and the position of the phase tap changer step

Examples

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

will output something like:

rho

alpha

r

x

g

b

id

position

TWT

0

1.0

-42.80

39.784730

29.784725

0.0

0.0

1

1.0

-40.18

31.720245

21.720242

0.0

0.0

2

1.0

-37.54

23.655737

13.655735

0.0

0.0

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

will output something like:

rho

alpha

r

x

g

b

id

position

TWT

0

1.0

-42.80

39.784730

29.784725

0.0

0.0

1

1.0

-40.18

31.720245

21.720242

0.0

0.0

2

1.0

-37.54

23.655737

13.655735

0.0

0.0

net = pp.network.create_four_substations_node_breaker_network()
net.get_phase_tap_changer_steps(attributes=['rho','r','x'])

will output something like:

rho

r

x

id

position

TWT

0

1.0

39.784730

29.784725

1

1.0

31.720245

21.720242

2

1.0

23.655737

13.655735