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 valid AirflowNetwork: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
• #10975 - Add mac launchers for PythonApps by @jmarrec in #10976
• Two ScheduleAPI Fixes and a Comment by @amirroth in #10988
• fix Super high COP in VRFFluidTCtrl model by @yujiex in #10752
• Corrects WWHP heat recovery identification and plant water flow rate sizing by @rraustad in #10969
• Controller:MechanicalVentilation fatal error with zero zones by @mjwitte in #10979
• Trap inconsistent Do Space Heat Balance settings with SpaceHVAC objects by @mjwitte in #10986
• assertion failure in VRF low load calculation solving for Te by @yujiex in #10990
• Followup on the assertion failure solving Te at low load condition in VRFFluidTCtrl model by @yujiex in #10994
• Fix Issue with Standard Ratings for Multi-Speed Coils by @amirroth in #10992
• Indoor living wall fixes for the calculation of lighting power and saturated zone humidity ratio by @LipingWang in #10989
• Fix multipliers in Outdoor Air Details report by @mjwitte in #10996
• Fix EP-Launch Classic and IDF Editor help menus to link to online documentation and add SpSZ button to EP-Launch by @JasonGlazer in #11007
• Add the Spsz files to the energyplus.py workflow file to support showing those in EP-Launch by @JasonGlazer in #11010
• Flow rate bugfix for Coil:Heating/Cooling:WaterToAirHeatPump:VariableSpeedEquationFit by @yzhou601 in #11005

Under the Hood Refactoring ⚙

• Add minimum and default for the Condenser Minimum Flow Fraction field by @lymereJ in #10779
• Schedule API by @amirroth in #10848
• Variable speed PIUs: add example files fieldnames and revise error message by @lymereJ in #10776
• Move a few docs to RTD by @Myoldmopar in #10942

New Contributors

• @Accacio made their first contribution in #10849

Full Changelog: v24.2.0...v25.1.0