Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

ComStock

National scale modeling of the U.S. commercial building stock supported by U.S. DOE, LADWP, and others and maintained by NREL.
https://github.com/nrel/comstock

Category: Consumption
Sub Category: Buildings and Heating

Keywords from Contributors

energyplus openstudio openstudio-coalition openstudio-sdk openstudio-application openstudio-models qt

Last synced: about 1 hour ago
JSON representation

Repository metadata

National scale modeling of the U.S. commercial building stock supported by U.S. DOE, LADWP, and others and maintained by NREL

README.md

ComStock

ComStock is an NREL model of the U.S. commercial building stock. The model takes some building characteristics from the
U.S. Department of Energy's (DOE's) Commercial Prototype Building Models and Commercial Reference Building. However,
unlike many other building stock models, ComStock also combines these with a variety of additional public- and
private-sector data sets. Collectively, this information provides high-fidelity building stock representation with a
realistic diversity of building characteristics.

This repository contains the source code used to build and execute ComStock models, including upgrade scenarios. In
addition, the sampling of buildings 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.

Execution of the ComStock workflow is managed through the buildstockbatch repository, a shared asset of ResStock and ComStock,
specifically developed to scale to execution of tens of millions of simulations through multiple infrastructure
providers.

The dataset output from the initial ComStock (V1.0) release can be found at the accompanying
ComStock data viewer website and additional information about ComStock found on the
NREL Buildings Website. For more details about ongoing model development
please consult the End Use Load Profiles website.

ComStock is a direct result of the NREL residential stock modeling tool
ResStock (recipient of a
R&D100 award)
and was inspired by the high-fidelity solar & storage adoption model dGen.
Additionally, this tool would not be possible without the decades of work undertaken by the
OpenStudio and EnergyPlus visionaries and contributors,
significant funding, feedback and support from the Los Angeles Department of Water and Power,
and the Department of Energy's Building Technology Office
ongoing support of and investment in building energy modeling software.

Directories

  • /build contains instructions for building Singularity images for running ComStock on HPC systems.
  • /documentation contains LaTeX documentation and instructions for building the documentation.
  • /measures contains the high-level "meta" measures used to call other measures, and the reporting measures used to summarize outputs.
  • /national contains seed directories necessary for a ComStock run using buildstockbatch.
  • /postprocessing contains postprocessing scripts to create graphics for viewing results and comparing to other data sources.
  • /resources contains workflow and upgrade measures
  • /samples contains sample buildstock.csv files, which describe the set of models included in a run.
  • /sampling contains instructions and code to generate buildstock.csv files.
  • /ymls contains sample .yml files, which are the configuration files used to execture a ComStock run with buildstockbatch.

Usage

ComStock is under an open source license. See LICENSE.txt in this directory.
You are welcome to use this repository for your own use. However, we do not provide technical support. Please refer to our technical assistance documentation instead. We strongly suggest and support using the public datasets instead of attempting to run millions of building energy models yourself.

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 11 days ago

Total Commits: 1,544
Total Committers: 20
Avg Commits per committer: 77.2
Development Distribution Score (DDS): 0.828

Commits in past year: 765
Committers in past year: 17
Avg Commits per committer in past year: 45.0
Development Distribution Score (DDS) in past year: 0.776

Name Email Commits
JanghyunJK j****m@n****v 265
Matthew Dahlhausen m****n@g****m 199
Praprost m****s@n****v 190
Landan Taylor l****r@n****v 162
Xiong j****g@n****v 142
Eric Ringold e****d@g****m 134
Andrew Parker a****2@g****m 128
Wenyi Kuang w****g@n****v 85
Chris CaraDonna 5****a 77
Ry Horsey h****y@g****m 54
CaraDonna c****n@n****v 37
Amy Van Sant 4****r 15
Allen a****n@n****v 15
David Goldwasser d****r@n****v 13
Eric Bonnema e****a@n****v 10
Alex Swindler A****r@n****v 6
carlobianchi89 c****i@u****u 4
Marley Praprost 4****t 3
Amy Allen a****n@c****u 3
Lauren Klun 6****n 2

Committer domains:

Issue and Pull Request metadata

Last synced: 5 days ago

Total issues: 128
Total pull requests: 479
Average time to close issues: 7 months
Average time to close pull requests: 19 days
Total issue authors: 20
Total pull request authors: 15
Average comments per issue: 0.33
Average comments per pull request: 0.45
Merged pull request: 324
Bot issues: 0
Bot pull requests: 0

Past year issues: 34
Past year pull requests: 205
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 11 days
Past year issue authors: 12
Past year pull request authors: 14
Past year average comments per issue: 0.15
Past year average comments per pull request: 0.35
Past year merged pull request: 125
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/nrel/comstock

Top Issue Authors

  • mdahlhausen (40)
  • asparke2 (19)
  • eringold (18)
  • JanghyunJK (9)
  • mpraprost (7)
  • wenyikuang (7)
  • ChristopherCaradonna (5)
  • mcpigman (4)
  • JieXiong9119 (3)
  • laurenklun (2)
  • amylebar (2)
  • jmarrec (2)
  • natbprice (2)
  • DavidGoldwasser (2)
  • invisibleroads (1)

Top Pull Request Authors

  • JanghyunJK (76)
  • ChristopherCaradonna (74)
  • mpraprost (61)
  • mdahlhausen (54)
  • LandanT (36)
  • wenyikuang (35)
  • eringold (33)
  • JieXiong9119 (30)
  • amyeallen1 (23)
  • asparke2 (21)
  • rHorsey (17)
  • amylebar (12)
  • laurenklun (3)
  • kflemin (2)
  • ekpresent (2)

Top Issue Labels

  • bug (20)
  • enhancement (20)
  • postprocessing (19)
  • reporting measure (13)
  • workflow measure (7)
  • infrastructure (4)
  • wontfix (4)
  • sampling (3)
  • upgrade measure (2)
  • documentation (2)

Top Pull Request Labels

  • upgrade measure (95)
  • Pull Request - Ready for CI (95)
  • postprocessing (77)
  • reporting measure (56)
  • infrastructure (44)
  • workflow measure (41)
  • documentation (35)
  • bug (29)
  • sampling (15)
  • Do Not Merge (15)
  • enhancement (5)

Package metadata

proxy.golang.org: github.com/NREL/ComStock

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/NREL/ComStock#section-documentation
  • Licenses: other
  • Latest release: v1.0.0 (published about 5 years ago)
  • Last Synced: 2025-12-18T18:06:46.193Z (7 days ago)
  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%
proxy.golang.org: github.com/nrel/comstock

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/nrel/comstock#section-documentation
  • Licenses: other
  • Latest release: v1.0.0 (published about 5 years ago)
  • Last Synced: 2025-12-18T18:06:46.910Z (7 days ago)
  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%

Dependencies

build/singularity/requirements.txt pypi
  • boto3 *
  • requests *

Score: -Infinity