LoadMV

Medium-voltage load element for symmetrical modeling.

Supports balanced three-phase load modeling with power control, unbalanced loading capabilities, and comprehensive load behavior configuration for MV distribution system analysis.

Inherits from: ExtrasNotesMixin, HasPresentationsMixin

Import

from pyptp.elements.mv import LoadMV

Properties

Property	Type	Required	Default	Description
general	General	Yes	-
presentations	list[ElementPresentation]	Yes	-
p_control	PControl | None	No	None
q_control	QControl | None	No	None
pi_control	PIControl | None	No	None
ceres	dict | None	No	None
restrictions	Capacity | None	No	None
extras	list[Extra]	No	[]
notes	list[Note]	No	[]

Capacity

Load capacity restrictions and time-based limitations.

Property	Type	Required	Default	Description
sort	str	No	""
begin_date	int	No	0
end_date	int	No	0
begin_time	float	No	0.0
end_time	float	No	0.0
p_max	float	No	0.0

General

Core electrical and operational properties for MV loads.

Property	Type	Required	Default	Description
node	Guid	No	NIL_GUID
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
name	str	No	""
switch_state	int	No	1
field_name	str	No	""
failure_frequency	float	No	0.0
repair_duration	float	No	0.0
maintenance_frequency	float	No	0.0
maintenance_duration	float	No	0.0
maintenance_cancel_duration	float	No	0.0
not_preferred	bool	No	False
P	float	No	0.0
Q	float	No	0.0
unbalanced	bool	No	False
delta	bool	No	False
fp1	float	No	0.0
fq1	float	No	0.0
fp2	float	No	0.0
fq2	float	No	0.0
fp3	float	No	0.0
fq3	float	No	0.0
earthing	int	No	0
re	float	No	0.0
xe	float	No	0.0
load_behaviour	Guid | NoneType	No	None
load_growth	Guid | NoneType	No	None
profile	Guid | NoneType	No	None
harmonics_type	str	No	""
large_consumers	int	No	0
generous_consumers	int	No	0
small_consumers	int	No	0
harmonic_impedance	bool	No	True

PIControl

Power-current control characteristics for load response.

Property	Type	Required	Default	Description
input1	float	No	1.0
output1	float	No	0.0
input2	float	No	0.0
output2	float	No	0.0
input3	float	No	0.0
output3	float	No	0.0
input4	float	No	0.0
output4	float	No	0.0
input5	float	No	0.0
output5	float	No	0.0
measure_field1	str	No	""
measure_field2	str	No	""
measure_field3	str	No	""