EnergyPlus 25.2.0

EnergyPlus 25.2.0

The U.S. Department of Energy (DOE) has released EnergyPlus version 25.2.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.

Supported Platforms

• Windows 11 64-bit
• Linux (Ubuntu) 22.04 and 24.04 64 bit
• Mac OSX x86_64 and ARM architectures
• New: experimental support for Windows 11 arm64 was added

What's Changed

New Features 🌟

• Add Availability Schedule Input Field to DX Coils by @Nigusse in #10974
• Adds multiplier/offset fields for Site:WaterMainsTemperature by @shorowit in #11037
• Add performance support for ASHRAE205 Coils (RS0004) by @tanaya-mankad in #10307
• Heat Pump Sizing: New Feature Proposal and Design Document by @rraustad in #11048
• Run and Cache Regressions on Develop And reuse in PR workflows by @jmarrec in #11190
• Extend Equipment and System Summary Tables - Air Heat Recovery, Air Terminals, and Fans by @mjwitte in #11138
• New Fan Power Fractions subtable by @mjwitte in #11153
• Improved duct model for a single AirLoop by @lgu1234 in #10887
• New Feature Heat Pump sizing according to ACCA Manual S by @rraustad in #11130
• Add Fuel Efficiency for Ideal Loads Air System by @Nigusse in #10971
• Add output columns and tables for ruleset project description work by @JasonGlazer in #10949
• A new air to water heat pump object by @yujiex in #11001
• New formatting and units options for table outputs (Tabular, SQLite, and JSON) by @mjwitte in #11210
• New Phase Change Material (PCM) Thermal Storage by @rohitj0204 in #11113
• A new passive hot water storage tank by @yujiex in #11033
• Avail sch missing dx coils cleanup and converted get input to JSON by @Nigusse in #11012
• New Feature to allow autosizing of Thermal Energy Storage tank capacity by @rraustad in #11147
• Add support for variable speed coils for SingleZoneVAV control type in AirLoopHVAC:UnitarySystem by @lymereJ in #11142
• Adding GHE borehole field design and sizing by @Myoldmopar in #11217
• Add Windows native ARM64 release by @jmarrec in #11351

Defects Repaired 🪲

