This tool performs advanced energy benchmarking of buildings based on hourly electricity consumption time series. Its main purpose is to evaluate and compare the operational performance of a building against a reference group of peer buildings, selected from a larger population based on similar features of the electrical consumption.
The input data are the followings:
- Hourly electrical energy consumption timeseries: The application accepts hourly electricity consumption data in CSV format.
- Outside air temperature timeseries: The application accepts outside air temperature data in CSV format.
- End-use category of the building: The application accept the end-use category of the building (e.g., Office, Educational, etc.) as a string.
- Floor area of the building: The application accepts the floor area of the building in square meters as a numeric value.
- [Optional] State : The application accepts the state of the building as a string. This is used to obtain the holiday calendar of the building.
If you don’t have the data required, you can still inspect the
application using the buildings given as examples. use the toogle
to select the usage mode.
The benchmarking workflow includes the following key processes:
-
Preprocessing of time series data: Raw electricity consumption data is cleaned through statistical outlier detection and seasonal-trend decomposition using MSTL (Multiple Seasonal-Trend decomposition with Loess). This ensures that the time series is free from inconsistencies and well-prepared for analysis.
-
Peer identification: A critical step that involves extracting meaningful time series features from each building. These include thermal dependency of the electrical load, reference load conditions (e.g., weekdays vs weekends, seasonal groupings), load shape factors, and mean energy consumption. Based on these features, the tool identifies a set of peer buildings that exhibit similar load behaviors.
-
Key Performance Indicators (KPIs) calculation: The application computes a series of KPIs to describe different aspects of energy performance:
-
Energy Use Intensity
-
Operational Schedule Efficiency: evaluate the consumption ratio among working hours, non-working hours and weekends.
-
Load Volatility: evaluates the variability in daily load profiles.
-
Anomaly Detection: Identification of atypical consumption patterns.
-
Load Pattern Frequency: Analysis of the variety and recurrence of load shapes within a specific load condition.
-
-
Benchmarking: Each KPI is benchmarked against the selected set of peers. For each load condition, a performance score for each KPI ranging from 0 to 100 is computed, where 100 indicates best-in-class performance. These scores provide building managers and energy analysts with a clear understanding of how a building performs in each area and where there are opportunities for improvement.
You can install the development version of TimeseriesEnergyBenchmarking from GitHub like so:
# install.packages("devtools")
devtools::install_github("https://github.com/baeda-polito/TimeseriesEnergyBenchmarking")Then you can run the application by simply typing in the console:
library("TimeseriesEnergyBenchmarking")
TimeseriesEnergyBenchmarking::run_app()You can also run the application using Docker. The Docker image can be built using the Dockerfile provided in the repository.
First, clone the repository from GitHub:
git clone https://github.com/baeda-polito/TimeseriesEnergyBenchmarking
cd TimeseriesEnergyBenchmarkingThen, build the Docker image using the following command:
docker build -t timeseries_energy_benchmarking .After the image is built, you can run the application using the following command:
docker run -p 80:80 timeseries_energy_benchmarkingThis will start the application, and you can access it in your web
browser at http://localhost:80.
- Ing. Rocco Giudice, PhD Student at BAEDA Lab, Politecnico di Torino;
- Prof. Alfonso Capozzoli, Coordinator of BAEDA Lab, Politecnico di Torino;
- Prof. Marco Savino Piscitelli, Assistant Prof. at BAEDA Lab, Politecnico di Torino;
This project is licensed under the terms of the MIT license. See the LICENSE file for details.
If you use this package in your research, please cite it as follows:
M.S. Piscitelli, R. Giudice, A. Capozzoli, A holistic time series-based energy benchmarking framework for applications in large stocks of buildings, Applied Energy, 2024, https://doi.org/10.1016/j.apenergy.2023.122550.


