ShuntCoilMV

Medium-voltage shunt coil with reactive absorption modeling.

Supports shunt reactor analysis with configurable reactive power absorption for voltage control and Ferranti effect mitigation in balanced three-phase MV distribution networks.

Inherits from: ExtrasNotesMixin, HasPresentationsMixin

Import

from pyptp.elements.mv import ShuntCoilMV

Properties

Property	Type	Required	Default	Description
general	General	Yes	-
presentations	list[ElementPresentation]	Yes	-
extras	list[Extra]	No	[]
notes	list[Note]	No	[]

General

Core electrical and operational properties for MV shunt coils.

Encompasses connection node, reactive power rating, nominal voltage, earthing configuration, and reliability statistics.

Property	Type	Required	Default	Description
node	Guid	No	NIL_GUID
guid	Guid	No	(auto UUID)
creation_time	float	No	0.0
mutation_date	int	No	0
revision_date	int	No	0
variant	bool	No	False
name	str	No	""
switch_state	int	No	0
field_name	str	No	""	Name of the connection field.
failure_frequency	float	No	0.0	Mean number of occurrences that the coil fails (short circuit) per year.
repair_duration	float	No	0.0	Mean duration of repair or replacement in minutes.
maintenance_frequency	float	No	0.0	Mean number of occurrences that the coil is in maintenance per year.
maintenance_duration	float	No	0.0	Mean duration of maintenance in minutes.
maintenance_cancel_duration	float	No	0.0	Mean duration of cancellation of maintenance in case of emergency in minutes.
not_preferred	bool	No	False
Q	float	No	0.0	Reactive power in Mvar.
unom	float	No	0.0	Nominal voltage in kV.
profile	Guid	No	UUID(...)	Name of the coil power profile.
earthing	int	No	0	Star point earthing setting (0=no, 1=yes).
re	float	No	0.0	Earthing resistance with earthed star point in Ohm.
xe	float	No	0.0	Earthing reactance with earthed star point in Ohm.
earthing_node	Guid | NoneType	No	None
voltage_control	bool	No	False	Indicates whether the voltage control has been switched on or off.
u_on	float	No	0.0	Voltage above which the shunt reactor switches off in kV.
u_off	float	No	0.0	Voltage under which the shunt reactor switches on in kV.