Public Datasets

The ComStock datasets describe the timeseries and annual energy consumption of the U.S. commercial building stock at the end-use level. For more details about data access platforms, structure and contents, visit our external documentation website.

The ComStock GitHub repository contains the source code used to build and execute ComStock models, including upgrade scenarios. In addition, the sampling of building characteristics used for the initial ComStock (V1.0) release is provided. The ComStock model is under active calibration and development, which is publicly visible on this repository.

Visit the FAQ to find answers to frequently asked questions about the dataset and data viewers.

Releases

Select the links below to access the public dataset releases.

Visit the Data Viewer links to access the Data Viewer where you can view the data in customizable time scales and aggregations.
The Open Energy Data Initiative (OEDI) link will take you to folders on OEDI that contain metadata files with individual model characteristics, annual results, pre-aggregated timeseries .csv files for different geographies, weather data in .csv format, geographic information, OpenStudio building energy models, and a data dictionary and enumerations dictionary defining all data fields and parameter options.
Weather year links to the weather files used for the release.

Dataset Notices

ComStock 2024 Release 2 uses an improved sampling method. The OEDI file structure has been modified starting with this release. For details about the new sampling method and file structure, please read the New ComStock Sampling Method explanation.

The utility bills and emissions are incorrectly calculated in ComStock 2024 Release 2. Please see the known issue documentation for additional information.

There are minor discrepancies between files in the “metadata_and_annual_results_aggregates” directory on OEDI in ComStock 2024 Release 2. Please see the known issue documentation for additional information.

Publication Date	Release #	Data Viewer Links	OEDI Data Lake	Building Stock Represented	Upgrades Available **	Weather Year
December 2024	2024_2	by_state	OEDI Data Lake	U.S. commercial sector circa 2018	39	amy2018
March 2024	2024_1	by_state by_puma_northeast by_puma_midwest by_puma_south by_puma_west	OEDI Data Lake	U.S. commercial sector circa 2018	30	amy2018
September 2023	2023_2	by_state	OEDI Data Lake	U.S. commercial sector circa 2018	17	amy2018
March 2023	2023_1	by_state	OEDI Data Lake	U.S. commercial sector circa 2018	9	amy2018
October 2021	2021_1	by_state by_puma_northeast by_puma_midwest by_puma_south by_puma_west	OEDI Data Lake	U.S. commercial sector circa 2018	None	amy2018
October 2021	2021_1	by_state by_puma_northeast by_puma_midwest by_puma_south by_puma_west	OEDI Data Lake	U.S. commercial sector circa 2018	None	tmy3

** Visit the Upgrade Measures page for list of available upgrade measures and measure documentation.

Private Datasets

Datasets that are privately shared can be accessed here:

Public Datasets

Releases

Select the links below to access the public dataset releases.

Dataset Notices

Private Datasets

Your browser is out-of-date!