SourceMV

Medium-voltage source representing external network supply.

Models feeder points with configurable voltage magnitude and angle, short-circuit capacity, and reliability parameters for accurate balanced three-phase analysis in MV distribution networks.

Inherits from: ExtrasNotesMixin, HasPresentationsMixin, IconMixin

Import

from pyptp.elements.mv import SourceMV

Properties

Property	Type	Required	Default	Description
general	General	Yes	-
presentations	list[ElementPresentation]	Yes	-
icon	pyptp.elements.mixins.Icon | None	No	None
extras	list[Extra]	No	[]
notes	list[Note]	No	[]

General

Core electrical and operational properties for MV sources.

Encompasses connection node, voltage reference, phase angle, short-circuit parameters, and reliability statistics.

Property	Type	Required	Default	Description
node	Guid	No	Guid('00000000-0000-0000-00...
guid	Guid	No	(auto UUID)
creation_time	float	No	0
mutation_date	int	No	0
revision_date	int	No	0
variant	bool	No	False
name	str	No	""
switch_state	bool	No	True
field_name	str	No	""	Name of the connection field.
failure_frequency	float	No	0.0	Mean number of occurrences that the source 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 source 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
uref	float	No	1	Reference voltage as a factor of Unom in pu.
angle	float	No	0	Reference voltage phase angle in degrees.
sk2nom	float	No	0	Sub-transient short-circuit power in MVA.
sk2min	float	No	0	Minimum sub-transient short-circuit power in MVA.
sk2max	float	No	0	Maximum sub-transient short-circuit power in MVA.
r_x	float	No	0.0	Ratio between source impedance R and X (dimensionless).
z0_z1	float	No	1.0	Ratio between source impedance zero and normal sequence (dimensionless).
u2	float | int	No	0.0
smin	float	No	0	Minimal to be tested power in MVA.
smax	float	No	0	Maximal to be tested power in MVA.
pmin	float	No	0	Minimum active power limit in MW.
pmax	float	No	0	Maximum active power limit in MW.
profile	Guid	No	Guid('a4d813df-1ee1-4153-80...	GUID reference to the voltage profile.

Referenced Types

Icon

Optional icon displayed near a network element in diagrams.

A short text in a shaped background (configurable color, shape, size).

Defined in pyptp.elements.mixins

Property	Type	Required	Default	Description
text	str	No	""
text_color	DelphiColor	No	"$000000"
background_color	DelphiColor	No	"$000000"
shape	int	No	0
size	int	No	0