BatteryMV
Battery energy storage system for medium-voltage network modeling.
Integrates large-scale battery storage with symmetrical power system modeling for grid stabilization, peak shaving, and renewable energy balancing in MV distribution networks.
Inherits from: ExtrasNotesMixin, HasPresentationsMixin
Import
python
from pyptp.elements.mv import BatteryMVProperties
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
general | General | Yes | - | |
inverter | Inverter | Yes | - | |
presentations | list[ElementPresentation] | Yes | - | |
charge_efficiency_type | EfficiencyType | None | No | None | Type of the charging efficiency, as function of the input power. |
discharge_efficiency_type | EfficiencyType | None | No | None | Type of the discharging efficiency, as function of the output power. |
p_control | PControl | None | No | None | |
q_control | QControl | None | No | None | |
harmonics_type | HarmonicsType | None | No | None | |
extras | list[Extra] | No | [] | |
notes | list[Note] | No | [] |
General
General properties for a battery.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
node | Guid | No | NIL_GUID | |
guid | Guid | No | (auto UUID) | |
creation_time | float | int | No | 0.0 | |
mutation_date | int | No | 0 | |
revision_date | int | No | 0 | |
variant | bool | No | False | |
name | str | No | "" | |
switch_state | int | No | 0 | |
field_name | str | No | "" | Name of the connection field. |
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 | |
pref | float | No | 0.0 | Generation of active power in MW (positive = charging from network). |
state_of_charge | float | No | 50.0 | Initial State of Charge in %. |
profile | Guid | No | UUID(...) | |
capacity | float | No | 0.0 | Storage capacity in MWh. |
c_rate | float | No | 0.5 | 1 hour nominal discharge rate in /h. |
harmonics_type | str | No | "" |
Inverter
Battery inverter properties.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
snom | float | No | 0.0 | Nominal power of the inverter in MVA. |
unom | float | No | 0.0 | Nominal voltage of the inverter in kV. |
ik_inom | float | No | 1.0 | Relation between the short circuit current and the nominal current. |
charge_efficiency_type | str | No | "" | Type of the charging efficiency, as function of the input power. |
discharge_efficiency_type | str | No | "" | Type of the discharging efficiency, as function of the output power. |
Referenced Types
HarmonicsType
Shared Harmonics type for LV and MV elements.
Defined in pyptp.elements.lv.shared
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
h | list[float] | None | No | (factory) | |
angle | list[float] | None | No | (factory) |