:py:mod:`eelib.data.dataclass.devices` ====================================== .. py:module:: eelib.data.dataclass.devices .. autoapi-nested-parse:: 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 ~~~~~~~ .. autoapisummary:: eelib.data.dataclass.devices.BaseDeviceData eelib.data.dataclass.devices.BSSData eelib.data.dataclass.devices.EVData eelib.data.dataclass.devices.CSData eelib.data.dataclass.devices.HPData eelib.data.dataclass.devices.TESData eelib.data.dataclass.devices.PVData .. py:class:: BaseDeviceData Bases: :py:obj:`eelib.data.dataclass.BaseData` Baseclass for Dataclasses of the devices. Power limit for minimum and maximum power are using the passive sign convention. Hence, for consumption devices the maximum power is the maximum power demand and for generation devices the maximum power is the minimum power generation. .. attribute:: p current active power :type: float .. attribute:: p_min minimum active power limit (for generating devices: maximum output) :type: float .. attribute:: p_max maximum active power limit (for generating devices: minimum output) :type: float .. py:class:: BSSData Bases: :py:obj:`BaseDeviceData` Dataclass for eELib BSS model. .. attribute:: e_bss_rated rated energy amount of bss :type: float | None .. attribute:: p_rated_charge_max maximum charge power of bss :type: float | None .. attribute:: p_rated_discharge_max maximum discharge power of bss :type: float | None .. attribute:: loss_rate self-discharge (per month) of bss :type: float | None .. attribute:: self_discharge_step self-discharge rate (per simulation step) of bss :type: float | None .. attribute:: status_aging whether to account for aging of battery :type: bool | None .. attribute:: status_curve whether to use a coded curve (true) or static efficiency (false) :type: bool | None .. attribute:: soh_cycles_max state of health at end of lifetime :type: float | None .. attribute:: bss_cycles_max maximum cycles to reach end of lifetime :type: int | None .. attribute:: soc_min lower soc level of bss :type: float .. attribute:: soc_max upper soc level of bss :type: float .. attribute:: bat2ac_efficiency exponential discharging efficiency values :type: list[float] | None .. attribute:: ac2bss_efficiency exponential charging efficiency values :type: list[float] | None .. attribute:: bss_threshold threshold for bss inverter start :type: float | None .. attribute:: charge_efficiency charging efficiency :type: float | None .. attribute:: discharge_efficiency discharging efficiency :type: float | None .. attribute:: soh state of health :type: float | None .. attribute:: bss_cycles number of cycles accumulated by the battery :type: float | None .. attribute:: e_bat current energy amount stored :type: float | None .. attribute:: e_bss_usable usable energy amount of bss considering ageing :type: float | None .. py:class:: EVData Bases: :py:obj:`BaseDeviceData` Dataclass for eELib EV model. .. attribute:: soc_min minimum soc level of car :type: float .. attribute:: e_max rated energy level of car battery :type: float .. attribute:: p_nom_charge_max maximum charging power of car :type: float .. attribute:: p_nom_discharge_max maximum discharging power of car :type: float .. attribute:: charge_efficiency charge efficiency of car :type: float .. attribute:: dcharge_efficiency discharge efficiency of car :type: float .. attribute:: e_bat energy amount of the car :type: float .. attribute:: appearance where car is available at charging point or not :type: bool .. py:class:: CSData Bases: :py:obj:`BaseDeviceData` Dataclass for eElib charging station model. .. attribute:: charge_efficiency charge efficiency of charging station :type: float .. attribute:: discharge_efficiency discharge efficiency of charging station :type: float .. attribute:: p_rated rated power of charging station :type: float .. attribute:: ev_data information about all the connected electric vehicles, with {ev_id: EVData}. :type: dict .. attribute:: q current reactive power :type: float .. py:class:: HPData Bases: :py:obj:`BaseDeviceData` Dataclass for eElib heatpump model. .. attribute:: p_rated_th rated thermal power of heatpumps :type: float .. attribute:: p_modulation_rel relative minimum power (of rated power) for modulating heatpumps :type: float .. attribute:: time_min minimum on/off-time for heatpumps :type: int .. attribute:: time_on current on-time for heatpumps :type: int .. attribute:: time_off current off-time for heatpumps :type: int .. attribute:: state current state of heatpumps (on, off, must-on or must-off) :type: str .. attribute:: cop current coefficient of power for heatpumps :type: float .. attribute:: p_th current thermal power :type: float .. attribute:: p_th_min minimum thermal power limit (maximum thermal output) :type: float .. attribute:: p_th_mod_start minimum thermal output in on-state :type: float .. attribute:: p_mod_start minimum electrical power limit in on-state :type: float .. attribute:: p_th_max maximum thermal power limit (minimum thermal output) :type: float .. attribute:: q current reactive power :type: float .. py:class:: TESData Bases: :py:obj:`eelib.data.dataclass.BaseData` Dataclass for eELib TES model. .. attribute:: e_tes_rated rated storage capacity of TES, in Wh :type: float .. attribute:: charge_efficiency charge efficiency :type: float .. attribute:: discharge_efficiency discharge efficiency :type: float .. attribute:: loss_rate proportion of lost energy during 24h :type: float .. attribute:: e_tes current energy amount stored, in Wh :type: float .. attribute:: soc current state of charge :type: float .. attribute:: p_th thermal power of TES, in W :type: float .. attribute:: p_th_max max. (charging) thermal power of TES, in W :type: float .. attribute:: p_th_min min. (discharging) thermal power of TES, in W :type: float .. py:class:: PVData Bases: :py:obj:`BaseDeviceData` Dataclass for eElib pv(lib) model. .. attribute:: p_rated rated power of system :type: float .. attribute:: q current reactive power :type: float