EnergyPlus
A whole building energy simulation program that engineers, architects, and researchers use to model both energy consumption and water usage in buildings.
https://github.com/NREL/EnergyPlus
Category: Consumption
Sub Category: Buildings and Heating
Keywords from Contributors
energyplus buildings qt openstudio-sdk openstudio-models openstudio-coalition openstudio-application openstudio energy-efficiency kiva
Last synced: about 17 hours ago
JSON representation
Repository metadata
EnergyPlus™ is a whole building energy simulation program that engineers, architects, and researchers use to model both energy consumption and water use in buildings.
- Host: GitHub
- URL: https://github.com/NREL/EnergyPlus
- Owner: NREL
- License: other
- Created: 2013-11-22T14:47:34.000Z (about 12 years ago)
- Default Branch: develop
- Last Pushed: 2025-11-26T01:45:52.000Z (29 days ago)
- Last Synced: 2025-11-27T12:59:50.652Z (27 days ago)
- Language: C++
- Homepage: https://energyplus.net
- Size: 1.08 GB
- Stars: 1,351
- Watchers: 99
- Forks: 456
- Open Issues: 926
- Releases: 191
-
Metadata Files:
- Readme: README.md
- Contributing: .github/contributing.md
- License: LICENSE.txt
README.md
EnergyPlus 
This is the EnergyPlus Development Repository. EnergyPlus™ is a whole building energy simulation program that engineers, architects, and researchers use to model both energy consumption and water use in buildings.
Contact/Support
- The Department of Energy maintains a public website for EnergyPlus where you can find much more information about the program.
- For detailed developer information, consult the wiki.
- Many users (and developers) of EnergyPlus are active on Unmet Hours, so that's a great place to start if you have a question about EnergyPlus or building simulation.
- For more in-depth, developer-driven support, please utilize the EnergyPlus Helpdesk.
Testing
Every commit and every release of EnergyPlus undergoes rigorous testing.
The testing consists of building EnergyPlus, of course, then there are unit tests, integration tests, API tests, and regression tests.
Since 2014, most of the testing has been performed by our bots (Tik-Tok, Gort, and Marvin), using a fork of the Decent CI continuous integration system.
We are now adapting our efforts to use the Github Actions system to handle more of our testing processes.
In the meantime, while Decent CI is still handling the regression and bulkier testing, results from Decent CI are still available on the testing dashboard.
Releases
EnergyPlus is released twice annually, usually in March and September.
It is recommended all use of EnergyPlus in production workflows use these formal, public releases.
Iteration (pre-)releases may be created during a development cycle, however users should generally avoid these, as input syntax may change which won't be supported by the major release version transition tools, and could require manual intervention to remedy.
If an interim release is intended for active use by users, such as a bug-fix-only or performance-only re-release, it will be clearly specified on the release notes and a public announcement will accompany this type of release.
Our releases are now built by Github Actions.
Core Documentation
Program documentation is installed alongside the program, with the pdfs also available online.
Big Ladder also produces html based documentation online.
API Documentation
An API has been developed to allow access to internal EnergyPlus functionality and open up the possibility for new workflow opportunities around EnergyPlus.
A C API is developed to expose the C++ functions, then Python bindings are built on top of that to maximize the accessibility.
Documentation is being built and posted on ReadTheDocs and that documentation will continue to be expanded over time as the API grows.
The badges above here show the status, and link out to, the latest documentation (most recent commit to the develop branch) as well as the stable documentation (most recent release tag).
License & Contributing Development
EnergyPlus is available under a BSD-3-like license.
For more information, check out the license file.
The EnergyPlus team accepts contributions to EnergyPlus source, utilities, test files, documentation, and other materials distributed with the program.
The current EnergyPlus contribution policy is now available on the EnergyPlus contribution policy page.
If you are interested in contributing, please start there, but feel free to reach out to the team.
Building EnergyPlus
A detailed description of compiling EnergyPlus on multiple platforms is available on the wiki.
Also, as we are adapting to using Github Actions, the recipes for building EnergyPlus can be found in our workflow files.
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
- Fork event: 78
- Create event: 210
- Commit comment event: 2373
- Release event: 26
- Issues event: 256
- Watch event: 178
- Delete event: 155
- Member event: 1
- Issue comment event: 2130
- Push event: 806
- Pull request review event: 758
- Pull request review comment event: 1034
- Pull request event: 357
Last Year
- Fork event: 78
- Create event: 210
- Commit comment event: 2373
- Release event: 26
- Issues event: 256
- Watch event: 178
- Delete event: 155
- Member event: 1
- Issue comment event: 2130
- Push event: 806
- Pull request review event: 758
- Pull request review comment event: 1034
- Pull request event: 357
Committers metadata
Last synced: 5 days ago
Total Commits: 29,819
Total Committers: 127
Avg Commits per committer: 234.795
Development Distribution Score (DDS): 0.873
Commits in past year: 1,817
Committers in past year: 33
Avg Commits per committer in past year: 55.061
Development Distribution Score (DDS) in past year: 0.82
| Name | Commits | |
|---|---|---|
| Edwin Lee | l****1@g****m | 3790 |
| mjwitte | m****e@g****m | 2854 |
| Richard Raustad | r****d@f****u | 2773 |
| Julien Marrec | j****c@g****m | 1864 |
| Matt Mitchell | m****l@n****v | 1620 |
| jcyuan | j****n@g****m | 1305 |
| Jermy Thomas | j****v@g****m | 1243 |
| JasonGlazer | j****r@g****m | 1152 |
| Nigusse | b****e@f****u | 1141 |
| Dareum Nam | i****m@g****m | 1112 |
| Yujie Xu | s****5@g****m | 700 |
| Rick Strand | r****d@i****u | 677 |
| xuanluo113 | x****o@l****v | 624 |
| Mark Adams | a****b@o****v | 600 |
| Lixing Gu | gu@f****u | 557 |
| Neal Kruis | n****s@b****m | 521 |
| Jason W. DeGraw | j****w@g****m | 454 |
| Yujie Xu | y****x@5****s | 445 |
| Jason Turner | j****n@e****m | 443 |
| Matt Mitchell | m****l@o****u | 435 |
| Noel Merket | n****t@n****v | 406 |
| Matthew Larson | m****n@b****m | 366 |
| nigusse | b****e@f****u | 359 |
| Brent Griffith | B****h@E****m | 343 |
| Lerond, Jeremy | j****d@p****v | 317 |
| amirroth | r****r@g****m | 315 |
| brianlball | b****l@n****v | 258 |
| rongpengzhang | r****g@l****v | 257 |
| Michael Patrick O'Keefe | m****e@b****m | 238 |
| Yueyue | Y****u@n****v | 176 |
| and 97 more... | ||
Committer domains:
- nrel.gov: 19
- bigladdersoftware.com: 10
- lbl.gov: 7
- pnnl.gov: 5
- ornl.gov: 5
- okstate.edu: 5
- d-alchemy.com: 4
- vols.utk.edu: 3
- fsec.ucf.edu: 3
- gard.com: 3
- ambient-e.com: 2
- emptycrate.com: 1
- 5c-e9-1e-83-4f-ff.dhcp.lbnl.us: 1
- fsec.ucfedu: 1
- energyarchmage.com: 1
- illinois.edu: 1
- objexx.com: 1
- mccoyrothstrategies.lan: 1
- utoronto.ca: 1
- nrcan-rncan.gc.ca: 1
- rgntgw1-1-84-dhcp.int.colorado.edu: 1
- cognizant.com: 1
- archlinux.org: 1
- trane.com: 1
- mobile-192-17-205-154.near.uiuc.edu: 1
- mobile-192-17-193-140.near.uiuc.edu: 1
- loaner-26428s.nrel.gov: 1
- mmitchel-34593s.nrel.gov: 1
- solaris-technical.com: 1
- a3.epfl.ch: 1
- autodesk.com: 1
- mccoyrothstrategies.mynetworksettings.com: 1
- canada.ca: 1
- yujies-mbp.dhcp.lbnl.us: 1
- gti.energy: 1
- glazer350.com: 1
Issue and Pull Request metadata
Last synced: 5 days ago
Total issues: 7,524
Total pull requests: 4,050
Average time to close issues: 4 months
Average time to close pull requests: about 1 month
Total issue authors: 321
Total pull request authors: 105
Average comments per issue: 1.22
Average comments per pull request: 7.17
Merged pull request: 3,474
Bot issues: 0
Bot pull requests: 31
Past year issues: 150
Past year pull requests: 380
Past year average time to close issues: 29 days
Past year average time to close pull requests: 19 days
Past year issue authors: 45
Past year pull request authors: 26
Past year average comments per issue: 0.79
Past year average comments per pull request: 4.72
Past year merged pull request: 240
Past year bot issues: 0
Past year bot pull requests: 11
Top Issue Authors
- axelstudios (4,151)
- mjwitte (678)
- rraustad (228)
- jmarrec (194)
- Myoldmopar (191)
- aaron-boranian (167)
- JasonGlazer (162)
- BobHenninger (113)
- jcyuan2020 (102)
- shorowit (84)
- Nigusse (83)
- EnergyArchmage (72)
- lymereJ (65)
- lgu1234 (62)
- mitchute (51)
Top Pull Request Authors
- Myoldmopar (592)
- rraustad (413)
- jmarrec (395)
- mjwitte (325)
- mitchute (241)
- Nigusse (201)
- RKStrand (195)
- JasonGlazer (168)
- lgu1234 (162)
- lymereJ (81)
- yujiex (80)
- jasondegraw (80)
- jcyuan2020 (76)
- amirroth (74)
- mbadams5 (74)
Top Issue Labels
- Defect (3,807)
- SeverityMedium (3,385)
- PriorityLow (2,161)
- SeverityHigh (1,105)
- DoNotPublish (451)
- NewFeatureRequest (337)
- SeverityLow (275)
- Documentation (198)
- UnconfirmedDefect (189)
- MigratedFromUserVoice (153)
- AuxiliaryTool (151)
- PriorityHigh (145)
- NotIDDChange (103)
- Triage (97)
- WontFix (79)
- Developer Issue (45)
- Refactoring (41)
- IDDChange (39)
- LowComplexityApproved (35)
- Performance (34)
- AirflowNetwork (22)
- OutputChange (15)
- InProgress (14)
- NewFeature (11)
- LowComplexity (10)
- Weather (8)
- WebSite (7)
- MediumComplexityApproved (4)
- RPD (4)
- MediumComplexity (3)
Top Pull Request Labels
- Defect (2,036)
- DoNotPublish (935)
- NewFeature (476)
- Refactoring (442)
- IDDChange (353)
- NotIDDChange (221)
- OutputChange (102)
- Performance (101)
- Developer Issue (93)
- Documentation (75)
- AuxiliaryTool (40)
- dependencies (31)
- AirflowNetwork (28)
- github_actions (25)
- APIChange (21)
- LowComplexityApproved (8)
- RPD (7)
- PriorityHigh (7)
- SeverityLow (7)
- SeverityHigh (3)
- MergeAfterRelease (3)
- HighComplexityApproved (3)
- python (3)
- SeverityMedium (2)
- InProgress (2)
- DoNotMerge (2)
- NewFeatureRequest (1)
- UnconfirmedDefect (1)
- Weather (1)
- PriorityLow (1)
Dependencies
- actions/checkout v3 composite
- actions/setup-python v3 composite
- actions/upload-artifact v3 composite
- svenstaro/upload-release-action v2 composite
- actions/checkout v4 composite
- actions/setup-python v5 composite
- actions/upload-artifact v4 composite
- actions/checkout v4 composite
- actions/setup-python v5 composite
- actions/upload-artifact v4 composite
- actions/checkout v4 composite
- actions/download-artifact v4 composite
- actions/upload-artifact v4 composite
- jmarrec/setup-python v5 composite
- jmarrec/setup-qtifw v1 composite
- svenstaro/upload-release-action v2 composite
- actions/checkout v4 composite
- actions/download-artifact v4 composite
- actions/setup-python v5 composite
- actions/upload-artifact v4 composite
- jmarrec/setup-python v5 composite
- svenstaro/upload-release-action v2 composite
- actions/checkout v4 composite
- actions/download-artifact v4 composite
- actions/setup-python v5 composite
- actions/upload-artifact v4 composite
- jmarrec/setup-python v5 composite
- jmarrec/setup-qtifw v1 composite
- svenstaro/upload-release-action v2 composite
- actions/checkout v4 composite
- actions/upload-artifact v4 composite
- jidicula/clang-format-action v4.13.0 composite
- actions/checkout v4 composite
- actions/setup-python v5 composite
- actions/checkout v4 composite
- actions/setup-python v5 composite
- actions/checkout v4 composite
- actions/github-script v7 composite
- actions/setup-python v5 composite
- actions/upload-artifact v4 composite
- mheap/github-action-required-labels v5 composite
- GitPython ==3.1.43
- rst2pdf ==0.102
- sphinx-rtd-theme ==2.0.0
- sphinx-sitemap ==2.6.0
- sphinxcontrib-moderncmakedomain ==3.29.0
- Jinja2 <3.1
- sphinx >3
- sphinx-rtd-theme *
- urllib3 ==1.26.19
- wheel *
- lxml * test
- pytest * test
Score: 12.57480115252233