BatteryLV
Battery energy storage system for low-voltage network modeling.
Integrates battery storage with power electronics for bidirectional energy flow, supporting grid stabilization, peak shaving, and renewable energy integration in LV distribution networks.
Inherits from: ExtrasNotesMixin, HasPresentationsMixin
Import
python
from pyptp.elements.lv import BatteryLVProperties
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
general | General | Yes | - | |
presentations | list[ElementPresentation] | Yes | - | |
charge_efficiency | EfficiencyType | No | (factory) | |
discharge_efficiency | EfficiencyType | No | (factory) | |
pu_control | PUControl | None | No | None | |
pi_control | PIControl | None | No | None | |
inverter | Inverter | None | No | None | |
harmonics | HarmonicsType | None | No | None | |
extras | list[Extra] | No | [] | |
notes | list[Note] | No | [] |
General
Core battery system configuration and electrical connection properties.
| 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 | "" | Name of the connection field. |
single_phase | bool | No | False | |
phase | int | No | 0 | |
pref | float | No | 0.0 | Active power generation in MW (positive = charging from network). |
state_of_charge | float | No | 50.0 | Initial state of charge in %. |
profile | Guid | No | Guid('a4d813df-1ee1-4153-80... | |
capacity | float | No | 0.0 | Storage capacity in MWh. |
harmonics_type | str | No | "" |
Inverter
Power electronics inverter parameters for battery energy conversion.
Defines AC/DC conversion characteristics and efficiency curves for accurate power flow modeling in both charging and discharging modes.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
s_nom | float | No | 0.0 | Nominal power of the inverter in MVA. |
charge_efficiency_type | str | No | "0,1..1 pu: 95 %" | Type of the charging efficiency, as function of the input power. |
discharge_efficiency_type | str | No | "0,1..1 pu: 95 %" | Type of the discharging efficiency, as function of the output power. |
cos_ref | float | No | 1.0 | Power factor. |
PIControl
Power(current) control curve for battery active power.
| 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 | Guid | No | Guid('00000000-0000-0000-00... |
PUControl
Power(voltage) control curve for battery active power.
| 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 |
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 |