3. Buildings

This section details the buildings incorporated in Sinergym, separate from the other components that constitute the environment for each experiment. It also provides the default Sinergym observation and action spaces for each building, though these spaces can be customized by the user. The observation variables names would be the base name with each key at the beginning.

Important

To add new buildings to this framework, please refer to the section Adding New Buildings for Environments.

3.1. Datacenter

2ZoneDataCenterHVAC_wEconomizer.epJSON: A 491.3 m2 building divided into two asymmetrical zones (west and east zone). Each zone has an HVAC system consisting of air economizers, evaporative coolers, DX cooling coil, chilled water coil, and VAV units. The main source of heat comes from the hosted servers. The heating and cooling setpoint values are applied simultaneously to both zones.

The default actuators, output and meters variables are:

Actuator	Variable Name	Element Type	Value Type
Heating Setpoints	Heating_Setpoint_RL	Schedule:Compact	Schedule Value
Cooling Setpoints	Cooling_Setpoint_RL	Schedule:Compact	Schedule Value

Variable	Base Variable Name	Keys
Site Outdoor Air Drybulb Temperature	outdoor_temperature	Environment
Site Outdoor Air Relative Humidity	outdoor_humidity	Environment
Site Wind Speed	wind_speed	Environment
Site Wind Direction	wind_direction	Environment
Site Diffuse Solar Radiation Rate per Area	diffuse_solar_radiation	Environment
Site Direct Solar Radiation Rate per Area	direct_solar_radiation	Environment
Zone Thermostat Heating Setpoint Temperature	htg_setpoint	West Zone, East Zone
Zone Thermostat Cooling Setpoint Temperature	clg_setpoint	West Zone, East Zone
Zone Air Temperature	air_temperature	West Zone, East Zone
Zone Air Relative Humidity	air_humidity	West Zone, East Zone
Zone Thermal Comfort Mean Radiant Temperature	thermal_comfort_mean_radiant_temperature	West Zone PEOPLE, East Zone PEOPLE
Zone Thermal Comfort Clothing Value	thermal_comfort_clothing_value	West Zone PEOPLE, East Zone PEOPLE
Zone Thermal Comfort Fanger Model PPD	thermal_comfort_fanger_model_ppd	West Zone PEOPLE, East Zone PEOPLE
Zone People Occupant Count	people_occupant	West Zone, East Zone
People Air Temperature	people_air_temperature	West Zone PEOPLE, East Zone PEOPLE
Facility Total HVAC Electricity Demand Rate	HVAC_electricity_demand_rate	Whole Building

Warning

Since the update to EnergyPlus version 23.1.0, it appears that temperature setpoints are not correctly applied in the East zone. The issue is currently under investigation. In the meantime, the default reward functions only apply to the control of the West zone to maintain result consistency. For more information about this issue, visit #395.

3.2. Small Datacenter

1ZoneDataCenterCRAC_wApproachTemp.epJSON: This file demonstrates a simple data center model with air-cooled IT equipment (ITE) served by a CRAC system. The air-cooled ITE illustrates the user of various schedules and curves to vary server power use. The CRAC system has been setup to represent a Lieber DSE 125 with pumped refrigerant economizer DX cooling coil system.Fictional 1 zone building with resistive walls. No windows. Data Center server ITE object for internal gains. No internal mass. The building is oriented due north.

The default actuators, output and meters variables are:

Actuator	Variable Name	Element Type	Value Type
COOLING RETURN AIR SETPOINT SCHEDULE	Cooling_Setpoint_RL	Schedule:Compact	Schedule Value
SUPPLY AIR SETPOINT SCHEDULE	Supply_Air_RL	Schedule:Compact	Schedule Value

