eelib.data.dataclass.devices

Dataclasses for devices’ data used in eELib.

Author: elenia@TUBS
Copyright 2024 elenia
This file is part of eELib, which is free software under the terms of the GNU GPL Version 3.

Module Contents

Classes

BaseDeviceData

Baseclass for Dataclasses of the devices.

BSSData

Dataclass for eELib BSS model.

EVData

Dataclass for eELib EV model.

CSData

Dataclass for eElib charging station model.

HPData

Dataclass for eElib heatpump model.

PVData

Dataclass for eElib pv(lib) model.

class BaseDeviceData

Bases: eelib.data.dataclass._base.BaseData

Baseclass for Dataclasses of the devices.

p (float): current active power p_min (float): minimum active power limit p_max (float): maximum active power limit

p: float
p_min: float
p_max: float
class BSSData

Bases: BaseDeviceData

Dataclass for eELib BSS model.

e_bat_rated (float): rated energy amount of bss p_rated_charge_max (float): maximum charge power of bss p_rated_discharge_max (float): maximum discharge power of bss loss_rate (float): self-discharge (per month) of bss self_discharge_step (float): self-discharge rate (per simulation step) of bss dod_max (float): maximum depth of discharge status_aging (float): whether to account for aging of battery soh_cycles_max (float): state of health at end of lifetime bat_cycles_max (float): maximum cycles to reach end of lifetime soc_min (float): lower soc level of bss bat2ac_efficiency (list[float]): exponential discharging efficiency values ac2bat_efficiency (list[float]): exponential charging efficiency values

charge_efficiency (float): charging efficiency discharge_efficiency (float): discharging efficiency soh (float): state of health bat_cycles (int): number of cycles accumulated by the battery e_bat (float): current energy amount stored e_bat_usable (float): usable energy amount of bss considering ageing

e_bat_rated: int
p_rated_discharge_max: int
p_rated_charge_max: int
loss_rate: float
self_discharge_step: float
dod_max: float
status_aging: bool
soh_cycles_max: float
bat_cycles_max: int
soc_min: float
bat2ac_efficiency: list[float] | None
ac2bat_efficiency: list[float] | None
charge_efficiency: float
discharge_efficiency: float
soh: float
bat_cycles: int
e_bat: float
e_bat_usable: float
class EVData

Bases: BaseDeviceData

Dataclass for eELib EV model.

soc_min (float): minimum soc level of car e_max (float): rated energy level of car battery p_nom_charge_max (float): maximum charging power of car p_nom_discharge_max (float): maximum discharging power of car charge_efficiency (float): charge efficiency of car dcharge_efficiency (float): discharge efficiency of car

e_bat (float): energy amount of the car appearance (bool): where car is available at charging point or not

soc_min: float
e_max: float
p_nom_discharge_max: float
p_nom_charge_max: float
dcharge_efficiency: float
charge_efficiency: float
e_bat: float
appearance: bool
class CSData

Bases: BaseDeviceData

Dataclass for eElib charging station model.

charge_efficiency (float): charge efficiency of charging station discharge_efficiency (float): discharge efficiency of charging station p_rated (float): rated power of charging station

ev_data (dict): information about all the connected electric vehicles q (float): current reactive power

discharge_efficiency: float
charge_efficiency: float
p_rated: float
ev_data: dict[str:EVData]
q: float
class HPData

Bases: BaseDeviceData

Dataclass for eElib heatpump model.

p_rated (float): rated thermal power of heatpumps p_min_th_rel (float): relative minimum power (of rated power) for modulating heatpumps time_min (int): minimum on/off-time for heatpumps

time_on (int): current on-time for heatpumps time_off (int): current off-time for heatpumps state (str): current state of heatpumps (on, off, must-on or must-off) cop (float): current coefficient of power for heatpumps p_th (float): current thermal power p_th_min (float): minimum thermal power limit p_th_min_on (float): minimum thermal power limit in on-state p_min_on (float): minimum electrical power limit in on-state p_th_max (float): maximum thermal power limit q (float): current reactive power

p_rated_th: float
p_min_th_rel: float
time_min: int
time_on: int
time_off: int
state: str
cop: float
p_th: float
p_th_min: float
p_th_min_on: float
p_min_on: float
p_th_max: float
q: float
class PVData

Bases: BaseDeviceData

Dataclass for eElib pv(lib) model.

p_rated (float): rated power of system

q (float): current reactive power

p_rated: float
q: float