EnergyPlus
Version 25.2.0
30 September 2025
EnergyPlus is a trademark of the US Department of Energy.
EnergyPlus
Version 25.2.0
30 September 2025
EnergyPlus is a trademark of the US Department of Energy.
As EnergyPlus evolves, features and capabilities are added to ensure the tool keeps up with demand. However, some features and capabilities may grow outdated and potentially be removed from the tool. For most changes to EnergyPlus between versions, an automated conversion is possible. When an automatic conversion is not possible, the relevant input objects are marked as deprecated, a warning message is emitted from the simulation engine, and eventually the user must manually convert the file once the feature is fully removed.
The justification for removing capabilities is to reduce the maintenance burden of the program, allowing more effort to be placed in adding newer, more vital, capabilities, and also to streamline the internal structure of the program to improve the runtime burden of the program.
This document discusses those aspects which are on the roadmap for deprecation from the engine. The full deprecation process consists of several steps to ensure that users are not suddenly impacted by the change. This document will be included in each installer and also sent to major stakeholders and users.
The deprecation process consists of a number of steps. The deprecation process will gnerally follow each of these steps one release at a time. However, the development reserves the right to alter the deprecation timeline of features as needed.
DElight daylighting capabilities provides an alternative to the split-flux method. The DElight library has not been updated in several years, and there is little user activity (support questions, etc.) related to this feature. This library is considered for potential deprecation.
EnergyPlus, as a physics calculation engine, does include some extra "non-physics" calculations. Component cost is one calculation that can be performed fully outside EnergyPlus, unrelated to the direct physics of the simulation. The ComponentCost objects are considered for potential deprecation.
Geometry transformation allows for users to enter inputs that transform the building inside the simulation itself. It has been suggested that this capability should live outside of EnergyPlus, so objects related to this capability are now considered potentially deprecated.
The EP-Launch tool that has been packaged with EnergyPlus for decades is tabbed for potential removal in a future release. A new Python-based cross-platform version of EP-Launch has been developed, tested, and is now packaged right with the EnergyPlus installation on all platforms. On Windows, the start menu now includes both the EPLaunch (classic) tool, along with an EPLaunch Python shortcut. We encourage users to try out the new Python-based tool, and see how it can unlock new workflows and capabilities. Although it has been tested heavily in-house, we are excited for feedback. To learn more about this new version of EP-Launch, you can find information on the GitHub repository. Users are also welcome to install the new EP-Launch tool into their Python environment which would allow getting updates to the tool more frequently. The classic EP-Launch tool is going to be removed from our maintenance and package at a future date based on user feedback on the new tool.
EnergyPlus has maintained and provided a small client app that made it easier for users to update their input files between versions of EnergyPlus. The tool is written in a relatively uncommon language, and the team is not able to readily maintain this version of the tool. The team created a very similar tool in Python, and as of EnergyPlus 25.1.0, the tool was packaged up with the installer, and is ready for user testing. The tool has undergone significant testing, but we are excited to get feedback from users. On Windows and Mac, we are still including the classic version of the tool, for now, in case of any unforeseen issues. However, on Linux, we discovered that the classic tool was not functional anymore as of Ubuntu 24.04, and so we removed the classic tool completely. On all platforms, it is expected that the classic version updater tool will be removed in the next version.
EnergyPlus has provided 32-bit Windows builds since the very early days of development, and 64-bit Windows builds since version 6.0.0 (Fall 2010). Microsoft has begun the process of stopping 32-bit development and invoked new requirements on system memory that effectively eliminate 32-bit systems except in the most niche circumstances. As of 2020, Steam software reported that 32-bit Windows usage was down to 0.2% of users. All of this would be sufficient for us to justify eliminating 32-bit builds, however some EnergyPlus interfaces are still built as 32-bit binaries, and we try hard to provide interfaces with everything they need from EnergyPlus. Our CI systems are no longer able to build 32-bit Windows packages, but we still have dev machines that can do it, so for now we will provide 32-bit builds, but they won't be around much longer.
EnergyPlus historically used version numbers that varied the major number and sometimes the minor number. Starting with the March 2022 release, we moved forward with a more modern version numbering scheme. The EnergyPlus version is now based on the year and the release number. The March 2022 release was EnergyPlus 22.1 and the Fall release was be EnergyPlus 22.2. If additional major releases are created for some reason, they would increment the release number further. Rare intermediate releases may be numbered with a patch number such as 22.1.1.
Ubuntu 18.04 and 20.04 builds are no longer provided. These versions are at, or near, end of life. Moving forward, we will continue providing Linux builds for the two most recent Linux LTS versions.
Mac 10.15 builds will not be provided after the release of 23.2.
The EP-Compare utility has been removed from the EnergyPlus install package. The program had issues which had not been reported, hinting that it was not being used. The code and binaries have been archived at https://github.com/JasonGlazer/ep-compare.