Variable	Base Variable Name	Key
Site Outdoor Air Drybulb Temperature	outdoor_temperature	Environment
Site Outdoor Air Relative Humidity	outdoor_humidity	Environment
Site Wind Speed	wind_speed	Environment
Site Wind Direction	wind_direction	Environment
Site Diffuse Solar Radiation Rate per Area	diffuse_solar_radiation	Environment
Site Direct Solar Radiation Rate per Area	direct_solar_radiation	Environment
Zone Thermostat Heating Setpoint Temperature	htg_setpoint	Main Zone
Zone Thermostat Cooling Setpoint Temperature	clg_setpoint	Main Zone
Zone Air Temperature	air_temperature	Main Zone
Zone Air Relative Humidity	air_humidity	Main Zone
Cooling Coil Electricity Rate	cooling_coil_demand_rate	MAIN COOLING COIL 1
Fan Electricity Rate	fan_demand_rate	EC PLUG FAN 1
ITE UPS Electricity Rate	ups_demand_rate	DATA CENTER SERVERS
ITE Fan Electricity Rate	ite_fan_demand_rate	DATA CENTER SERVERS
ITE CPU Electricity Rate	cpu_demand_rate	DATA CENTER SERVERS
Facility Total HVAC Electricity Demand Rate	HVAC_electricity_demand_rate	Whole Building
Facility Total Building Electricity Demand Rate	building_electricity_demand_rate	Whole Building
Facility Total Electricity Demand Rate	total_electricity_demand_rate	Whole Building

3.3. 5Zone

5ZoneAutoDXVAV.epJSON: A single-story building divided into 5 zones (1 indoor and 4 outdoor). Its surface area is 463.6 m2, and it is equipped with a VAV package (DX cooling coil and gas heating coils) with fully auto-sized input as the HVAC system to be controlled.

The default actuators, output and meters variables are:

Actuator	Variable Name	Element Type	Value Type
HTG-SETP-SCH	Heating_Setpoint_RL	Schedule:Compact	Schedule Value
CLG-SETP-SCH	Cooling_Setpoint_RL	Schedule:Compact	Schedule Value

Variable	Base Variable Name	Key
Site Outdoor Air DryBulb Temperature	outdoor_temperature	Environment
Site Outdoor Air Relative Humidity	outdoor_humidity	Environment
Site Wind Speed	wind_speed	Environment
Site Wind Direction	wind_direction	Environment
Site Diffuse Solar Radiation Rate per Area	diffuse_solar_radiation	Environment
Site Direct Solar Radiation Rate per Area	direct_solar_radiation	Environment
Zone Thermostat Heating Setpoint Temperature	htg_setpoint	SPACE5-1
Zone Thermostat Cooling Setpoint Temperature	clg_setpoint	SPACE5-1
Zone Air Temperature	air_temperature	SPACE5-1
Zone Air Relative Humidity	air_humidity	SPACE5-1
Zone People Occupant Count	people_occupant	SPACE5-1
Environmental Impact Total CO2 Emissions Carbon Equivalent Mass	co2_emission	site
Facility Total HVAC Electricity Demand Rate	HVAC_electricity_demand_rate	Whole Building

Meter	Variable Name
Electricity:HVAC	total_electricity_HVAC

3.4. Warehouse

ASHRAE9012016_Warehouse.epJSON: It is a non-residential 4598 m2 floor building, divided into 3 zones: bulk storage, fine storage and an office. The Office zone is enclosed on two sides and at the top by the Fine Storage zone, and it is the unique zone with windows. Available fuel types are gas and electricity, and it is equipped with HVAC system.

The default actuators, output and meters variables are:

Actuator	Variable Name	Element Type	Value Type
Office Heating Schedule	Office_Heating_RL	Schedule:Year	Schedule Value
Office Cooling Schedule	Office_Cooling_RL	Schedule:Year	Schedule Value

