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

python

from pyptp.elements.lv import ConnectionLV

Properties

Property	Type	Required	Default
`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 home/connections.

Property	Type	Required	Default
`pref`	`float`	No	`0.0`
`state_of_charge`	`float`	No	`50`
`capacity`	`float`	No	`0`
`crate`	`float`	No	`0.5`
`sort`	`int`	No	`0`
`inverter_snom`	`float`	No	`0`
`charge_efficiency_type`	`str`	No	`""`
`discharge_efficiency_type`	`str`	No	`""`
`profile`	Guid	No	`UUID(...)`
`inverter_cosref`	`float`	No	`0.0`

GM

Gaussian Mixture properties.

Property	Type	Required	Default
`gm_type_number`	`int`	No	`1`
`p`	`float`	No	`0.0`
`cos`	`float`	No	`1.0`
`small_appliance_phases`	`int`	No	`1`
`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
`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`
`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`
`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`
`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`
`sort`	`str`	No	`""`
`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 home/connection.

Property	Type	Required	Default
`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	`UUID(...)`

Geography

Connection geographical information.

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

HEMS

Home Energy Management System.

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

Heatpump

Heatpump properties of a home/connection.

Property	Type	Required	Default
`number_of`	`int`	No	`0`
`sort`	`str`	No	`"Air"`
`house_type`	`str`	No	`"Apartment"`
`house_area`	`float`	No	`0.0`
`cosnom`	`float`	No	`0.0`
`profile`	Guid	No	`UUID(...)`

Load

Load of a home/connection.

Property	Type	Required	Default
`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	`""`
`switch_on_frequency`	`float`	No	`0.0`
`profile`	Guid	No	`UUID(...)`

PL

PL.

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

PLType

PL type.

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

PV

PV properties of a home/connection.

Property	Type	Required	Default
`scaling`	`float`	No	`0`
`panel1_pnom`	`float`	No	`0`
`panel1_orientation`	`float`	No	`0`
`panel1_slope`	`float`	No	`0`
`panel2_pnom`	`float`	No	`0`
`panel2_orientation`	`float`	No	`0`
`panel2_slope`	`float`	No	`0`
`panel3_pnom`	`float`	No	`0`
`panel3_orientation`	`float`	No	`0`
`panel3_slope`	`float`	No	`0`
`inverter_snom`	`float`	No	`0`
`efficiency_type`	`str`	No	`""`
`phases`	`int`	No	`1`
`u_out`	`float`	No	`0`
`p_controlsort`	`int`	No	`0`
`p_control_input1`	`float`	No	`0.0`
`p_control_output1`	`float`	No	`0.0`
`q_control_input1`	`float`	No	`0.0`
`q_control_output1`	`float`	No	`0.0`
`p_control_input2`	`float`	No	`0.0`
`p_control_output2`	`float`	No	`0.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	`0.0`
`q_control_no_p_no_q`	`bool`	No	`False`
`intersection`	`float`	No	`0.0`
`length`	`float`	No	`0.0`
`profile`	Guid	No	`UUID(...)`

WindTurbine

Windturbine of a home/connection.

Property	Type	Required	Default
`windspeed`	`float`	No	`11`
`profile`	Guid	No	`UUID(...)`
`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	`0`
`q_control_no_p_no_q`	`bool`	No	`False`
`q_control_input1`	`float`	No	`0.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	`0.0`
`length`	`float`	No	`0.0`

Referenced Types

EfficiencyType

Efficiency Type.

Defined in pyptp.elements.lv.shared

Property	Type	Required	Default
`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`

ConnectionLV ​

Import ​

Properties ​

Battery ​

GM ​

General ​

Generation ​

Geography ​

HEMS ​

Heatpump ​

Load ​

PL ​

PLType ​

PV ​

WindTurbine ​

Referenced Types ​

EfficiencyType ​