• Make ExternalInterface:FunctionalMockupUnitExport:To:Schedule/Actuator Initial Value field optional by @mjwitte in #10943
• Update AirTerminal:SingleDuct:Mixer to report primary air node condition when air flow = 0 (when ATMixer is off) by @rraustad in #11022
• Protect WSHP from incorrect or missing curve names by @rraustad in #11028
• Fix #10378 - bump nlohmann/json to support most recent clang/apple-clang by @jmarrec in #11041
• Fix #11050 - Schedule initialization error in HighTempRadiantSystem by @amirroth in #11053
• Fix Reheat Coil Multiplier report by @amirroth in #11029
• Fix Coil Sizing Report for Coil:Heating:Gas:MultiStage and Coil:Heating:Electric:MultiStage by @amirroth in #11063
• Missing references in IDD by @lymereJ in #11069
• Fix #11073 - Bump clang-format from 10 to 19 by @jmarrec in #11082
• Fix order of curve independent variables for GAHP by @lymereJ in #11071
• Fix debug tests by @Myoldmopar in #11076
• Fix #11054 - Crash with schedule with missing day types by @jmarrec in #11085
• Fix GAHP flow request by @lymereJ in #11068
• Equipment Summary Air Heat Recovery Fixes by @mjwitte in #10995
• Fix #11026 - Bad thermostat control type value results in crash due to null schedule pointer by @jmarrec in #11074
• Fix debug tests - Disable floating point trapping around ssc battery calculations by @jmarrec in #11084
• Possibility for Hushing Table Diffs by @Myoldmopar in #11088
• Fix cycling degradation calculation for GAHP by @lymereJ in #11077
• Fix #11089 - Relax codesigning entitlements for Python on mac by @jmarrec in #11090
• Inconsistent field names and field name typo in different VS DX coils by @Nigusse in #11075
• Additional Documentation Fixes by @dareumnam in #11093
• Correction of Error Message in EcoRoof when User Does Not Use CTF Solution Algorithm by @RKStrand in #11095
• Throw Fatal Error When a Required Node is Missing in HVAC Mixer and Splitter by @RKStrand in #11098
• Correction of Various Documentation Issues by @RKStrand in #11091
• Correction of SetupOutputVariables.csv by @RKStrand in #11097
• Correction of Error in Xing Ground Temperature Model Get Input by @RKStrand in #11096
• Modified LWR Exchange with Surrounding Surfaces with Finite Difference Method by @Nigusse in #11083
• Correct Handling of Improper Design Objects in Radiant/Convective Systems by @RKStrand in #11124
• Correct Error Message Level when Node Types are Undefined by @RKStrand in #11104
• Partial Fix for GetChildrenData Sort Order by @amirroth in #11066
• Fix #11087 - Duplicate Table Names in Tabular Output by @jmarrec in #11106
• Fix a few EIO headers and newlines by @jmarrec in #11126
• Correction of Fanger PMV to Align with ASHRAE Standard 55/ISO 7730 by @RKStrand in #11119
• Fix bad subscript in ZoneVentilation:DesignFlowRate warning by @mjwitte in #11133
• Creation of Error Message for When ZoneControl:Thermostat Refers to Invalid ThermostatSetpoint:* Object by @RKStrand in #11127
• Addition of Error Messages for Cases where Simulation Control Do HVAC is Set to Yes but No Plant:Sizing Objects Present by @RKStrand in #11140
• Fix #11161 - GHA: Windows Server 2019 has been retired. Use 2022 by @jmarrec in #11162
• #11123 - Document that api_data_fully_ready is probably not need for Construction actuators by @jmarrec in #11177
• Clarification of Zone and Surface Opaque Conduction Output Variables by @RKStrand in #11110
• Correction to AirflowNetwork:Multizone:Surface Handling of People Index by @RKStrand in #11167
• Fix #11179 - re-enable warnings gcc clang and turn on -Werror by @jmarrec in #11180
• #11054 - Part 2 - Crash with schedule with missing day types by @jmarrec in #11173
• Correction of Unit Conversion Error for Air Flow per Power Output in IP Unit Table Reports by @RKStrand in #11154
• Fix #11156 - WaterThermalTanks's GetWaterThermalTankInput should trap ErrorsFound and throw a FatalError by @jmarrec in #11172
• #10596 - Remove fmt fortran workarounds - Z & N (and S) by @jmarrec in #11109
• Correct Thermal Comfort Clothing Value Reporting Error by @RKStrand in #11121
• Correct Time Stamp Reported in EDD by @RKStrand in #11139
• Fix #11158 - Add Cooling Coil Condenser Volume (Flow Rate) variables for Coil:Cooling:DX:TwoSpeed by @jmarrec in #11176
• Correction of Return Temperature Output for Cooling Plant Loops and Condenser Loops in EIO Sizing Output by @RKStrand in #11146
• Plant sizing report and equipment summary fixes by @mjwitte in #10998
• EP-Launch - Fix blank utility tab and running AppGPostProcessor by @JasonGlazer in #11219
• Quick fix #11157 - Incorrect StoreType for Zone Combined Outdoor Air Volume Flow Rate output variables by @jmarrec in #11169
• Cycling ratio is applied twice during cycling operation for HeatPump:PlantLoop:EIR:* objects by @lymereJ in #11203
• ZoneHVAC:ExhaustControl correct schedule used for exhaust flow rate calculation by @rraustad in h...

Release Candidate 2 of EnergyPlus 25.2.0

I expect this to be the Bug Fix Freeze checkpoint for EnergyPlus v25.2.0. Barring any major issues, this should be getting fairly close to the final version of v25.2.0.

Release Candidate 1 of EnergyPlus 25.2.0

This is the first release candidate of EnergyPlus v25.2.0.

EnergyPlus 25.2.0, IO Freeze, RC2

Another IOFreeze candidate after a few lingering cleanups.

EnergyPlus 25.2.0, IO Freeze

This is the I/O freeze for 25.2.0, unless some showstopper is identified.

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

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.