Source code for energym.envs.apartments2.apartments2

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