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	NIL_GUID
node2	Guid	No	NIL_GUID
node3	Guid	No	NIL_GUID
name	str	No	""
switch_state1	int	No	1
switch_state2	int	No	1
switch_state3	int	No	1
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

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
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
present	bool	No	False
status	int	No	0
measuring_side	int	No	1
setpoint	float	No	0.0
deadband	float	No	0.0
control_sort	int	No	0
rc	float	No	0.0
xc	float	No	0.0
compounding_at_generation	bool	No	False
pmin1	int	No	0
umin1	float	No	0.0
pmax1	int	No	0
umax1	float	No	0.0
pmin2	int	No	0
umin2	float	No	0.0
pmax2	int	No	0
umax2	float	No	0.0
master_threewinding_transformer	Guid	No	NIL_GUID