TransformerLV

Low-voltage transformer element with advanced modeling capabilities.

Supports complex impedance modeling, tap changing, voltage control, and detailed electrical parameter specifications for accurate asymmetrical analysis in LV distribution networks.

Inherits from: ExtrasNotesMixin, HasPresentationsMixin

Import

from pyptp.elements.lv import TransformerLV

Properties

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

General

Core electrical and operational properties for LV transformers.

Encompasses all essential transformer characteristics including connection nodes, switch states, tap position, and control parameters.

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
node1	Guid	No	NIL_GUID
node2	Guid	No	NIL_GUID
name	str	No	""
switch_state1_L1	bool	No	True
switch_state1_L2	bool	No	True
switch_state1_L3	bool	No	True
switch_state1_N	bool	No	True
switch_state1_PE	bool	No	True
switch_state2_L1	bool	No	True
switch_state2_L2	bool	No	True
switch_state2_L3	bool	No	True
switch_state2_N	bool	No	True
switch_state2_PE	bool	No	True
field_name1	str	No	""
field_name2	str	No	""
failure_frequency	float | int	No	0
type	str	No	""
switch_state_N_PE	bool	No	False
switch_state_PE_e	bool	No	False
re	float	No	0
tap_position	float	No	0
clock_number	int	No	0
loadrate_max	float	No	0

TransformerType

Electrical specifications and parameters for transformer modeling.

Defines comprehensive transformer characteristics including impedances, losses, winding configurations, and tap changer specifications required for accurate power flow and short-circuit analysis.

Property	Type	Required	Default	Description
short_name	str	No	""
snom	float | int	No	0.0
unom1	float | int	No	0.0
unom2	float | int	No	0.0
Uk	int | float	No	0.0
Pk	float | int	No	0.0
Po	float	No	0.0
Io	float	No	0
R0	float | int	No	0
Z0	float | int	No	0
ik2s	float | int	No	0
winding_connection1	str	No	"D"
winding_connection2	str	No	"YN"
clock_number	int	No	5
tap_side	int	No	1
tap_size	float	No	0.25
tap_min	int	No	0
tap_nom	int	No	0
tap_max	int	No	0
ki	int | float	No	0
tau	int | float	No	0
controllable	bool	No	False

VoltageControl

Automatic voltage control configuration for transformer operation.

Defines control parameters for tap-changing transformers including setpoints, deadbands, and compounding settings for voltage regulation.

Property	Type	Required	Default	Description
own_control	bool	No	False
control_status	int	No	0
measure_side	int	No	3
control_node	str	No	""
setpoint	float	No	0
deadband	float	No	0
control_sort	int	No	0
Rc	float	No	0
Xc	float	No	0
compounding_at_generation	bool	No	True
p_min1	int	No	0
u_min1	float	No	0
p_max1	int	No	0
u_max1	float	No	0