The Building Data Genome 2 (BDG2) Data-Set

Data-set description

BDG2 is an open data set made up of 3,053 energy meters from 1,636 buildings. The time range of the times-series data is the two full years (2016 and 2017) and the frequency is hourly measurements of electricity, heating and cooling water, steam, and irrigation meters. A subset of the data was used in the Great Energy Predictor III (GEPIII) competition hosted by the ASHRAE organization in late 2019. A full overview of the GEPIII competition can be found in a Science and Technology for the Built Environment Journal - Preprint found on arXiv

The GEPIII sub-set includes hourly data from 2,380 meters from 1,449 buildings that were used in a machine learning competition for long-term prediction with an application to measurement and verification in the building energy analysis domain. This data set can be used to benchmark various statistical learning algorithms and other data science techniques. It can also be used simply as a teaching or learning tool to practice dealing with measured performance data from large numbers of non-residential buildings. The charts below illustrate the breakdown of the buildings according to primary use category and subcategory, industry and subindustry, timezone and meter type.

Getting Started

We recommend you download the Anaconda Python Distribution and use Jupyter to get an understanding of the data. - Temporal meters data are found in /data/meters/ - Metadata is found in data/metadata/ - To join all meters raw data into one dataset follow this notebook

Example notebooks are found in /notebooks/ -- a few good overview examples: - Exploratory Data Analysis of metadata - Exploratory Data Analysis of weather - Exploratory Data Analysis of meter reading

Detailed Documentation

The detailed documentation of how this data set was created can be found in the repository's wiki and in the following publication:

Citation of BDG2 Data-Set

• Nature Scientific Data (open access)

Miller, C., Kathirgamanathan, A., Picchetti, B. et al. The Building Data Genome Project 2, energy meter data from the ASHRAE Great Energy Predictor III competition. Sci Data 7, 368 (2020). https://doi.org/10.1038/s41597-020-00712-x

```

@ARTICLE{Miller2020-yc, title = "The Building Data Genome Project 2, energy meter data from the {ASHRAE} Great Energy Predictor {III} competition", author = "Miller, Clayton and Kathirgamanathan, Anjukan and Picchetti, Bianca and Arjunan, Pandarasamy and Park, June Young and Nagy, Zoltan and Raftery, Paul and Hobson, Brodie W and Shi, Zixiao and Meggers, Forrest", abstract = "This paper describes an open data set of 3,053 energy meters from 1,636 non-residential buildings with a range of two full years (2016 and 2017) at an hourly frequency (17,544 measurements per meter resulting in approximately 53.6 million measurements). These meters were collected from 19 sites across North America and Europe, with one or more meters per building measuring whole building electrical, heating and cooling water, steam, and solar energy as well as water and irrigation meters. Part of these data was used in the Great Energy Predictor III (GEPIII) competition hosted by the American Society of Heating, Refrigeration, and Air-Conditioning Engineers (ASHRAE) in October-December 2019. GEPIII was a machine learning competition for long-term prediction with an application to measurement and verification. This paper describes the process of data collection, cleaning, and convergence of time-series meter data, the meta-data about the buildings, and complementary weather data. This data set can be used for further prediction benchmarking and prototyping as well as anomaly detection, energy analysis, and building type classification. Machine-accessible metadata file describing the reported data: https://doi.org/10.6084/m9.figshare.13033847", journal = "Scientific Data", publisher = "Nature Publishing Group", volume = 7, pages = "368", month = oct, year = 2020, language = "en" }

```

Preprints

• arXiv
• ResearchGate

Publications or Projects that use BDG2 data-set

Please update this list if you add notebooks or R-Markdown files to the notebook folder. Naming convention is a number (for ordering), the creator's initials, and a short - delimited description, e.g. 1.0-jqp-initial-data-exploration.

• (publication here)

Repository structure

building-data-genome-project-2 README.md <- BDG2 README for developers using this data-set data | metadata <- buildings metadata | weather <- weather data | meters | raw <- all meter reading datasets | cleaned <- cleaned meter data based on several filtering steps | kaggle <- the 2017 meter data that aligns with the Kaggle competition notebooks <- Jupyter notebooks, named after the naming convention figures <- figures created during exploration of BDG 2.0 Data-set