Releases: NREL/EnergyPlus
EnergyPlus 25.2.0 - Test Package 1
Test packaging 25.2.0 to see where we stand.
EnergyPlus 25.1.0, Bug Fix Edition
There have been a couple high impact defects repaired since the release of EnergyPlus 25.1.0. These have been patched onto the 25.1.0 branch, and we are re-releasing an alternative 25.1.0 version for affected users.
This version is fully compatible with 25.1.0, so if you haven't downloaded 25.1.0, this would be the suggested version to download. If you are using 25.1.0 original, and not experiencing any issues, there's no need to patch to this.
What's Changed
Defects Repaired 🪲
- Fix #11050 - Schedule initialization error in HighTempRadiantSystem by @amirroth in #11053
- Fix #11018 - Controller:MechanicalVentilation with DesignSpecification:OutdoorAir:SpaceList by @mjwitte
- Fix #11089 - Relax codesigning entitlements for Python on mac by @jmarrec in #11090
Full Changelog: v25.1.0...v25.1.0-WithDSOASpaceListFixes
EnergyPlus 25.1.0
EnergyPlus 25.1.0
The U.S. Department of Energy (DOE) has released EnergyPlus version 25.1.0. There were many bug fixes and new features this release. The full changelog for this release cycle is listed below. For more information about EnergyPlus, please visit www.energyplus.net.
Key Changes 🎹
Two notable changes this release related to documentation and auxiliary tools:
- Some of the documentation was converted from LaTeX->PDF into Markdown and hosted on ReadTheDocs. This includes:
- EnergyPlus Essentials
- EMS Application Guide
- Auxiliary Programs
- Notices and Acknowledgments
- We are now including two Python tools with EnergyPlus: EPLaunch and IDFVersionUpdater. These tools have been completely rebuilt in Python, and the Python versions will ultimately be the full replacements. For now, the classic versions are packaged as well.
- On Windows, you can find shortcuts to the classic and Python versions right on the start menu folder
- On Mac, both tools have .app bundles right in the /Applications/EnergyPlus-25-1-0 installation directory
- On Linux, there are shortcuts in the install folder, and you can also find them in the desktop integration after install (press the start button and search for EnergyPlus). Note that on Linux, the classic IDFVersionUpdater was not packaged, because it was broken on Ubuntu 24.04.
- We look forward to hearing your experiences with both tools!
Supported Platforms
- Windows 11 64-bit
- Linux (Ubuntu) 22.04 and 24.04 64 bit
- Mac OSX x86_64 and ARM architectures
What's Changed
New Features 🌟
- Add
Coil:*:DX:VariableSpeed
as validAirflowNetwork:Distribution:Component:Coil
by @lymereJ in #10791 - Enhance epJSON Editor by @JasonGlazer in #10870
- Add Space Component Loads Report and Fix Zone Component Loads when Enclosures Differ from Zones by @mjwitte in #10730
- Allow water heater desuperheater with Coil:Cooling:WaterToAirHeatPump:VariableSpeedEquationFit by @yzhou601 in #10945
- Add Frost multiplier EMS actuators to DX heating coils by @yzhou601 in #10970
- Add
Coil:*:WaterToAirHeatPump:EquationFit
as valid AirflowNetwork:Distribution:Component:Coil by @lymereJ in #10972 - Add transition GUI to the E+ Auxiliary CLI by @Myoldmopar in #10967
Performance Enhancing Changes 🏁
- Try with fvisibility=hidden on clang/GCC by @jmarrec in #10920
- Extended HI followup: fix speed issue by @yujiex in #10733
Defects Repaired 🪲
- Fix Foundation:Kiva Custom Block Material Input Processing by @mjwitte in #10768
- Fix Convective Baseboard with Hard Sizes by @mjwitte in #10772
- Fix Meter:Custom with mix of valid and invalid names by @amirroth in #10773
- Address 24.2 EMPD Issue by @Myoldmopar in #10781
- Vertical blind warning not reported from material get input function by @rraustad in #10743
- Fix wshp array bounds error and sizing by @mjwitte in #10735
- Fix typos in outputs/docs/src/etc. by @shorowit in #10760
- Fix VRF FluidTCtrl negative outdoor unit fan power by @yujiex in #10649
- Fix Issue #10286 window material shade mis-alignment for Output:Constructions by @jcyuan2020 in #10750
- Fix GHE Bugs by @mitchute in #10495
- Fix Std. 62.1 VRP calculations for Secondary Recirculation Systems by @EnergyArchmage in #10775
- Fix DistrictHeating:Water in HVACTemplate:Plant:Boiler by @mjwitte in #10822
- Fix chiller chilling when it is off by @mjwitte in #10793
- Fix #10842 - When using pyenergyplus to run (via run_energyplus), PythonPlugin initializations errors lead to hang by @jmarrec in #10844
- Add missing IDD type for chiller objects' condenser flow control by @lymereJ in #10883
- Delete unused schedule by @rraustad in #10869
- Set the correct identifier for variable speed cooling tower in
GetTowerInput
by @lymereJ in #10859 - Corrects crash in DOAS fan sizing by @rraustad in #10816
- Use LaTeX labels to reference figures in epw-csv-format-in-out.tex by @Accacio in #10849
- Add plant worker function to get current equipment capacity by @rraustad in #10804
- Fix Issue #10890 Discovered During FluidAPI Refactor by @amirroth in #10892
- Add the NIST Life Cycle Cost Escalations for 2023 and 2024 by @JasonGlazer in #10881
- Fix #10857 - Report System Summary:Thermostat Schedules depends on order of ZoneControl:Thermostat control types by @jmarrec in #10861
- Fix #10895 - Expand IDF bug with HVACTemplate:System:DedicatedOutdoorAir for Heat Recovery Type 'Enthalpy' by @jmarrec in #10904
- Add Space and Zone columns to Envelope Summary by @mjwitte in #10914
- Fix #10718 - DXCoils StandardRatings OutputReportPredefined::addFootNoteSubTable produces invalid XML by @jmarrec in #10860
- Correct reference entering air temperatures for the water to air heat pump dataset by @lymereJ in #10852
- Update conduction-through-the-walls.tex by @Accacio in #10897
- #10916 - Broken format strings in a few places like CurveManager by @jmarrec in #10917
- Fix DOAS system sizing and add reporting by @EnergyArchmage in #10783
- Fix flow rate issue for fanless unitary system by @mjwitte in #10825
- Fix #10830 - incorrect curve unit type warning by @jmarrec in #10853
- Change unit used for enthalpy in the
Coil Sizing Details
report by @lymereJ in #10909 - Fix #10889 - Fix reporting of Cooling Towers in Equipment Summary - Cooling Towers and Fluid Coolers by @jmarrec in #10900
- Fix #10899 -
Output:Table:Monthly
:SumOrAverageDuringHoursShown
doesn't follow previous variable by @jmarrec in #10901 - #10888 - Chiller minimum load ratio is set in the IDF however does not appear in eplustbl.htm for Chiller:Electric:EIR and Chiller:Electric:ReformulatedEIR by @jmarrec in #10915
- Consolidate speed-dependent coil load ratio input parameters into a single parameter. by @tanaya-mankad in #10369
- Fan:SystemModel with discrete speed flow fractions crashes when speeds >= 2 by @rraustad in #10846
- Fix space assignment for zone outside boundary condition and add space option by @mjwitte in #10903
- Fix #10817 - Avoid crash in FluidCooler/EvaporativeFluidCooler when Water flow rate autosized and no Sizing:Plant by @jmarrec in #10855
- Correct VAV maximum air flow fraction during reheat for heating dominated use cases by @rraustad in #10763
- Fix #10663 - Fan runtime fraction < 1 when flow rate scaling using DesignSpecification:ZoneHVAC:Sizing by @jmarrec in #10673
- Fix #10933 - Unable to read Site:GroundDomain:Slab with Site:GroundTemperature:Undisturbed:FiniteDifference by @jmarrec in #10934
- Add density option to ZoneInfiltration:DesignFlowRate and ZoneVentilation:DesignFlowRate by @mjwitte in #10929
- Fix #10902 - CoolingTower:VariableSpeed:Merkel not reporting to Equipment Summary - Cooling Towers and Fluid Coolers by @jmarrec in #10930
- Fix #10847 - EnergyPlus simulation crashes above a certain BaseDepth value for GroundHeatTransfer by @jmarrec in #10850
- Fix #10926 - Disable fused floating point operations by @jmarrec in #10931
- Fix excess fluid properties warnings leading to huge err file size by @rraustad in #10939
- New outputs for infiltration and ventilation by @mjwitte in #10940
- Fix documentation of heat pump heating rate description by @yujiex in #10957
- Fix #10952 #10953 - Fixup tcl-tk issue on mac + add ubuntu arm64 runners by @jmarrec in #10954
- Fix space sizing output (spsz) when there is no space HVAC equipment by @mjwitte in #10947
- Add severe error when crankcase heater curve name is invalid by @yujiex in #10963...
Release Candidate 5 of EnergyPlus 25.1.0
The PR tested perfectly, dev testing is complete, docs are updated, this is ready to go. I feel a bit silly making another RC, since develop should just be fast-forwarded to this anyway, but here we are erring on the side of caution. Assuming this builds packages then I'm just merging #11008 and retagging it as v25.1.0.
Release Candidate 4 of EnergyPlus 25.1.0
Silly mistake caused windows to fail with RC3. That's fixed now. Also this brings in the final bug fix of the release.
Release Candidate 3 of EnergyPlus 25.1.0
RC2 was highly successful. With RC3 I've polished up some of the icons and shortcut naming, as well as added some documentation links for the docs that are now on RTD. If the build is happy (it should be!?), then RC3 should go through rigorous testing. Also if anyone has suggestions on all the ways I can communicate the Python tools to users, I'm happy to guide users to them.
Release Candidate 2 of EnergyPlus 25.1.0
A quick RC build towards 25.1.0. I honestly thought about calling it a test build, but hey it's fine, let's just call it RC2. Hopefully EP-Launch behaves better and the shortcut icons look better.
Test build #12 of 25.1 with the Python Version Updater Included
Alright, test build #11 was basically happy, but this build will attempt to do it without the LD_LIBRARY_PATH workaround. If it's happy, then Linux is done. Windows and Mac are already happy, although @jmarrec proposed some changes to Windows. Those may just wait for now unless it's urgent.
Almost there....
Release Candidate 1 of EnergyPlus 25.1.0
Alright, there are several things to check here. The most user facing will be the new EPLaunch and VersionUpdater handling, but also the move to some more documentation on ReadTheDocs. With all the Python changes, I definitely need to exercise not only those apps and all the ways they can be accessed, but also confirming nothing broke with normal Python simulation workflows. I am also looking for the best ways to alert the users about the Python and doc changes.
There's really no reason this should fail since it just built happily on test #12 of the branch. But we'll see...
EnergyPlus 25.1.0, IO Freeze
This is the I/O freeze for 25.1.0. Barring any showstopper issues identified, this should hold as the official I/O reference commit for 25.1.0.