ConnectionLV

Low-voltage customer connection with comprehensive prosumer modeling.

Supports residential and commercial connection analysis including load profiles, distributed generation (PV, wind), battery storage, heat pumps, and detailed earthing configurations for asymmetrical LV network studies.

Inherits from: ExtrasNotesMixin, HasPresentationsMixin

Import

from pyptp.elements.lv import ConnectionLV

Properties

Property	Type	Required	Default	Description
general	General	Yes	-
presentations	list[ElementPresentation]	Yes	-
gms	list[GM]	Yes	-
connection_cable	CableType | None	No	None
connection_geography	Geography | None	No	None
fuse_type	FuseType | None	No	None
current_protection	CurrentType | None	No	None
load	Load | None	No	None
public_lighting	PL | None	No	None
public_lighting_type	PLType | None	No	None
heat_pump	Heatpump | None	No	None
generation	Generation | None	No	None
pv	PV | None	No	None
pv_efficiency	EfficiencyType | None	No	None
windturbine	WindTurbine | None	No	None
windturbine_efficiency	EfficiencyType | None	No	None
battery	Battery | None	No	None
battery_charge_efficiency	EfficiencyType | None	No	None
battery_discharge_efficiency	EfficiencyType | None	No	None
hems	HEMS | None	No	None
extras	list[Extra]	No	[]
notes	list[Note]	No	[]

Battery

Battery of a connection.

