Apartments2Thermal¶
Apartments2 Thermal is a 8 zones building located in Spain, Tarragona. It has a total surface area of 417.12m2 and a total volume of 1042.83m3.
Thermal systems¶
Apartments2 thermal system consists in four air-to-water heat pumps with integrated water tanks. Each apartment has an individual HVAC system to provide hot water for fan coils heating coils and DHW consumption. Due to system configuration, it is not possible to control (change over time) the HP supply temperature neither storage tanks temperature. This is because DHW consumption profiles have been evaluated taking into account a fixed DHW consumption temperature (50°C).
Electrical systems¶
Regarding the electrical part, Apartments2 system includes a PV array, a community battery and two EV. The first EV is assigned to the second apartment while the second one to the third apartment. In the thermal scenario, community battery and electric vehicles charging are disregarded; see Apartments2Grid.
Controllable components¶
Fan coil control¶
In order to control rooms temperature there is a single set point for each apartment. Set point (thermostat) temperatures of the thermal zones are compared with the actual temperatures sensed with the Energy Management System (EMS) sensors of EnergyPlus. A temperature hysteresis control with a dead band of 0.51°C is implemented with an internal program. The heat provided by the fan coils is directly managed with the EMS actuator Fan Coil Air Mass Flow Rate to mimic an on-off two-stage control. In addition, in order to communicate with the HP, fan coils launch a binary signal each time step, one if heating is needed in the zone or zero for the contrary case.
Heat pump control¶
The user has the possibility to control the on/off mode of the four individual pumps.
No active cooling system is implemented, a free cooling strategy is applied during summer season. This strategy is modelled with an enhanced air infiltration rate from June to September. Summer season in Spain can reach high temperature such as 35°C. This strategy allows maintaining rooms’ temperature into an acceptable range.
Simulation inputs¶
For more detail, please check the documentation The Apartments2 environment or the source code energym.envs.apartments2.apartments2.Apartments2.
Variable Name |
Type |
Lower Bound |
Upper Bound |
# States |
Description |
|---|---|---|---|---|---|
P1_T_Thermostat_sp |
scalar |
16 |
26 |
Floor 1 thermostat setpoint (°C). |
|
P2_T_Thermostat_sp |
scalar |
16 |
26 |
Floor 2 thermostat setpoint (°C). |
|
P3_T_Thermostat_sp |
scalar |
16 |
26 |
Floor 3 thermostat setpoint (°C). |
|
P4_T_Thermostat_sp |
scalar |
16 |
26 |
Floor 4 thermostat setpoint (°C). |
|
P1_onoff_HP_sp |
discrete |
2 |
Heat pump 1 on/off setpoint. |
||
P2_onoff_HP_sp |
discrete |
2 |
Heat pump 2 on/off setpoint. |
||
P3_onoff_HP_sp |
discrete |
2 |
Heat pump 3 on/off setpoint. |
||
P4_onoff_HP_sp |
discrete |
2 |
Heat pump 4 on/off setpoint. |
||
Bd_Ch_EV1Bat_sp |
scalar |
0 |
1 |
EV 1 charging rate setpoint. |
|
Bd_Ch_EV2Bat_sp |
scalar |
0 |
1 |
EV 2 charging rate setpoint. |
Simulation outputs¶
Variable Name |
Type |
Lower Bound |
Upper Bound |
# States |
Description |
|---|---|---|---|---|---|
Ext_T |
scalar |
-10 |
40 |
Outdoor temperature (°C). |
|
Ext_RH |
scalar |
0 |
100 |
Outdoor relative humidity (%RH). |
|
Ext_Irr |
scalar |
0 |
1000 |
Direct normal radiation (W/m2). |
|
Ext_P |
scalar |
80000.0 |
130000.0 |
Outdoor air pressure (Pa). |
|
P3_T_Thermostat_sp_out |
scalar |
16 |
26 |
Floor 3 thermostat setpoint (°C). |
|
P4_T_Thermostat_sp_out |
scalar |
16 |
26 |
Floor 4 thermostat setpoint (°C). |
|
P2_T_Thermostat_sp_out |
scalar |
16 |
26 |
Floor 2 thermostat setpoint (°C). |
|
P1_T_Thermostat_sp_out |
scalar |
16 |
26 |
Floor 1 thermostat setpoint (°C). |
|
Bd_Pw_Bat_sp_out |
scalar |
-1 |
1 |
Battery charging/discharging rate setpoint. |
|
Bd_Ch_EV1Bat_sp_out |
scalar |
0 |
1 |
EV 1 battery charging rate setpoint. |
|
Bd_Ch_EV2Bat_sp_out |
scalar |
0 |
1 |
EV 2 battery charging rate setpoint. |
|
Bd_DisCh_EV1Bat |
scalar |
0 |
1 |
EV 1 battery discharging rate. |
|
Bd_DisCh_EV2Bat |
scalar |
0 |
1 |
EV 2 battery discharging rate. |
|
Bd_Frac_Vent_sp_out |
scalar |
0 |
1 |
Ventilation power fraction. |
|
Z01_E_Appl |
scalar |
0 |
1000 |
Zone 1 appliances energy (Wh). |
|
Z02_E_Appl |
scalar |
0 |
1000 |
Zone 2 appliances energy (Wh). |
|
Z03_E_Appl |
scalar |
0 |
1000 |
Zone 3 appliances energy (Wh). |
|
Z04_E_Appl |
scalar |
0 |
1000 |
Zone 4 appliances energy (Wh). |
|
Z05_E_Appl |
scalar |
0 |
1000 |
Zone 5 appliances energy (Wh). |
|
Z06_E_Appl |
scalar |
0 |
1000 |
Zone 6 appliances energy (Wh). |
|
Z07_E_Appl |
scalar |
0 |
1000 |
Zone 7 appliances energy (Wh). |
|
Z08_E_Appl |
scalar |
0 |
1000 |
Zone 8 appliances energy (Wh). |
|
P1_FlFrac_HW |
scalar |
0 |
1 |
Floor 1 hot water flow fraction. |
|
P2_FlFrac_HW |
scalar |
0 |
1 |
Floor 2 hot water flow fraction. |
|
P3_FlFrac_HW |
scalar |
0 |
1 |
Floor 3 hot water flow fraction. |
|
P4_FlFrac_HW |
scalar |
0 |
1 |
Floor 4 hot water flow fraction. |
|
Z01_T |
scalar |
10 |
40 |
Zone 1 temperature (°C). |
|
Z01_RH |
scalar |
0 |
100 |
Zone 1 relative humidity (%RH). |
|
Z02_T |
scalar |
10 |
40 |
Zone 2 temperature (°C). |
|
Z02_RH |
scalar |
0 |
100 |
Zone 2 relative humidity (%RH). |
|
Z03_T |
scalar |
10 |
40 |
Zone 3 temperature (°C). |
|
Z03_RH |
scalar |
0 |
100 |
Zone 3 relative humidity (%RH). |
|
Z04_T |
scalar |
10 |
40 |
Zone 4 temperature (°C). |
|
Z04_RH |
scalar |
0 |
100 |
Zone 4 relative humidity (%RH). |
|
Z05_T |
scalar |
10 |
40 |
Zone 5 temperature (°C). |
|
Z05_RH |
scalar |
0 |
100 |
Zone 5 relative humidity (%RH). |
|
Z06_T |
scalar |
10 |
40 |
Zone 6 temperature (°C). |
|
Z06_RH |
scalar |
0 |
100 |
Zone 6 relative humidity (%RH). |
|
Z07_T |
scalar |
10 |
40 |
Zone 7 temperature (°C). |
|
Z07_RH |
scalar |
0 |
100 |
Zone 7 relative humidity (%RH). |
|
Z08_T |
scalar |
10 |
40 |
Zone 8 temperature (°C). |
|
Z08_RH |
scalar |
0 |
100 |
Zone 8 relative humidity (%RH). |
|
Fa_Stat_EV1 |
scalar |
0 |
1 |
EV1 status (availability) |
|
Fa_ECh_EV1Bat |
scalar |
0 |
4000.0 |
EV 1 battery charging energy (Wh). |
|
Fa_EDCh_EV1Bat |
scalar |
0 |
4000.0 |
EV 1 battery discharging energy (Wh). |
|
Fa_Stat_EV2 |
scalar |
0 |
1 |
EV2 status (availability) |
|
Fa_ECh_EV2Bat |
scalar |
0 |
4000.0 |
EV 2 battery charging energy (Wh). |
|
Fa_EDCh_EV2Bat |
scalar |
0 |
4000.0 |
EV 2 battery discharging energy (Wh). |
|
Fa_ECh_Bat |
scalar |
0 |
4000.0 |
Battery charging energy (Wh). |
|
Fa_EDCh_Bat |
scalar |
0 |
4000.0 |
Battery discharging energy (Wh). |
|
Bd_FracCh_EV1Bat |
scalar |
0 |
1 |
EV 1 battery state of charge. |
|
Bd_FracCh_EV2Bat |
scalar |
0 |
1 |
EV 2 battery state of charge. |
|
Bd_FracCh_Bat |
scalar |
0 |
1 |
Battery state of charge. |
|
P4_T_Tank |
scalar |
30 |
70 |
Floor 4 tank temperature (°C). |
|
P2_T_Tank |
scalar |
30 |
70 |
Floor 2 tank temperature (°C). |
|
P1_T_Tank |
scalar |
30 |
70 |
Floor 1 tank temperature (°C). |
|
P3_T_Tank |
scalar |
30 |
70 |
Floor 3 tank temperature (°C). |
|
P1_onoff_HP_sp_out |
scalar |
0 |
1 |
Floor 1 heat pump on/off setpoint. |
|
P2_onoff_HP_sp_out |
scalar |
0 |
1 |
Floor 2 heat pump on/off setpoint. |
|
P3_onoff_HP_sp_out |
scalar |
0 |
1 |
Floor 3 heat pump on/off setpoint. |
|
P4_onoff_HP_sp_out |
scalar |
0 |
1 |
Floor 4 heat pump on/off setpoint. |
|
Fa_Pw_All |
scalar |
0 |
30000.0 |
Total power consumption (W). |
|
Fa_Pw_Prod |
scalar |
0 |
10000.0 |
PV power production (W). |
|
Fa_E_self |
scalar |
-20000.0 |
20000.0 |
Self consumption energy (Wh). |
|
Fa_E_HVAC |
scalar |
0 |
30000.0 |
HVAC energy consumption (Wh). |
|
Fa_E_All |
scalar |
0 |
2000.0 |
Total energy consumption (Wh). |
|
Fa_E_Light |
scalar |
0 |
100 |
Lighting energy (Wh). |
|
Fa_E_Appl |
scalar |
0 |
500.0 |
Appliances energy (Wh). |
Weather files¶
The available weather files for this model have the following specifiers:
ESP_CT_Barcelona(Default)ESP_CT_Barcelona_ElPratAP1(Evaluation file)ESP_CT_Barcelona_ElPratAP2ESP_CT_Girona1ESP_CT_Girona2ESP_CT_Lleida1ESP_CT_Lleida2ESP_CT_MontsenyESP_CT_Reus1ESP_CT_Reus2ESP_CT_Sabadell1ESP_CT_Sabadell2ESP_CT_TalarESP_CT_Tortosa1ESP_CT_Tortosa2
Evaluation scenario¶
The evaluation scenario for the Apartments2Thermal-v0 model consists of a control from January to April with the objective of minimizing the grid exchange, while keeping the zone temperatures between 19 and 24°C. For this goal, the tracked KPIs are the average exchanged energy (absolute value of the difference of produced and consumed energy), and the average temperature deviation and total temperature violations with respect to the interval [19, 24].
Notebook example¶
Here is a notebook example: