resstock
Helping states, municipalities, utilities, and manufacturers identify which building stock improvements save the most energy and money.
https://github.com/NatLabRockies/resstock
Category: Consumption
Sub Category: Buildings and Heating
Keywords from Contributors
energy-data building-energy carbon-emissions demand-side-management energy-consumption energy-efficiency buildings energyplus openstudio openstudio-application
Last synced: about 21 hours ago
JSON representation
Repository metadata
Highly granular modeling of residential building stocks at national, regional, and local scales using OpenStudio/EnergyPlus.
- Host: GitHub
- URL: https://github.com/NatLabRockies/resstock
- Owner: NatLabRockies
- License: other
- Created: 2016-04-11T15:37:56.000Z (over 10 years ago)
- Default Branch: develop
- Last Pushed: 2026-08-18T15:22:54.000Z (14 days ago)
- Last Synced: 2026-08-20T01:33:42.584Z (12 days ago)
- Language: Ruby
- Homepage: https://resstock.nlr.gov
- Size: 6.24 GB
- Stars: 147
- Watchers: 24
- Forks: 85
- Open Issues: 94
- Releases: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
README.md
The develop branch is under active development. Find the latest release here.
ResStock™, built on the OpenStudio platform, is a project geared at modeling existing residential building stocks at national, regional, or local scales with a high-degree of granularity (e.g., one physics-based simulation model for every 200 dwelling units), using the EnergyPlus simulation engine. Information about ComStock™, a sister tool for modeling the commercial building stock, can be found here.
This repository contains:
- Housing characteristics of the U.S. residential building stock, in the form of conditional probability distributions stored as tab-separated value (.tsv) files. Comments at the bottom of each file document data sources and assumptions for each.
- A library of housing characteristic "options" that translate high-level characteristic parameters into arguments for OpenStudio measures, and which are referenced by the housing characteristic .tsv files and building energy upgrades defined in project definition files
- Project definition buildstockbatch YML files openable in any text editor for v2.3.0 and later
- Unit-level OpenStudio-HPXML Measures (v3.0.0 and later) for automatically constructing individual representative dwelling unit OpenStudio Models using OpenStudio-HPXML
- Higher-level OpenStudio Measures for controlling simulation inputs and outputs
Software for running ResStock simulations:
- Versions 2.3.0 and later only support the use of buildstockbatch for deploying simulations on high-performance or cloud computing. Version 2.3.0 also removed separate projects for single-family detached and multifamily buildings, in lieu of a combined
project_nationalrepresenting the U.S. residential building stock. See the changelogs for more details. - For large-scale production runs of ResStock, it is recommended that buildstockbatch is used. For smaller-scale tests,
run_analysis.rbcan be used. Information about the workflow can be found in ResStock's documentation.
Owner metadata
- Name: National Laboratory of the Rockies
- Login: NatLabRockies
- Email:
- Kind: organization
- Description:
- Website: http://www.nrel.gov
- Location: Golden, CO
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/1906800?v=4
- Repositories: 599
- Last ynced at: 2026-01-22T09:57:55.744Z
- Profile URL: https://github.com/NatLabRockies
GitHub Events
Total
- Delete event: 6
- Pull request event: 1
- Watch event: 1
- Issue comment event: 1
- Push event: 72
- Pull request review comment event: 3
- Create event: 5
Last Year
- Delete event: 6
- Pull request event: 1
- Watch event: 1
- Issue comment event: 1
- Push event: 72
- Pull request review comment event: 3
- Create event: 5
Committers metadata
Last synced: 11 days ago
Total Commits: 10,328
Total Committers: 43
Avg Commits per committer: 240.186
Development Distribution Score (DDS): 0.524
Commits in past year: 898
Committers in past year: 13
Avg Commits per committer in past year: 69.077
Development Distribution Score (DDS) in past year: 0.649
| Name | Commits | |
|---|---|---|
| Joe Robertson | j****n@n****v | 4919 |
| GitHub Action | g****n | 1610 |
| Rajendra Adhikari | r****e@g****m | 749 |
| aspeake1 | a****e@n****v | 694 |
| Scott Horowitz | s****z@n****v | 688 |
| Anthony Fontanini | a****i@n****v | 644 |
| lixiliu | 3****u | 254 |
| Eric Wilson | e****n@n****v | 124 |
| JLReyna | j****a@n****v | 84 |
| Maharshi Pathak | M****k@n****v | 84 |
| Yingli | y****2@n****v | 76 |
| Andrew Parker | a****2@g****m | 66 |
| jmaguire1 | J****e@n****v | 47 |
| John Alley | j****y@m****u | 34 |
| Noel Merket | n****t@n****v | 32 |
| TobiAdekanye | o****a@a****u | 22 |
| jalley71 | j****y@m****u | 20 |
| Andrew Speake | a****e@e****v | 20 |
| Philip R. White | p****e@u****u | 19 |
| Alex Swindler | A****r@n****v | 18 |
| Jes Brossman | j****n@n****v | 15 |
| Elaina Present | 4****t | 14 |
| ehale | e****e@n****v | 13 |
| Present | e****t@n****v | 13 |
| Katelyn Stenger | k****r@g****m | 11 |
| Nathan Moore | n****e@n****v | 9 |
| mdahlhausen | m****n@g****m | 8 |
| Matt Leach | m****h@n****v | 8 |
| Adhikari | r****r@n****v | 6 |
| Andrew Speake | a****e@e****v | 6 |
| and 13 more... | ||
Committer domains:
- nrel.gov: 18
- kl3.head.cm.kestrel.hpc.nrel.gov: 2
- el1.ib0.cm.hpc.nrel.gov: 2
- mheaney-27690s.nrel.gov: 1
- ewilson-32949s.nrel.gov: 1
- kl1.head.cm.kestrel.hpc.nrel.gov: 1
- login3.hpc.nrel.gov: 1
- login2.hpc.nrel.gov: 1
- el3.ib0.cm.hpc.nrel.gov: 1
- utexas.edu: 1
- el2.ib0.cm.hpc.nrel.gov: 1
- mines.edu: 1
- andrew.cmu.edu: 1
- mymail.mines.edu: 1
Issue and Pull Request metadata
Last synced: 2 days ago
Total issues: 4
Total pull requests: 17
Average time to close issues: N/A
Average time to close pull requests: 2 months
Total issue authors: 3
Total pull request authors: 6
Average comments per issue: 0.0
Average comments per pull request: 0.41
Merged pull request: 7
Bot issues: 0
Bot pull requests: 0
Past year issues: 4
Past year pull requests: 16
Past year average time to close issues: N/A
Past year average time to close pull requests: 2 months
Past year issue authors: 3
Past year pull request authors: 6
Past year average comments per issue: 0.0
Past year average comments per pull request: 0.31
Past year merged pull request: 7
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- rajeee (2)
- mcpigman (1)
- lixiliu (1)
Top Pull Request Authors
- joseph-robertson (7)
- rajeee (3)
- shorowit (3)
- lixiliu (2)
- asparke2 (1)
- rHorsey (1)
Top Issue Labels
Top Pull Request Labels
- DO NOT MERGE (1)
- docs (1)
- bug (1)
Dependencies
- actions/add-to-project v0.3.0 composite
- actions/checkout v3 composite
- actions/download-artifact v3 composite
- actions/upload-artifact v3 composite
- Sphinx * development
- changelog * development
- sphinx-autobuild * development
- sphinx_paramlinks * development
- sphinx_rtd_theme >=1.1.0 development
- sphinxcontrib-programoutput * development
- buildstock_query @ git+https://github.com/NREL/buildstock-query@main
- fsspec *
- geopandas *
- kaleido ==0.2.1
- pandas *
- plotly *
- polars *
- pyarrow *
- s3fs *
- actions/checkout v4 composite
- astral-sh/setup-uv v6 composite
Score: 9.245997049184217