resstock
Helping states, municipalities, utilities, and manufacturers identify which building stock improvements save the most energy and money.
https://github.com/NREL/resstock
Category: Consumption
Sub Category: Buildings and Heating
Keywords from Contributors
energy-data buildings energyplus openstudio openstudio-application openstudio-coalition openstudio-models openstudio-sdk qt building-energy
Last synced: about 22 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/NREL/resstock
- Owner: NREL
- License: other
- Created: 2016-04-11T15:37:56.000Z (almost 10 years ago)
- Default Branch: develop
- Last Pushed: 2025-10-28T18:31:20.000Z (3 months ago)
- Last Synced: 2025-10-28T19:24:53.728Z (3 months ago)
- Language: Ruby
- Homepage: https://resstock.nrel.gov
- Size: 6.02 GB
- Stars: 132
- Watchers: 25
- Forks: 81
- Open Issues: 88
- Releases: 19
-
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 Renewable Energy Laboratory
- Login: NREL
- 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: 2024-12-18T09:41:07.898Z
- Profile URL: https://github.com/NREL
GitHub Events
Total
- Create event: 143
- Commit comment event: 1
- Release event: 2
- Delete event: 138
- Member event: 3
- Pull request event: 229
- Fork event: 30
- Issues event: 47
- Watch event: 20
- Issue comment event: 119
- Push event: 1815
- Gollum event: 4
- Pull request review comment event: 258
- Pull request review event: 285
Last Year
- Fork event: 29
- Create event: 134
- Release event: 2
- Issues event: 44
- Watch event: 19
- Delete event: 133
- Member event: 3
- Issue comment event: 107
- Push event: 1760
- Gollum event: 4
- Pull request review event: 280
- Pull request review comment event: 255
- Pull request event: 219
Committers metadata
Last synced: 3 months ago
Total Commits: 9,643
Total Committers: 43
Avg Commits per committer: 224.256
Development Distribution Score (DDS): 0.507
Commits in past year: 1,787
Committers in past year: 18
Avg Commits per committer in past year: 99.278
Development Distribution Score (DDS) in past year: 0.749
| Name | Commits | |
|---|---|---|
| Joe Robertson | j****n@n****v | 4753 |
| GitHub Action | g****n | 1499 |
| aspeake1 | a****e@n****v | 693 |
| Anthony Fontanini | a****i@n****v | 644 |
| Scott Horowitz | s****z@n****v | 591 |
| Rajendra Adhikari | r****e@g****m | 514 |
| lixiliu | 3****u | 247 |
| 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 | 58 |
| jmaguire1 | J****e@n****v | 47 |
| Andrew Parker | a****2@g****m | 34 |
| 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 |
| Alex Swindler | A****r@n****v | 18 |
| Philip R. White | p****e@u****u | 16 |
| ehale | e****e@n****v | 13 |
| Present | e****t@n****v | 13 |
| Present | 4****t | 12 |
| Katelyn Stenger | k****r@g****m | 10 |
| 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 |
| Andrew Speake | a****e@e****v | 4 |
| 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: 3 months ago
Total issues: 381
Total pull requests: 1,290
Average time to close issues: 8 months
Average time to close pull requests: about 1 month
Total issue authors: 41
Total pull request authors: 30
Average comments per issue: 2.06
Average comments per pull request: 0.91
Merged pull request: 939
Bot issues: 0
Bot pull requests: 0
Past year issues: 33
Past year pull requests: 262
Past year average time to close issues: about 2 months
Past year average time to close pull requests: 16 days
Past year issue authors: 12
Past year pull request authors: 13
Past year average comments per issue: 0.82
Past year average comments per pull request: 0.38
Past year merged pull request: 165
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- joseph-robertson (139)
- shorowit (64)
- ejhw (34)
- afontani (23)
- ekpresent (22)
- lixiliu (14)
- jmaguire1 (11)
- aspeake (9)
- rajeee (8)
- whiphi92 (7)
- sudeepy (4)
- mcpigman (4)
- nmerket (4)
- jmarrec (3)
- jbrossman (3)
Top Pull Request Authors
- joseph-robertson (705)
- shorowit (131)
- afontani (103)
- rajeee (92)
- lixiliu (50)
- aspeake (47)
- yingli-NREL (28)
- ejhw (26)
- JLReyna (14)
- vtnate (11)
- whiphi92 (11)
- mpathak24 (9)
- jmaguire1 (8)
- ekpresent (7)
- TobiAdekanye (6)
Top Issue Labels
- enhancement (41)
- bug (27)
- priority low (24)
- priority high (22)
- priority medium (19)
- input data (11)
- help wanted (10)
- waiting on others (9)
- docs (6)
- question (4)
- priority lowest (3)
- priority highest (2)
- GEB (2)
- feature (2)
- load modeling (1)
Top Pull Request Labels
- DO NOT MERGE (105)
- bug (65)
- enhancement (18)
- docs (17)
- OS-HPXML Backport (16)
- feature (7)
- waiting on others (4)
- priority high (3)
- in progress (2)
- priority low (2)
- GEB (2)
- refactor (2)
- help wanted (1)
- priority highest (1)
- input data (1)
Dependencies
- actions/add-to-project v0.3.0 composite
- actions/checkout v3 composite
- actions/download-artifact v3 composite
- actions/upload-artifact v3 composite
- minitest ~> 5.9
- minitest-reporters >= 0
- msgpack >= 0
- nokogiri ~> 1.10
- oga >= 0
- parallel >= 0
- rake >= 0
- rubyzip >= 0
- simplecov >= 0
- simplecov-html >= 0
- ansi 1.5.0
- ast 2.4.2
- builder 3.2.4
- docile 1.4.0
- minitest 5.14.4
- minitest-reporters 1.4.3
- msgpack 1.5.1
- nokogiri 1.12.5
- oga 3.3
- parallel 1.21.0
- racc 1.6.0
- rake 13.0.6
- ruby-ll 2.1.2
- ruby-progressbar 1.11.0
- rubyzip 2.3.2
- simplecov 0.21.2
- simplecov-html 0.12.3
- simplecov_json_formatter 0.1.3
- minitest = 5.15
- minitest-reporters >= 0
- msgpack >= 0
- oga >= 0
- parallel >= 0
- rake >= 0
- rubyzip >= 0
- simplecov >= 0
- simplecov-html >= 0
- ansi 1.5.0
- ast 2.4.2
- builder 3.2.4
- docile 1.4.0
- minitest 5.15.0
- minitest-reporters 1.5.0
- msgpack 1.5.2
- oga 3.3
- parallel 1.22.1
- rake 13.0.6
- ruby-ll 2.1.2
- ruby-progressbar 1.11.0
- rubyzip 2.3.2
- simplecov 0.21.2
- simplecov-html 0.12.3
- simplecov_json_formatter 0.1.4
- Sphinx *
- sphinx-autobuild *
- sphinx_paramlinks *
- sphinx_rtd_theme >=1.1.0
- sphinxcontrib-programoutput *
- 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 *
- aiobotocore 2.22.0
- aiohappyeyeballs 2.6.1
- aiohttp 3.12.4
- aioitertools 0.12.0
- aiosignal 1.3.2
- appnope 0.1.4
- asttokens 3.0.0
- attrs 25.3.0
- autopep8 2.3.2
- black 25.1.0
- boto3 1.37.3
- botocore 1.37.3
- buildstock-query 2024.5.9
- certifi 2025.1.31
- cffi 1.17.1
- charset-normalizer 3.4.2
- click 8.2.1
- colorama 0.4.6
- comm 0.2.2
- debugpy 1.8.14
- decorator 5.2.1
- executing 2.2.0
- frozenlist 1.6.0
- fsspec 2025.5.1
- geopandas 1.0.1
- greenlet 3.2.2
- idna 3.10
- iniconfig 2.1.0
- inquirerpy 0.3.4
- ipykernel 6.29.5
- ipython 9.2.0
- ipython-pygments-lexers 1.1.1
- jedi 0.19.2
- jmespath 1.0.1
- jupyter-client 8.6.3
- jupyter-core 5.7.2
- kaleido 0.2.1
- matplotlib-inline 0.1.7
- multidict 6.4.4
- mypy-extensions 1.1.0
- narwhals 1.41.0
- nest-asyncio 1.6.0
- numpy 2.2.4
- packaging 24.2
- pandas 2.2.3
- pandas-stubs 2.2.3.250527
- parso 0.8.4
- pathspec 0.12.1
- pexpect 4.9.0
- pfzy 0.3.4
- platformdirs 4.3.7
- plotly 6.1.2
- pluggy 1.6.0
- polars 1.27.1
- prompt-toolkit 3.0.51
- propcache 0.3.1
- psutil 7.0.0
- ptyprocess 0.7.0
- pure-eval 0.2.3
- pyarrow 20.0.0
- pyathena 3.0.6
- pycodestyle 2.13.0
- pycparser 2.22
- pydantic 1.10.22
- pygments 2.19.1
- pyogrio 0.10.0
- pyproj 3.7.1
- pytest 8.3.5
- python-dateutil 2.9.0.post0
- pytz 2025.2
- pywin32 310
- pyyaml 6.0.2
- pyzmq 26.4.0
- requests 2.32.3
- resstockpostproc 0.1.0
- s3fs 2025.5.1
- s3transfer 0.11.3
- shapely 2.1.0
- six 1.17.0
- sqlalchemy 1.4.46
- sqlalchemy2-stubs 0.0.2a38
- stack-data 0.6.3
- tabulate 0.9.0
- tenacity 9.1.2
- toml 0.10.2
- tornado 6.4.2
- traitlets 5.14.3
- types-pytz 2025.2.0.20250516
- types-pyyaml 6.0.12.20250516
- typing-extensions 4.13.2
- tzdata 2025.2
- urllib3 2.4.0
- wcwidth 0.2.13
- wrapt 1.17.2
- yarl 1.20.0
- actions/checkout v4 composite
- astral-sh/setup-uv v6 composite
Score: 9.154827662045925