Property	Type	Required	Default	Description
pref	float	No	0.0
state_of_charge	float	No	50
capacity	float	No	0
sort	int	No	0
inverter_snom	float	No	0
charge_efficiency_type	str	No	""
discharge_efficiency_type	str	No	""
profile	Guid	No	Guid('a4d813df-1ee1-4153-80...
inverter_cosref	float	No	1.0

GM

Gaussian Mixture properties.

Property	Type	Required	Default	Description
gm_type_number	int	No	0
p	float	No	0.0	Active power in MW.
cos	float	No	1.0
small_appliance_phases	int	No	0
net_aware_charging	bool	No	False
adjustable	bool	No	False

General

Core electrical and operational properties for LV customer connections.

Encompasses connection node, service cable parameters, phase configuration, earthing setup, protection settings, and geographic information.

Property	Type	Required	Default	Description
node	Guid	No	Guid('00000000-0000-0000-00...
guid	Guid	No	(auto UUID)
creation_time	float | int	No	0
mutation_date	int	No	0
revision_date	float | int	No	0.0
name	str	No	""
s_L1	bool	No	True
s_L2	bool	No	True
s_L3	bool	No	True
s_N	bool	No	True
field_name	str	No	""
s_PE	bool	No	True
k_L1	int	No	1
k_L2	int	No	2
k_L3	int	No	3
length	float | int	No	0.0	Length of the service cable in metres.
cable_type	str	No	""
earthing_configuration	str	No	""
s_Nh_PEh	bool	No	False
s_PEh_PEh	bool	No	True
s_PEh_e	bool	No	False
re	float | int	No	0.0	Earthing resistance in ohm.
s_Hh	bool	No	True
protection_type	str	No	""
s_h1_h3	bool	No	False
s_h2_h4	bool	No	False
phases	int	No	4	0 single-phase on any phase, 1 to 3 single-phase on L1 to L3, 4 three-phase.
sort	str	No	""	See ConnectionSort. Empty means COMBI.
connection_value	str	No	""
i_earthleak	int | float	No	0.0
risk	bool	No	False
geo_x_coord	float | int	No	0.0
geo_y_coord	float | int	No	0.0
address	str	No	""
postal_code	str	No	""
city	str	No	""

Generation

Generating properties of a connection.

Property	Type	Required	Default	Description
p1	float	No	0.0
q1	float	No	0.0
pa	float	No	0.0
qa	float	No	0.0
pb	float	No	0.0
qb	float	No	0.0
pc	float	No	0.0
qc	float	No	0.0
pab	float	No	0.0
qab	float	No	0.0
pac	float	No	0.0
qac	float	No	0.0
pbc	float	No	0.0
qbc	float	No	0.0
behaviour_sort	str	No	""
profile	Guid	No	Guid('a4d813df-1ee1-4153-80...

Geography

Connection geographical information.

Property	Type	Required	Default	Description
coordinates	list[tuple]	No	[]

HEMS

Home Energy Management System.

Property	Type	Required	Default	Description
regime	str	No	""
parameter1	float	No	60.0
parameter2	float	No	0.0
parameter3	float	No	0.0

Heatpump

Heatpump properties of a connection.

Property	Type	Required	Default	Description
number_of	int	No	0
sort	str	No	AIR
house_type	str	No	UNKNOWN
house_area	float	No	125.0
house_year	int	No	0
cosnom	float	No	1.0
profile	Guid	No	Guid('a4d813df-1ee1-4153-80...

Load

Load of a connection.

Powers in MW and Mvar. p1 and q1 apply to a single-phase connection, the other fields to a three-phase connection.

Property	Type	Required	Default	Description
p1	float	No	0.0	Active power of a single-phase connection in MW.
q1	float	No	0.0	Reactive power of a single-phase connection in Mvar.
pa	float	No	0.0	Active power between L1 and neutral in MW.
qa	float	No	0.0	Reactive power between L1 and neutral in Mvar.
pb	float	No	0.0	Active power between L2 and neutral in MW.
qb	float	No	0.0	Reactive power between L2 and neutral in Mvar.
pc	float	No	0.0	Active power between L3 and neutral in MW.
qc	float	No	0.0	Reactive power between L3 and neutral in Mvar.
pab	float	No	0.0	Active power between L1 and L2 in MW.
qab	float	No	0.0	Reactive power between L1 and L2 in Mvar.
pac	float	No	0.0	Active power between L1 and L3 in MW.
qac	float	No	0.0	Reactive power between L1 and L3 in Mvar.
pbc	float	No	0.0	Active power between L2 and L3 in MW.
qbc	float	No	0.0	Reactive power between L2 and L3 in Mvar.
behaviour_sort	str	No	""	See BehaviourSort. Empty means CONSTANT_CURRENT.
switch_on_frequency	float	No	0.0	Switch-on events per minute.
profile	Guid	No	Guid('a4d813df-1ee1-4153-80...

PL

PL.

Property	Type	Required	Default	Description
number_of	int	No	0
phases	int	No	0
pl_type	str	No	""

PLType

PL type.

Property	Type	Required	Default	Description
unom	float	No	0.0
inom	float	No	0.0
cosnom	float	No	0.0

PV

PV properties of a connection.

Property	Type	Required	Default	Description
scaling	float	No	1000
panel1_pnom	float	No	0
panel1_orientation	float	No	180
panel1_slope	float	No	30
panel2_pnom	float	No	0
panel2_orientation	float	No	180
panel2_slope	float	No	30
panel3_pnom	float	No	0
panel3_orientation	float	No	180
panel3_slope	float	No	30
inverter_snom	float	No	0
efficiency_type	str	No	""
phases	int	No	0
u_out	float	No	0
p_controlsort	int	No	0
p_control_input1	float	No	0.9
p_control_output1	float	No	1.0
q_control_input1	float	No	1.0
q_control_output1	float	No	0.0
p_control_input2	float	No	1.1
p_control_output2	float	No	1.0
q_control_input2	float	No	0.0
q_control_output2	float	No	0.0
p_control_input3	float	No	0.0
p_control_output3	float	No	0.0
q_control_input3	float	No	0.0
q_control_output3	float	No	0.0
p_control_input4	float	No	0.0
p_control_output4	float	No	0.0
q_control_input4	float	No	0.0
q_control_output4	float	No	0.0
p_control_input5	float	No	0.0
p_control_output5	float	No	0.0
q_control_input5	float	No	0.0
q_control_output5	float	No	0.0
q_controlsort	int	No	0
q_control_cosref	float	No	1.0
q_control_no_p_no_q	bool	No	True
intersection	float	No	1.5
length	float	No	0.0
profile	Guid	No	Guid('a4d813df-1ee1-4153-80...

WindTurbine

Windturbine of a connection.

Property	Type	Required	Default	Description
windspeed	float	No	11
profile	Guid	No	Guid('a4d813df-1ee1-4153-80...
pnom	float	No	0.0
sort	int	No	0
inverter_snom	float	No	0.0
efficiency_type	str	No	""
phases	int	No	0
u_out	float	No	0.0
q_controlsort	int	No	0
q_control_cosref	float	No	1.0
q_control_no_p_no_q	bool	No	True
q_control_input1	float	No	1.0
q_control_output1	float	No	0.0
q_control_input2	float	No	0.0
q_control_output2	float	No	0.0
q_control_input3	float	No	0.0
q_control_output3	float	No	0.0
q_control_input4	float	No	0.0
q_control_output4	float	No	0.0
q_control_input5	float	No	0.0
q_control_output5	float	No	0.0
intersection	float	No	1.5
length	float	No	0.0

Referenced Types

EfficiencyType

Efficiency Type.

Defined in pyptp.elements.lv.shared

Property	Type	Required	Default	Description
input1	float	No	0.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