Saved searches

Use saved searches to filter your results more quickly

Cancel Create saved search

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.

NREL / EnergyPlus Public

EnergyPlus™ is a whole building energy simulation program that engineers, architects, and researchers use to model both energy consumption and water use in buildings.

License

NREL/EnergyPlus

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Switch branches/tags
Branches Tags
Could not load branches
Nothing to show
Could not load tags
Nothing to show

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Cancel Create

• Local
• Codespaces

HTTPS GitHub CLI
Use Git or checkout with SVN using the web URL.
Work fast with our official CLI. Learn more about the CLI.

Sign In Required

Please sign in to use Codespaces.

Launching GitHub Desktop

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop

If nothing happens, download GitHub Desktop and try again.

Launching Xcode

If nothing happens, download Xcode and try again.

Launching Visual Studio Code

Your codespace will open once ready.

There was a problem preparing your codespace, please try again.

Latest commit

5 c974412 Sep 18, 2023

Energy Meters Table and Increase Decimals for Air Flow (bug fixes to issues #9642 and #9589)

Git stats

Files

Failed to load latest commit information.

Latest commit message
Commit time
August 28, 2023 15:59
September 26, 2022 10:35
August 30, 2023 11:26
August 17, 2023 09:17
August 23, 2023 15:38
September 18, 2023 12:10
August 23, 2023 15:38
August 16, 2023 10:45
April 26, 2023 13:50
July 25, 2023 09:46
September 18, 2023 15:34
August 29, 2023 12:48
September 1, 2023 08:58
September 18, 2023 13:48
July 11, 2023 15:30
March 24, 2023 12:47
December 10, 2020 09:26
August 2, 2023 11:51
May 20, 2021 15:37
May 23, 2023 14:37
May 4, 2023 09:58
March 30, 2021 11:52
August 25, 2023 10:45
October 23, 2020 20:37
April 26, 2023 13:50
August 18, 2023 20:56
January 3, 2023 23:48
August 2, 2023 09:16

README.md

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.

• 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.

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.

EnergyPlus is released twice annually, usually in March and September. It is recommended all use of EnergyPlus is 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.

Program documentation is installed alongside the program, with the pdfs also available online. Big Ladder also produces html based documentation online.

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.

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.

About

EnergyPlus™ is a whole building energy simulation program that engineers, architects, and researchers use to model both energy consumption and water use in buildings.

EnergyPlus 9.6.0

EnergyPlus is a whole building energy simulation program that engineers and architects use to model both energy consumption and water use in buildings. Energy consumption includes heating, cooling, ventilation, lighting and plug and process loads.

Features:

• Integrated, simultaneous solution of thermal zone conditions and HVAC system response that does not assume that the HVAC system can meet zone loads and can simulate un-conditioned and under-conditioned spaces.
• Heat balance-based solution of radiant and convective effects that produce surface temperatures thermal comfort and condensation calculations.
• Sub-hourly, user-definable time steps for interaction between thermal zones and the environment; with automatically varied time steps for interactions between thermal zones and HVAC systems. These allow EnergyPlus to model systems with fast dynamics while also trading off simulation speed for precision.
• Combined heat and mass transfer model that accounts for air movement between zones.
• Advanced fenestration models including controllable window blinds, electrochromic glazings, and layer-by-layer heat balances that calculate solar energy absorbed by window panes.
• Illuminance and glare calculations for reporting visual comfort and driving lighting controls.
• Component-based HVAC that supports both standard and novel system configurations.
• A large number of built-in HVAC and lighting control strategies and an extensible runtime scripting system for user-defined control.
• Functional Mockup Interface import and export for co-simulation with other engines.
• Standard summary and detailed output reports as well as user definable reports with selectable time-resolution from annual to sub-hourly, all with energy source multipliers.

What’s new in version 9.6.0:

• Add option for the weather data interpolations for the first few sub-hour timesteps.
• Add Space Concept to EnergyPlus Zone Structure, Part 1.
• Airflow Network Default Behavior Enhancements.
• Waterside economizer coil new feature CoilSystem:Cooling:Water.
• Add a Specified Flow Element to AirflowNetwork.
• New Feature Runaround Heat Recovery Loop.

About EP-Launch Program

Like all simulation programs, EnergyPlus consists of more than just an executable file. EnergyPlus needs various input files that describe the building to be modeled and the environment surrounding it. The program produces several output files, which need to be described or further processed in order to make sense of the results of the simulation. Finally, even in stand-alone mode, EnergyPlus is usually not executed “by hand”, but rather by running a procedure file which takes care of finding input files and storing or further processing the output files. To assist those in the Windows environment, developer has included the EP-Launch program.

EP-Launch is an optional component of the EnergyPlus Windows installation (it is not available for Linux and Mac platforms). For users that want a simple way of selecting files and running EnergyPlus, EP-Launch provides this and more. In addition, EP-Launch can help open a text editor for the input and output files, open a spreadsheet for the postprocessor results files, a web browser for the tabular results file, and start up a viewer for the selected drawing file.

EnergyPlus file extensions

Input files

The following files are input to the EnergyPlus program.

• IDD (input data dictionary),
• IDF (input data file),
• IMF (input macro file),
• ini (EnergyPlus initialization file),
• epw (EnergyPlus weather file).

Primary output files

The following output files are the most important for beginning users.

• err (a text file containing the error messages issued by EnergyPlus. This is the first output that should be examined after a simulation),
• csv (comma separated variable),
• htm/html.
• Other output files
  • audit (this is an text file which echoes the IDD and IDF files, flagging syntax errors in either file),
  • ESO (EnergyPlus Standard Output),
  • EnergyPlus Meter Output (MTR),
  • mtd (this file contains all the details about meters),
  • EIO (EnergyPlus Invariant Output),
  • RDD (Report (variable) Data Dictionary),
  • MDD (Report (meter) Data Dictionary),
  • dxf (this is a file in AutoCadTM DXF format showing all the surfaces defined in the IDF file).

  About U.S. Department of Energy (DOE)

  US Department of Energy (DOE) is a government administration that regulates energy policy, research and development. Its mission is to ensure America’s security and prosperity by addressing its energy, environmental and nuclear challenges through transformative science and technology solutions.

  US Department of Energy was founded in 1977 and is based in Washington, D.C.

  Gallery

  

  EP-Launch program

  EnergyPlus™

  EnergyPlus™ is a whole building energy simulation program that engineers, architects, and researchers use to model both energy consumption—for heating, cooling, ventilation, lighting and plug and process loads—and water use in buildings. Some of the notable features and capabilities of EnergyPlus include:

  • Integrated, simultaneous solution of thermal zone conditions and HVAC system response that does not assume that the HVAC system can meet zone loads and can simulate un-conditioned and under-conditioned spaces.
  • Heat balance-based solution of radiant and convective effects that produce surface temperatures thermal comfort and condensation calculations.
  • Sub-hourly, user-definable time steps for interaction between thermal zones and the environment; with automatically varied time steps for interactions between thermal zones and HVAC systems. These allow EnergyPlus to model systems with fast dynamics while also trading off simulation speed for precision.
  • Combined heat and mass transfer model that accounts for air movement between zones.
  • Advanced fenestration models including controllable window blinds, electrochromic glazings, and layer-by-layer heat balances that calculate solar energy absorbed by window panes.
  • Illuminance and glare calculations for reporting visual comfort and driving lighting controls.
  • Component-based HVAC that supports both standard and novel system configurations.
  • A large number of built-in HVAC and lighting control strategies and an extensible runtime scripting system for user-defined control.
  • Functional Mockup Interface import and export for co-simulation with other engines.
  • Standard summary and detailed output reports as well as user definable reports with selectable time-resolution from annual to sub-hourly, all with energy source multipliers.

  EnergyPlus is a console-based program that reads input and writes output to text files. It ships with a number of utilities including IDF-Editor for creating input files using a simple spreadsheet-like interface, EP-Launch for managing input and output files and performing batch simulations, and EP-Compare for graphically comparing the results of two or more simulations. Several comprehensive graphical interfaces for EnergyPlus are also available. DOE does most of its work with EnergyPlus using the OpenStudio software development kit and suite of applications.

  При подготовке материала использовались источники:
  https://github.com/NREL/EnergyPlus

  EnergyPlus

  
  https://www.wbdg.org/additional-resources/tools/energyplus