ThreewindingTransformerMV

Medium-voltage three-winding transformer with tap control modeling.

Supports three-winding power transformer analysis with configurable winding voltages, power ratings, tap positions, and loading limits for substation studies in balanced three-phase MV networks.

Inherits from: ExtrasNotesMixin, HasPresentationsMixin

Import

from pyptp.elements.mv import ThreewindingTransformerMV

Properties

Property	Type	Required	Default	Description
general	General	Yes	-
type	ThreewindingTransformerType	Yes	-
presentations	list[DWPresentation]	Yes	-
voltage_control	VoltageControl | None	No	None
extras	list[Extra]	No	[]
notes	list[Note]	No	[]

General

Core electrical and operational properties for MV three-winding transformers.

Encompasses connection nodes, switch states, winding power ratings, tap positions, loading limits, and reliability statistics.

Property	Type	Required	Default	Description
guid	Guid	No	(auto UUID)
creation_time	float | int	No	0
mutation_date	int	No	0
revision_date	float | int	No	0.0
variant	bool	No	False
node1	Guid	No	Guid('00000000-0000-0000-00...
node2	Guid	No	Guid('00000000-0000-0000-00...
node3	Guid	No	Guid('00000000-0000-0000-00...
name	str	No	""
switch_state1	bool	No	True
switch_state2	bool	No	True
switch_state3	bool	No	True
field_name1	str	No	""
field_name2	str	No	""
field_name3	str	No	""
failure_frequency	float	No	0
repair_duration	float	No	0
maintenance_frequency	float	No	0
maintenance_duration	float	No	0
maintenance_cancel_duration	float	No	0
type	str	No	""
loadrate_max	float	No	0
loadrate_max_winter	float	No	0
loadrate_max_emergency	float	No	0
loadrate_max_emergency_winter	float	No	0
snom1	float	No	0
snom2	float	No	0
snom3	float	No	0
phase_shift12	float	No	0
phase_shift13	float	No	0
earthing1	int	No	0
re1	float	No	0
xe1	float	No	0
earthing2	int	No	0
re2	float	No	0
xe2	float	No	0
earthing3	int	No	0
re3	float	No	0
xe3	float	No	0
tap_controlled	float	No	0
tap_fixed	int	No	0

LoadDependent

One of four load-dependent voltage control settings sets.

Two breakpoints per direction, in % of Snom: p_smaller < p_small < 0 for load and 0 < p_great < p_greater for generation. An outer breakpoint of 0 means the curve stops at the inner one.

Property	Type	Required	Default	Description
p_smaller	int	No	0	Outer load-side breakpoint in %, 0 when not used.
u_smaller	float	No	0	Control voltage at p_smaller in kV.
p_small	int	No	-100	Inner load-side breakpoint in %.
u_small	float	No	0	Control voltage at p_small in kV.
p_great	int	No	100	Inner generation-side breakpoint in %.
u_great	float	No	0	Control voltage at p_great in kV.
p_greater	int	No	0	Outer generation-side breakpoint in %, 0 when not used.
u_greater	float	No	0	Control voltage at p_greater in kV.

ThreewindingTransformerType

Electrotechnical properties of the threewinding transformer.

Property	Type	Required	Default	Description
snom1	float	No	0
snom2	float	No	0
snom3	float	No	0
unom1	float	No	0
unom2	float	No	0
unom3	float	No	0
uk12	float	No	0
uk13	float	No	0
uk23	float	No	0
uk12min	float	No	0
uk13min	float	No	0
uk23min	float	No	0
uk12max	float	No	0
uk13max	float	No	0
uk23max	float	No	0
pk12	float	No	0
pk13	float	No	0
pk23	float	No	0
s_at12	float	No	0
s_at13	float	No	0
s_at23	float	No	0
Po	float	No	0
Io	float	No	0
R012	float	No	0
Z012	float	No	0
R013	float	No	0
Z013	float	No	0
R023	float	No	0
Z023	float	No	0
Ik2s1	float	No	0
Ik2s2	float	No	0
Ik2s3	float	No	0
C1	float	No	0
C2	float	No	0
C3	float	No	0
C12	float	No	0
C13	float	No	0
C23	float	No	0
connection1	str	No	""
connection2	str	No	""
connection3	str	No	""
clock_number12	int	No	0
clock_number13	int	No	0
tap_side_controlled	int	No	0
tap_size_controlled	float	No	0
tapmin_controlled	int	No	0
tapnom_controlled	int	No	0
tap_size_fixed	float	No	0
tapmax_controlled	float	No	0
tap_side_fixed	int	No	0
tapmin_fixed	int	No	0
tapnom_fixed	int	No	0
tapmax_fixed	int	No	0

VoltageControl

Voltage Control.

Property	Type	Required	Default	Description
own_present	bool	No	False
status	VoltageControlStatus	No	OFF
measure_side	int	No	0
setpoint	float	No	0.0
deadband	float	No	0.0
control_sort	VoltageControlSort	No	COMPOUNDING
rc	float	No	0.0
xc	float	No	0.0
compounding_at_generation	bool	No	True
load_dependencies	list[LoadDependent]	No	(factory)
master_transformer	Guid	No	Guid('00000000-0000-0000-00...

Referenced Types

LoadDependent

One of four load-dependent voltage control settings sets.

Two breakpoints per direction, in % of Snom: p_smaller < p_small < 0 for load and 0 < p_great < p_greater for generation. An outer breakpoint of 0 means the curve stops at the inner one.

Defined in pyptp.elements.mv.threewinding_transformer

Property	Type	Required	Default	Description
p_smaller	int	No	0	Outer load-side breakpoint in %, 0 when not used.
u_smaller	float	No	0	Control voltage at p_smaller in kV.
p_small	int	No	-100	Inner load-side breakpoint in %.
u_small	float	No	0	Control voltage at p_small in kV.
p_great	int	No	100	Inner generation-side breakpoint in %.
u_great	float	No	0	Control voltage at p_great in kV.
p_greater	int	No	0	Outer generation-side breakpoint in %, 0 when not used.
u_greater	float	No	0	Control voltage at p_greater in kV.