Variable	Base Variable Name	Key
Site Outdoor Air DryBulb Temperature	outdoor_temperature	Environment
Site Outdoor Air Relative Humidity	outdoor_humidity	Environment
Site Wind Speed	wind_speed	Environment
Site Wind Direction	wind_direction	Environment
Site Diffuse Solar Radiation Rate per Area	diffuse_solar_radiation	Environment
Site Direct Solar Radiation Rate per Area	direct_solar_radiation	Environment
Zone Thermostat Heating Setpoint Temperature	htg_setpoint	Zone1 Office, Zone2 Fine Storage, Zone3 Bulk Storage
Zone Thermostat Cooling Setpoint Temperature	clg_setpoint	Zone1 Office, Zone2 Fine Storage
Zone Air Temperature	air_temperature	Zone1 Office, Zone2 Fine Storage, Zone3 Bulk Storage
Zone Air Relative Humidity	air_humidity	Zone1 Office, Zone2 Fine Storage, Zone3 Bulk Storage
Zone People Occupant Count	people_occupant	Zone1 Office
Facility Total HVAC Electricity Demand Rate	HVAC_electricity_demand_rate	Whole Building

3.5. OfficeMedium

ASHRAE9012016_OfficeMedium.epJSON: It is a 4979.6 m2 building with 3 floors. Each floor has four perimeter zones and one core zone. Available fuel types are gas and electricity, and it is equipped with HVAC system.

The default actuators, output and meters variables are:

Actuator	Variable Name	Element Type	Value Type
HTGSETP_SCH_YES_OPTIMUM	Office_Heating_RL	Schedule:Compact	Schedule Value
CLGSETP_SCH_YES_OPTIMUM	Office_Cooling_RL	Schedule:Compact	Schedule Value

Variable	Base Variable Name	Key
Site Outdoor Air DryBulb Temperature	outdoor_temperature	Environment
Site Outdoor Air Relative Humidity	outdoor_humidity	Environment
Site Wind Speed	wind_speed	Environment
Site Wind Direction	wind_direction	Environment
Site Diffuse Solar Radiation Rate per Area	diffuse_solar_radiation	Environment
Site Direct Solar Radiation Rate per Area	direct_solar_radiation	Environment
Zone Thermostat Heating Setpoint Temperature	htg_setpoint	Core_bottom
Zone Thermostat Cooling Setpoint Temperature	clg_setpoint	Core_bottom
Zone Air Temperature	air_temperature	Core_bottom, Core_mid, Core_top, FirstFloor_Plenum, MidFloor_Plenum, TopFloor_Plenum, Perimeter_bot_ZN_1, Perimeter_bot_ZN_2, Perimeter_bot_ZN_3, Perimeter_bot_ZN_4, Perimeter_mid_ZN_1, Perimeter_mid_ZN_2, Perimeter_mid_ZN_3, Perimeter_mid_ZN_4, Perimeter_top_ZN_1, Perimeter_top_ZN_2, Perimeter_top_ZN_3, Perimeter_top_ZN_4
Zone Air Relative Humidity	air_humidity	Core_bottom, Core_mid, Core_top, FirstFloor_Plenum, MidFloor_Plenum, TopFloor_Plenum, Perimeter_bot_ZN_1, Perimeter_bot_ZN_2, Perimeter_bot_ZN_3, Perimeter_bot_ZN_4, Perimeter_mid_ZN_1, Perimeter_mid_ZN_2, Perimeter_mid_ZN_3, Perimeter_mid_ZN_4, Perimeter_top_ZN_1, Perimeter_top_ZN_2, Perimeter_top_ZN_3, Perimeter_top_ZN_4
Facility Total HVAC Electricity Demand Rate	HVAC_electricity_demand_rate	Whole Building

3.6. ShopWithVanBattery

ShopWithVanBattery.epJSON: It is a 390.2 m2 building, with only one floor. It has five zones; four of them are perimeter zones and one in the center. This is a low-energy building with photovoltaic panel and electrical storage. It demonstrates the use of the battery model for electrical storage. It has a full HVAC model and water heating service. This is a small repair shop. Open Monday through Friday, 45 hours per week.

The default actuators, output and meters variables are:

Actuator	Variable Name	Element Type	Value Type
HTGSETP_SCH	Heating_Setpoint_RL	Schedule:Compact	Schedule Value
CLGSETP_SCH	Cooling_Setpoint_RL	Schedule:Compact	Schedule Value

