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 (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 phase tap changer steps.
- Return type:
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
…
…
…
…
…