EnergyPlus Documentation Library[LINK]
The documentation library for EnergyPlus has historically been provided in the form of pdf’s packaged with the release. As of the 8.3.0 release, a major conversion was completed where the source of the docs was changed to Markdown. This allows for numerous improvements:
Easy to automatically translate in between other markup languages, including html, thus making it easy to host as a web page.
Merging can be done automatically so the documentation source can stay alongside the source code, idd, and idfs, and all be merged at once. With the ever-increasing visibility of EnergyPlus development, it is becoming key that documentation is directly in sync with the rest of the program files.
Since Markdown is clear text, it is platform-independent and maximizes the possibility for outside contributions to EnergyPlus.
The Markdown source for the latest major release is converted to html which is then available at http://energyplus.net/documentation. The current, or “daily” documentation is available at http://nrel.github.io/EnergyPlus, but since this is a moving target within a release cycle, it is recommended that users view the .net documentation page.
Two key aspects of the documentation that are currently in development and should be completed soon are:
Search: the ability to search the online html docs easily
Download as pdf: the ability to download pdfs for local/offline access
The Markdown based documentation is structured similarly to the pdfs, though the larger files are broken into smaller pieces for faster load times due to the dynamic nature of the math, especially in the engineering reference. Each of the main documentation pieces are described here.
User Information Documents[LINK]
The following documents relate to using EnergyPlus, the engine. These documents cover a full range of questions and should be the first place a beginning or even experienced user would go to find out how the program works, what it expects as input, what it produces as output, etc. In general, the information in these documents is not highly technical, but it is detailed enough to use the basic capabilities of the program.
Getting Started with EnergyPlus – the Basics Manual: You are currently reading the Overview section of this document. The overview contains a “big picture” description of the EnergyPlus program as well as background of its development and the goals to which it ascribes. The remainder of the Getting Started document provides beginning users with an introduction into how to run EnergyPlus, what files are needed for EnergyPlus to execute, and what files are produced when EnergyPlus runs successfully. It also provides some guidance as to how to determine what potential sources of errors are when EnergyPlus runs into problems and how serious those problems might be.
Input and Output Reference: This document is a thorough description of the various input and output files related to EnergyPlus, the format of these files, and how the files interact and interrelate.
Output Details, Examples and Data Sets: While the Input and Output Reference document touch on some of the outputs from EnergyPlus, this document has more details and specific examples. It also addresses the reference data sets that are included.
Auxiliary Programs: This document contains information for the auxiliary programs that are part of the EnergyPlus package. For example, this document contains the user manual for the Weather Converter program, descriptions on using Ground Heat Transfer auxiliary programs with EnergyPlus, Compact HVAC descriptions, the Transition program/package and other assorted documents.
Engineering Reference Document[LINK]
The Engineering Reference provides more in-depth knowledge into the theoretical basis behind the various calculations contained in the program. This reference includes more information on modeling equations, limitations, literature references, etc. The document contains the following information and is structured along the lines of the above illustration (Figure. EnergyPlus – Internal elements).
Heat Balance Overview and Reference: This section describes the heat balance calculations that form the basis of the EnergyPlus building model. It includes descriptions of shadowing calculations and other pieces of the model.
HVAC Overview and Reference:This section contains a description of the loop-based approach used by EnergyPlus to model the HVAC systems: air loops, water loops, etc. It includes a description of the higher-level managers that control the simulation flow as well as some information on the various components that can be linked together to comprise an HVAC system.
HVAC Branch Based Input Description:This section is a special extension of both the input document and the HVAC overview document. It contains more detail on the various HVAC input objects and how these different object link together to form an HVAC description. It contains vital information mainly for the interface developer but also provides users with an in-depth look at the inner workings of the loop approach adopted by EnergyPlus.
Encyclopedic Reference:If the information did not fit in the above categories, then the last part of the Engineering Reference is a detailed description of the various models.
The application guides are intended to address specific applications using EnergyPlus where the other documents may not provide cohesive examples of intended usage; that is, the techniques for doing certain things may be spread throughout other documents but warrant a more “how to” approach that will be present in these documents. The application guides are intended to become more prolific over time, specifically targeted to questions users have sent to the helpdesk support site.
Current Application Guides:
EMS Application Guide: This guide contains information useful to use the advanced feature of EnergyPlus: Energy Management System tweaks. The Erl language is described and examples for use are given.
External Interface Application Guide: This guide contains information specific to using the external interface feature of EnergyPlus to connect other simulation systems.
Plant Application Guide: This guide details the methods for simulating real chilled and hot water plant systems within EnergyPlus.
Using EnergyPlus for Compliance Guide: This guide contains information specific to using EnergyPlus in Compliance and Standard Rating systems.
External Interface(s) Application Guide: This guide contains information about external interfaces (through the Building Controls Virtual Test Bed link) to EnergyPlus.
Tips & Tricks for Using EnergyPlus: This guide contains short tips and tricks for using various parts of EnergyPlus.