SpecialTransformerMV

Represents a special transformer (MV).

Inherits from: ExtrasNotesMixin, HasPresentationsMixin

Import

from pyptp.elements.mv import SpecialTransformerMV

Properties

Property	Type	Required	Default	Description
general	General	Yes	-
presentations	list[BranchPresentation]	Yes	-
type	SpecialTransformerType	Yes	-	Transformer type identifier.
voltage_control	VoltageControl | None	No	None
p_control	PControl | None	No	None
tap_special	TapSpecial | None	No	None
extras	list[Extra]	No	[]
notes	list[Note]	No	[]

General

General properties for a special transformer.

Property	Type	Required	Default	Description
guid	Guid	No	(auto UUID)
creation_time	float | int	No	0.0
mutation_date	int	No	0
revision_date	int	No	0
variant	bool	No	False
node1	Guid	No	NIL_GUID
node2	Guid	No	NIL_GUID
name	str	No	""	Name of transformer.
switch_state1	bool	No	True	Switch state on side 1 (closed=True, open=False).
switch_state2	bool	No	True	Switch state on side 2 (closed=True, open=False).
field_name1	str	No	""	Name of the connection field on side 1.
field_name2	str	No	""	Name of the connection field on side 2.
subnet_border	bool	No	False	Indicates if transformer is on subnet border.
source1	str	No	""	Source identifier for side 1.
source2	str	No	""	Source identifier for side 2.
failure_frequency	float | int	No	0	Mean number of occurrences that the transformer fails per year.
repair_duration	float | int	No	0	Mean duration of repair or replacement in minutes.
maintenance_frequency	float | int	No	0	Mean number of occurrences that the transformer is in maintenance per year.
maintenance_duration	float | int	No	0	Mean duration of maintenance in minutes.
maintenance_cancel_duration	float | int	No	0	Mean duration of cancellation of maintenance in case of emergency in minutes.
loadrate_max	float | int	No	0	Alternative maximum load rating in normal situation in %.
loadrate_max_winter	float | int	No	0	Alternative maximum winter load rating in normal situation in %.
loadrate_max_emergency	float | int	No	0	Alternative maximum load rating in emergency situations in %.
loadrate_max_emergency_winter	float | int	No	0	Alternative maximum winter load rating in failure situation in %.
type	str	No	""	Transformer type identifier.
snom	float | int	No	0	Maximum apparent power in MVA.
phase_shift	float | int	No	0	Phase shift of the transformer windings in degrees.
earthing	int	No	0	Earthing of the neutral point (0=no, 1=own).
re	float | int	No	0	Earthing resistance with earthed neutral point in Ohm.
xe	float | int	No	0	Earthing reactance with earthed neutral point in Ohm.
at_motorstart	bool	No	False	The transformer is used for motor start (affects IEC 60909 calculations).
tap_position	float | int	No	0	Actual transformer tap position.
tap_position_b	float | int	No	0	Actual transformer tap position for phase B (asymmetric control).
tap_position_c	float | int	No	0	Actual transformer tap position for phase C (asymmetric control).

PControl

Power Control.

Property	Type	Required	Default	Description
present	bool	No	False	Presence of power control.
on	bool	No	False	Indicates whether the power control is active.
pmin	int	No	0	Lower bound of the active power control from primary to secondary side in MW.
pmax	float	No	0	Upper bound of the active power control from primary to secondary side in MW.

SpecialTransformerType

Electrotechnical properties of the special transformer.

Property	Type	Required	Default	Description
sort	SpecialTransformerSort	No	NONE
short_name	str	No	""
snom	float | int	No	0
unom1	float | int	No	0
unom2	float | int	No	0
ukmin	int | float	No	0
uknom	int | float	No	0
ukmax	int | float	No	0
pkmin	float | int	No	0
pknom	float | int	No	0
pkmax	float | int	No	0
po	float	No	0
io	float	No	0
r0	float | int	No	0
z0	float | int	No	0
ik2s	float | int	No	0
tap_side	int	No	0
tap_size	float	No	0
tap_min	int	No	0
tap_nom	int	No	0
tap_max	int	No	0
ki	float	No	0
tau	float	No	0

TapSpecial

Tap settings of the special transformer.

Property	Type	Required	Default	Description
tap_position	int	No	0
uk	float | int	No	0
pk	float | int	No	0
z0	float | int	No	0

VoltageControl

Voltage Control.

Property	Type	Required	Default	Description
own_control	bool	No	False	Presence of voltage control.
control_status	bool	No	False	Indicates whether the voltage control is active.
measure_side	int	No	3	Measuring side of voltage control (1=winding1, 2=winding2).
setpoint	float	No	0.4	Setpoint of the voltage control in kV.
deadband	float	No	0	Deadband of the voltage control in kV.
control_sort	int	No	0	Control type/sort identifier.
rc	float	No	0	Real part of the voltage control compounding impedance in Ohm.
xc	float	No	0	Reactive part of the voltage control compounding impedance in Ohm.
compounding_at_generation	bool	No	True	Also compounding when the power goes back (generation direction).
pmin1	int	No	-100	Power where voltage Umin1 is controlled in %.
umin1	float	No	0.4	Control voltage at power Pmin1 in kV.
pmax1	int	No	100	Power where voltage Umax1 is controlled in %.
umax1	float	No	0.0	Control voltage at power Pmax1 in kV.
pmin2	int	No	-100	Second power point where voltage Umin2 is controlled in %.
umin2	float	No	0.4	Control voltage at power Pmin2 in kV.
pmax2	int	No	100	Second power point where voltage Umax2 is controlled in %.
umax2	float	No	0.4	Control voltage at power Pmax2 in kV.