Variable	Base Variable Name	Key
Site Outdoor Air Drybulb Temperature	outdoor_temperature	Environment
Site Outdoor Air Relative Humidity	outdoor_humidity	Environment
Site Wind Speed	wind_speed	Environment
Site Wind Direction	wind_direction	Environment
Site Diffuse Solar Radiation Rate per Area	diffuse_solar_radiation	Environment
Site Direct Solar Radiation Rate per Area	direct_solar_radiation	Environment
Zone Thermostat Heating Setpoint Temperature	htg_setpoint	ZN_1_FLR_1_SEC_5
Zone Thermostat Cooling Setpoint Temperature	clg_setpoint	ZN_1_FLR_1_SEC_5
Electric Storage Battery Charge State	storage_battery_charge_state	Kibam
Electric Storage Charge Energy	storage_charge_energy	Kibam
Electric Storage Charge Power	storage_charge_power	Kibam
Electric Storage Discharge Energy	storage_discharge_energy	Kibam
Electric Storage Discharge Power	storage_discharge_power	Kibam
Electric Storage Thermal Loss Energy	storage_thermal_loss_energy	Kibam
Electric Storage Thermal Loss Rate	storage_thermal_loss_rate	Kibam
Zone Air Temperature	air_temperature	ZN_1_FLR_1_SEC_1, ZN_1_FLR_1_SEC_2, ZN_1_FLR_1_SEC_3, ZN_1_FLR_1_SEC_4, ZN_1_FLR_1_SEC_5
Zone Air Relative Humidity	air_humidity	ZN_1_FLR_1_SEC_1, ZN_1_FLR_1_SEC_2, ZN_1_FLR_1_SEC_3, ZN_1_FLR_1_SEC_4, ZN_1_FLR_1_SEC_5
Zone People Occupant Count	people_count	ZN_1_FLR_1_SEC_1, ZN_1_FLR_1_SEC_2, ZN_1_FLR_1_SEC_3, ZN_1_FLR_1_SEC_4, ZN_1_FLR_1_SEC_5
Facility Total HVAC Electricity Demand Rate	HVAC_electricity_demand_rate	Whole Building

3.7. OfficeGridStorageSmoothing

OfficeGridStorageSmoothing.epJSON: It is a large office building with 12 floors and a basement, with a rectangular aspect and 46,320 m2. The building is organized in 19 zones: the basement, bot, mid and top level. Each level has a core zone and 4 perimeter zones. Floor zone is described for bot, mid and top level too. It has a battery control for charging and discharging from the grid.

The default actuators, output and meters variables are:

Actuator	Variable Name	Element Type	Value Type
HTGSETP_SCH	Heating_Setpoint_RL	Schedule:Compact	Schedule Value
CLGSETP_SCH	Cooling_Setpoint_RL	Schedule:Compact	Schedule Value
Charge Schedule	Charge_Rate_RL	Schedule:Compact	Schedule Value
Discharge Schedule	Discharge_Rate_RL	Schedule:Compact	Schedule Value

Variable	Base Variable Name	Keys
Site Outdoor Air DryBulb Temperature	outdoor_temperature	Environment
Site Outdoor Air Relative Humidity	outdoor_humidity	Environment
Site Wind Speed	wind_speed	Environment
Site Wind Direction	wind_direction	Environment
Site Diffuse Solar Radiation Rate per Area	diffuse_solar_radiation	Environment
Site Direct Solar Radiation Rate per Area	direct_solar_radiation	Environment
Zone Thermostat Heating Setpoint Temperature	htg_setpoint	Basement
Zone Thermostat Cooling Setpoint Temperature	clg_setpoint	Basement
Zone Air Temperature	air_temperature	Multiple Keys
Zone Air Relative Humidity	air_humidity	Multiple Keys
Zone People Occupant Count	people_count	Multiple Keys
Electric Storage Simple Charge State	battery_charge_state	Battery
Facility Total HVAC Electricity Demand Rate	HVAC_electricity_demand_rate	Whole Building