This readme.txt is created on 24.10.2025
GENERAL INFORMATION:
	- Title: Experimental data of three identical residential buildings controlled with different controllers for heating demand response
	- These datasets belong to the published article “Experimental evaluation of model predictive control and fuzzy logic control for demand response in buildings”.
	- Full article: 10.1016/j.apenergy.2025.126666

AUTHORS:
	Erfan Tajalli-Ardekani (erfan.tajalli-ardekani@kit.edu)
	Felix Langner (felix.langner@kit.edu)
	Jovana Kovačević (jovana.kovacevic@kit.edu) 
	Stefan Dietze (stefan.dietze@kit.edu)
	Malte Holzhaeuer (malte.holzhaeuer@kit.edu)
	Tobias Moser (tobias.moser@kit.edu)
	Abdulrahman Seddiqi (abdulrahman.seddiqi@kit.edu) 
	Luigi Spatafora (luigi.spatafora@kit.edu) 
	Simon Waczowicz (simon.waczowicz@kit.edu)
	Hüseyin Kemal Çakmak (hueseyin.cakmak@kit.edu)
	Jörg Matthes (joerg.matthes@kit.edu)
	Veit Hagenmeyer (veit.hagenmeyer@kit.edu)
Affiliation of all authors: Institute for Automation and Applied Informatics, Karlsruhe Institute of Technology, Karlsruhe, Germany.


GENERAL DESCRIPTION:
The following data are collected by running five experiments on three buildings located in the Living Lab Energy Campus (LLEC) Experimental Buildings of the Energy Lab at the Karlsruhe Institute of Technology (KIT). All three buildings have identical building envelopes and are supplied with district heating energy. The purpose of these experiments is to evaluate the performance of three control strategies for heating demand response in nearly identical conditions. For the full description of the experiments, refer to 10.1016/j.apenergy.2025.126666.

GEOGRAPHICAL INFORMATION:
Location of data collection: Karlsruhe Institute of Technology – Campus North, Karlsruhe, Germany
Coordination of data collection site: 49.100330, 8.436564

ENERGY SUPPLY SYSTEM DESCRIPTION:
All buildings (B1, B2 and B3) are supplied by the existing district heating (DH) network of the Karlsruhe Institute of Technology – North Campus. The heat sinks are underfloor heating systems with a similar configuration across all buildings. Ten underfloor heating loops are embedded in each building. Each of Room 1 (R1), Room 2 (R2), Room 3 (R3), Bathroom (B), Corridor (C) and Kitchen (K) has one heating loop, while Room 4 (R4) and Room (R5) have two heating loops (labeled as R4.1, R4.2, R5.1 and R5.2).

FILE OVERVIEW:
A folder is dedicated to each experiment. In each folder, five files exist with the following descriptions:
- "Exp[No.]_heat_flows.csv":
This file contains the supply temperature, return temperature, fluid flow rate, fluid density and the thermal power collected by all the heat flow meters (HFMs) of all buildings. Each building is equipped with eleven HFMs: one HFM to measure the received heat from the district heating (DH) network and ten other HFMs to measure the underfloor heating system's exchanged heat properties. It is worth noting that the flow controlling valves on the underfloor heating loops experience delays of 3 to 5 minutes between receiving the signal from the controller and the actuator completing its task.

- "Exp[No.]_indoor_temperatures.csv":
This file contains the setpoint (Tset) and measured air temperature (Tzone) in each building’s zone. Also, the temperature constraints that controllers are expected not to exceed are included (Tmin and Tmax).


- Exp[No.]_mixing_valves.csv":
This file contains the supply temperature, setpoint temperature and the position of valve opening. The mixing valve mixes the heated fluid stream from the district heating and the return fluid stream from the underfloor heating system. Valve positions are registered in percent (%), where 0% means all flow is from the underfloor heating system return stream and 100% means all flow is from the heated district heating stream.

- Exp[No.]_openings.csv":
This file includes the state of all doors, windows, and roller shutters across all three buildings. Binary values are used, where “0” means closed and “1” means open.

- Exp_[No.]_weather.csv":
The weather data file includes the ambient temperature and pressure, relative humidity, solar radiation, wind speed, and wind direction.
NOTE: The files mentioned above have different sampling intervals, and they are all reported using the ISO timestamp, including the time zone offset from UTC.


EXPERIMENT PERIODS:
- Experiment 1: 22.12.2024 - 28.12.2024
- Experiment 2: 30.12.2024 – 05.01.2025
- Experiment 3: 14.02.2025 – 16.02.2025
- Experiment 4: 10.01.2025 – 12.01.2025
- Experiment 5: 15.01.2025 – 19.01.2025


DATA LABEL DESCRIPTIONS:

Buildings:
- Building 1: B1
- Building 2: B2
- Building 3: B3

Zones/Spaces:
- Corridor of ground floor: C1
- Corridor of top floor: C2
- Kitchen: K
- Bathroom: B
- Room: R

Openings:
- Window: Wnd
- Door: Dr
- Roller Shutter: RS

Directions:
- North: N
- East: E
- South: S
- West: W

Measured Quantities:
- Tret: return temperature [°C]
- Tsup: supply temperature [°C]
- Rho: density [kg/l]
- Flw: flow rate [m3/h]
- Qth: thermal power [W]
- Tzone: zone temperature [°C]
- Tset: setpoint temperature [°C]
- Vp: valve position [%]
- Tamb: ambient temperature [°C]
- Pamb: ambient pressure [hPa]
- RH: relative humidity [%]
- Qsol: solar radiation [W/m2]
- Wd: horizontal wind direction [°]
- Ws: horizontal wind speed [m/s]

Examples:
- “B2_DH_Qth”: thermal power transferred to Building 2 from the district heating network
- “B1_R5.1_Tret”: return temperature of first underfloor heating loop of Room 5 in Building 1
- “B3_B_Tzone”: zone air temperature of the bathroom in Building 3

Funding Resource:
This project is funded by the Helmholtz Association under the Program “Energy System Design”.

