Smart Buildings Dataset SB1-SB11: HVAC Building Automation Time Series

Provider
Goldfeder, Dean, Jiang, Wang, Lipson, Sipple et al. (Google and Columbia University)
License
CC-BY-4.0 (source)
Size
331 files
Format
JSON, NumPy, CSV (in sampled files)
Stored at
Hugging Face (https://huggingface.co/datasets/Jgoldfeder/smart-buildings)
Access
Free and public. No account with the data provider is needed.
Category
Energy
Source
https://arxiv.org/abs/2410.03756

About Smart Buildings Dataset SB1-SB11: HVAC Building Automation Time Series

Operational building automation system (BAS) data from 11 buildings, 2018 to 2026, for HVAC energy modelling, fault detection, forecasting and reinforcement-learning control (Goldfeder et al., arXiv 2410.03756). SB1 to SB3 are Google office buildings in Mountain View, CA at 5-minute steps (2019-2024, 3,136 to 13,610 channels each) with RL-style observations, actions, rewards and reward_info; SB4 to SB6 are academic, residential retrofit and laboratory buildings in Syracuse, NY (1 to 5 minute steps); SB7 to SB11 are campus academic, dining and residence-hall buildings in Needham, MA at 15-minute steps. Channels cover sensors, setpoints, commands and equipment status such as zone air temperature, supply air flow, damper and valve positions and chiller and boiler status, recorded in native units without resampling. Layout: buildings.csv, a shared channel table points.parquet, and SBx/timeseries/ / .parquet wide tables plus irregular and auxiliary tables, provenance.json and floor plans; 331 files, about 6.3 GB. Read with pandas or the included loader.py. Licensed CC BY 4.0 by the authors; SB1-SB3 derive from the Google Smart Buildings data, which should also be credited.

How to load Smart Buildings Dataset SB1-SB11: HVAC Building Automation Time Series in Python

from huggingface_hub import hf_hub_download
path = hf_hub_download(repo_id="Jgoldfeder/smart-buildings", filename="SB1/metadata/floorplan.npy", repo_type="dataset")
print(path)

Data structure

File types in sampled files: JSON, NumPy, CSV

Files

Example file: SB1/metadata/floorplan.npy

Analyze this dataset without downloading it

On Scigantic, Smart Buildings Dataset SB1-SB11: HVAC Building Automation Time Series opens in a hosted JupyterLab notebook with the data already mounted, so you can read files where they are stored instead of copying them first. Each notebook includes an AI assistant that can see the mounted files and write and run analysis code. Open the dataset page to launch a notebook, or browse the full catalog.

This page is also available as Markdown and as JSON.

Related Energy datasets