import datetime
from energym.envs.env_fmu_eplus import EnvEPlusFMU
INPUTS_SPECS = {
"P1_T_Thermostat_sp": {
"type": "scalar",
"lower_bound": 16,
"upper_bound": 26,
"default": 20,
"description": "Floor 1 thermostat setpoint (°C).",
},
"P2_T_Thermostat_sp": {
"type": "scalar",
"lower_bound": 16,
"upper_bound": 26,
"default": 20,
"description": "Floor 2 thermostat setpoint (°C).",
},
"P3_T_Thermostat_sp": {
"type": "scalar",
"lower_bound": 16,
"upper_bound": 26,
"default": 20,
"description": "Floor 3 thermostat setpoint (°C).",
},
"P4_T_Thermostat_sp": {
"type": "scalar",
"lower_bound": 16,
"upper_bound": 26,
"default": 20,
"description": "Floor 4 thermostat setpoint (°C).",
},
"P1_onoff_HP_sp": {
"type": "discrete",
"size": 2,
"default": 1,
"description": "Heat pump 1 on/off setpoint.",
},
"P2_onoff_HP_sp": {
"type": "discrete",
"size": 2,
"default": 1,
"description": "Heat pump 2 on/off setpoint.",
},
"P3_onoff_HP_sp": {
"type": "discrete",
"size": 2,
"default": 1,
"description": "Heat pump 3 on/off setpoint.",
},
"P4_onoff_HP_sp": {
"type": "discrete",
"size": 2,
"default": 1,
"description": "Heat pump 4 on/off setpoint.",
},
"Bd_Pw_Bat_sp": {
"type": "scalar",
"lower_bound": -1,
"upper_bound": 1,
"default": 0,
"description": "Battery charging/discharging rate setpoint.",
},
"Bd_Ch_EV1Bat_sp": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"default": 0,
"description": "EV 1 charging rate setpoint.",
},
"Bd_Ch_EV2Bat_sp": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"default": 0,
"description": "EV 2 charging rate setpoint.",
},
}
OUTPUTS_SPECS = {
"Ext_T": {
"type": "scalar",
"lower_bound": -10,
"upper_bound": 40,
"description": "Outdoor temperature (°C).",
},
"Ext_RH": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 100,
"description": "Outdoor relative humidity (%RH).",
},
"Ext_Irr": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1000,
"description": "Direct normal radiation (W/m2).",
},
"Ext_P": {
"type": "scalar",
"lower_bound": 8e4,
"upper_bound": 1.30e5,
"description": "Outdoor air pressure (Pa).",
},
"P3_T_Thermostat_sp_out": {
"type": "scalar",
"lower_bound": 16,
"upper_bound": 26,
"description": "Floor 3 thermostat setpoint (°C).",
},
"P4_T_Thermostat_sp_out": {
"type": "scalar",
"lower_bound": 16,
"upper_bound": 26,
"description": "Floor 4 thermostat setpoint (°C).",
},
"P2_T_Thermostat_sp_out": {
"type": "scalar",
"lower_bound": 16,
"upper_bound": 26,
"description": "Floor 2 thermostat setpoint (°C).",
},
"P1_T_Thermostat_sp_out": {
"type": "scalar",
"lower_bound": 16,
"upper_bound": 26,
"description": "Floor 1 thermostat setpoint (°C).",
},
"Bd_Pw_Bat_sp_out": {
"type": "scalar",
"lower_bound": -1,
"upper_bound": 1,
"description": "Battery charging/discharging rate setpoint.",
},
"Bd_Ch_EV1Bat_sp_out": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "EV 1 battery charging rate setpoint.",
},
"Bd_Ch_EV2Bat_sp_out": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "EV 2 battery charging rate setpoint.",
},
"Bd_DisCh_EV1Bat": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "EV 1 battery discharging rate.",
},
"Bd_DisCh_EV2Bat": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "EV 2 battery discharging rate.",
},
"Bd_Frac_Vent_sp_out": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "Ventilation power fraction.",
},
"Z01_E_Appl": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1000,
"description": "Zone 1 appliances energy (Wh).",
},
"Z02_E_Appl": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1000,
"description": "Zone 2 appliances energy (Wh).",
},
"Z03_E_Appl": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1000,
"description": "Zone 3 appliances energy (Wh).",
},
"Z04_E_Appl": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1000,
"description": "Zone 4 appliances energy (Wh).",
},
"Z05_E_Appl": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1000,
"description": "Zone 5 appliances energy (Wh).",
},
"Z06_E_Appl": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1000,
"description": "Zone 6 appliances energy (Wh).",
},
"Z07_E_Appl": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1000,
"description": "Zone 7 appliances energy (Wh).",
},
"Z08_E_Appl": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1000,
"description": "Zone 8 appliances energy (Wh).",
},
"P1_FlFrac_HW": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "Floor 1 hot water flow fraction.",
},
"P2_FlFrac_HW": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "Floor 2 hot water flow fraction.",
},
"P3_FlFrac_HW": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "Floor 3 hot water flow fraction.",
},
"P4_FlFrac_HW": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "Floor 4 hot water flow fraction.",
},
"Z01_T": {
"type": "scalar",
"lower_bound": 10,
"upper_bound": 40,
"description": "Zone 1 temperature (°C).",
},
"Z01_RH": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 100,
"description": "Zone 1 relative humidity (%RH).",
},
"Z02_T": {
"type": "scalar",
"lower_bound": 10,
"upper_bound": 40,
"description": "Zone 2 temperature (°C).",
},
"Z02_RH": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 100,
"description": "Zone 2 relative humidity (%RH).",
},
"Z03_T": {
"type": "scalar",
"lower_bound": 10,
"upper_bound": 40,
"description": "Zone 3 temperature (°C).",
},
"Z03_RH": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 100,
"description": "Zone 3 relative humidity (%RH).",
},
"Z04_T": {
"type": "scalar",
"lower_bound": 10,
"upper_bound": 40,
"description": "Zone 4 temperature (°C).",
},
"Z04_RH": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 100,
"description": "Zone 4 relative humidity (%RH).",
},
"Z05_T": {
"type": "scalar",
"lower_bound": 10,
"upper_bound": 40,
"description": "Zone 5 temperature (°C).",
},
"Z05_RH": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 100,
"description": "Zone 5 relative humidity (%RH).",
},
"Z06_T": {
"type": "scalar",
"lower_bound": 10,
"upper_bound": 40,
"description": "Zone 6 temperature (°C).",
},
"Z06_RH": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 100,
"description": "Zone 6 relative humidity (%RH).",
},
"Z07_T": {
"type": "scalar",
"lower_bound": 10,
"upper_bound": 40,
"description": "Zone 7 temperature (°C).",
},
"Z07_RH": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 100,
"description": "Zone 7 relative humidity (%RH).",
},
"Z08_T": {
"type": "scalar",
"lower_bound": 10,
"upper_bound": 40,
"description": "Zone 8 temperature (°C).",
},
"Z08_RH": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 100,
"description": "Zone 8 relative humidity (%RH).",
},
"Fa_Stat_EV1": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "EV1 status (availability)",
},
"Fa_ECh_EV1Bat": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 4e3,
"description": "EV 1 battery charging energy (Wh).",
},
"Fa_EDCh_EV1Bat": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 4e3,
"description": "EV 1 battery discharging energy (Wh).",
},
"Fa_Stat_EV2": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "EV2 status (availability)",
},
"Fa_ECh_EV2Bat": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 4e3,
"description": "EV 2 battery charging energy (Wh).",
},
"Fa_EDCh_EV2Bat": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 4e3,
"description": "EV 2 battery discharging energy (Wh).",
},
"Fa_ECh_Bat": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 4e3,
"description": "Battery charging energy (Wh).",
},
"Fa_EDCh_Bat": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 4e3,
"description": "Battery discharging energy (Wh).",
},
"Bd_FracCh_EV1Bat": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "EV 1 battery state of charge.",
},
"Bd_FracCh_EV2Bat": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "EV 2 battery state of charge.",
},
"Bd_FracCh_Bat": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "Battery state of charge.",
},
"P4_T_Tank": {
"type": "scalar",
"lower_bound": 30,
"upper_bound": 70,
"description": "Floor 4 tank temperature (°C).",
},
"P2_T_Tank": {
"type": "scalar",
"lower_bound": 30,
"upper_bound": 70,
"description": "Floor 2 tank temperature (°C).",
},
"P1_T_Tank": {
"type": "scalar",
"lower_bound": 30,
"upper_bound": 70,
"description": "Floor 1 tank temperature (°C).",
},
"P3_T_Tank": {
"type": "scalar",
"lower_bound": 30,
"upper_bound": 70,
"description": "Floor 3 tank temperature (°C).",
},
"P1_onoff_HP_sp_out": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "Floor 1 heat pump on/off setpoint.",
},
"P2_onoff_HP_sp_out": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "Floor 2 heat pump on/off setpoint.",
},
"P3_onoff_HP_sp_out": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "Floor 3 heat pump on/off setpoint.",
},
"P4_onoff_HP_sp_out": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1,
"description": "Floor 4 heat pump on/off setpoint.",
},
"Fa_Pw_All": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 3e4,
"description": "Total power consumption (W).",
},
"Fa_Pw_Prod": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 1e4,
"description": "PV power production (W).",
},
"Fa_E_self": {
"type": "scalar",
"lower_bound": -2e4,
"upper_bound": 2e4,
"description": "Self consumption energy (Wh).",
},
"Fa_E_HVAC": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 3e4,
"description": "HVAC energy consumption (Wh).",
},
"Fa_E_All": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 2e3,
"description": "Total energy consumption (Wh).",
},
"Fa_E_Light": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 100,
"description": "Lighting energy (Wh).",
},
"Fa_E_Appl": {
"type": "scalar",
"lower_bound": 0,
"upper_bound": 5e2,
"description": "Appliances energy (Wh).",
},
}
default_kpi_options = {
"kpi1": {"name": "Fa_E_self", "type": "avg"},
"kpi2": {"name": "Z01_T", "type": "avg_dev", "target": [19, 24]},
"kpi3": {"name": "Z02_T", "type": "avg_dev", "target": [19, 24]},
"kpi4": {"name": "Z03_T", "type": "avg_dev", "target": [19, 24]},
"kpi5": {"name": "Z04_T", "type": "avg_dev", "target": [19, 24]},
"kpi6": {"name": "Z05_T", "type": "avg_dev", "target": [19, 24]},
"kpi7": {"name": "Z06_T", "type": "avg_dev", "target": [19, 24]},
"kpi8": {"name": "Z07_T", "type": "avg_dev", "target": [19, 24]},
"kpi9": {"name": "Z08_T", "type": "avg_dev", "target": [19, 24]},
"kpi10": {"name": "Z01_T", "type": "tot_viol", "target": [19, 24]},
"kpi11": {"name": "Z02_T", "type": "tot_viol", "target": [19, 24]},
"kpi12": {"name": "Z03_T", "type": "tot_viol", "target": [19, 24]},
"kpi13": {"name": "Z04_T", "type": "tot_viol", "target": [19, 24]},
"kpi14": {"name": "Z05_T", "type": "tot_viol", "target": [19, 24]},
"kpi15": {"name": "Z06_T", "type": "tot_viol", "target": [19, 24]},
"kpi16": {"name": "Z07_T", "type": "tot_viol", "target": [19, 24]},
"kpi17": {"name": "Z08_T", "type": "tot_viol", "target": [19, 24]},
}
[docs]class Apartments2(EnvEPlusFMU):
"""Containing information for the models Apartments2Thermal-v0 and Apartments2Grid-v0.
Subclasses EnvEPlusFMU and inherits its behavior. Simulation based details are
specified in this class and passed to the constructor of EnvEPlusFMU.
Attributes
-----------
EV_schedule : ElectricVehicleSchedule
Energy consumption schedule for electric vehicles
Methods
--------
step(inputs):
Advances the simulation one timestep.
predict_ev(steps):
Provides a forecast for the EV schedule.
"""
def __init__(
self,
model_path,
EV1_schedule,
EV2_schedule,
start_day=1,
start_month=1,
year=2019,
simulation_days=10,
weather="ESP_CT_Barcelona",
kpi_options=None,
default_path=True,
generate_forecasts=True,
generate_forecast_method="perfect",
generate_forecast_keys=None,
):
"""
Parameters
----------
model_path : str
Specifies the path to the FMU
EV_schedule : ElectricVehicleSchedule
Energy consumption schedule for electric vehicles
start_day : int, optional
Day of the month to start the simulation, by default 1
start_month : int, optional
Month of the year to start the simulation, by default 1
year : int, optional
Year to start the simulation, by default 2019
simulation_days : int, optional
Number of days the simulation can run for, by default 10
weather : str, optional
Specific weather file to run the simulation, by default
"ESP_CT_Barcelona"
kpi_options : dict, optional
Dict to specify the tracked KPIs, by default None.
"""
n_steps = 20
step_size = 3 * 60
start_date = datetime.date(year, start_month, start_day)
delta = start_date - datetime.date(year, 1, 1)
start_time = delta.total_seconds()
stop_time = start_time + n_steps * 24 * simulation_days * step_size
if kpi_options is None:
kpi_options = default_kpi_options
self.EV1_schedule = EV1_schedule
self.EV2_schedule = EV2_schedule
super().__init__(
model_path,
start_time,
stop_time,
step_size,
weather,
INPUTS_SPECS,
OUTPUTS_SPECS,
kpi_options,
default_path,
generate_forecasts,
generate_forecast_method,
generate_forecast_keys,
)
def step(self, inputs):
"""Advances the simulation one timestep.
Calls the step() method of EnvFMU.
Parameters
----------
inputs : dict
Inputs for the system. Keys are input names, values are iterables of input values.
If not defined, assumes no inputs required.
Returns
-------
out : dict
Outputs for the system.
"""
minute, hour, day, month = self.get_date()
date = datetime.datetime(2019, month, day, hour, minute)
ev1_val = self.EV1_schedule.get(date)
ev2_val = self.EV2_schedule.get(date)
inputs["Bd_DisCh_EV1Bat_sp"] = [ev1_val]
inputs["Bd_DisCh_EV1Bat_sp"] = [ev2_val]
out = super().step(inputs=inputs)
return out
def predict_ev(self, steps):
"""Provides a forecast for the EV schedule.
Parameters
----------
steps : int
Number of forecast steps.
Returns
-------
predictions : list
List of predicted values.
"""
minute, hour, day, month = self.get_date()
date = datetime.datetime(2019, month, day, hour, minute)
predictions = {"Bd_DisCh_EV1Bat": [], "Bd_DisCh_EV2Bat": []}
for _ in range(steps):
predictions["Bd_DisCh_EV1Bat"].append(
self.EV1_schedule.predict(date)
) # Same name as outputs
predictions["Bd_DisCh_EV2Bat"].append(
self.EV2_schedule.predict(date)
) # Same name as outputs
date = date + datetime.timedelta(minutes=3)
return predictions
def get_forecast(self, forecast_length=24, **kwargs):
forecasts = super().get_forecast(forecast_length, **kwargs)
print(forecasts)
predictions = self.predict_ev(steps=forecast_length)
forecasts = {**forecasts, **predictions}
return forecasts