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

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

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.

Silly mistake caused windows to fail with RC3. That's fixed now. Also this brings in the final bug fix of the release.

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.

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.

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

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

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.

EnergyPlus 24.2.0 (Bug Fix Release)

The U.S. Department of Energy (DOE) has released EnergyPlus version 24.2.0. There were many bug fixes and prominent new features this release. The full changelog for this release cycle is listed below. For more information about EnergyPlus, please visit www.energyplus.net.

🐞 Bug Fix Release 🐞

EnergyPlus 24.2.0 was released previously at sha e7ecb2d. After release a couple issues were identified that justified a re-release (#10766, #10777). This new version is functionally equivalent to the original 24.2.0 except those bug fixes. Even if those bug fixes don't affect your modeling, it is suggested that you use this updated version.

There was a discussion about incrementing the version's patch number to accommodate these changes (24.2.1). Given that we wanted to get this patched version out as quickly as possible without breaking/disrupting any workflows, we decided to just release with the same version number including the zero patch level. We will look into leveraging the patch number more semantically in the future if this situation ever occurs again.

Supported Platforms

• Windows 11 64-bit
• Linux (Ubuntu) 24.04 64 bit
• Mac OSX 11 and 12 64 bit versions, plus ARM support

What's Changed

New Features 🌟

• Add output wetbulb globe temperature in the csv output by @yujiex in #10506
• Adds Heat Recovery to Air-to-Water Heat Pump by @Nigusse in #10455
• Air-To-Water Heat Pump with Heat Recovery by @Nigusse in #10379
• Add the transition rules to accompany #10455 by @Myoldmopar in #10544
• NewFeature: Additional ASHRAE Metrics for E+ 24-1 by @Brijendra21 in #10311
• Variable speed fan powered induction boxes by @lymereJ in #10368
• Added Field to Site:Location to Allow Weather File Location Data to be Overwritten by User Info by @RKStrand in #10586
• Variable flow condenser plant control by @lymereJ in #10511
• Add Reports to Support createRMD - ruleset model description by @JasonGlazer in #10372
• NewFeature: Add measurement unit output for API by @Myoldmopar in #10604
• Allow ZoneHVAC:WindowAirConditioner with Airflow Network simulations by @lymereJ in #10617
• Chiller economizing using thermosiphon or fluid heat exchanger free cooling by @rraustad in #10415
• An Improved Duct Model by @lgu1234 in #10362
• Follow up to #10617 and allow other ZoneHVAC:* component with Airflow Network simulations by @lymereJ in #10637
• Space for IlluminanceMap and Internal Mass by @mjwitte in #10659
• Space Sizing and HVAC Part 4 by @mjwitte in #10566
• A couple API Endpoints by @Myoldmopar in #10658
• Modernized Error Reporting by @Myoldmopar in #9996
• Adopt the Extended Heat Index calculation in zone resilience by @yujiex in #10548
• Initial Python App Packaging by @Myoldmopar in #10716

Defects Repaired 🪲

• Fix (Probable) Fan Coil Sizing Issue by @amirroth in #10461
• Fixes Humidifier:Steam:Gas VariableInletWaterTemperature option by @shorowit in #10463
• Protect for table lookup zero divisor by @Myoldmopar in #10465
• EnergyPlus Crash Due to Zero Input for Variable Speed Coil Total Cooling by @RKStrand in #10470
• Do not apply capacity and power degradation to Coil:Heating:DX:VariableSpeed when timed defrost fraction is 0 by @lymereJ in #10327
• Correction of Location of Zone Equipment Get Routine by @RKStrand in #10482
• Fix Window Heat Transfer and Solar Out Window output reporting by @mjwitte in #10444
• Add new people schedule columns to EIO/initialization summary to address #10314 by @JasonGlazer in #10437
• Include lighting return air fraction input during sizing when ZoneAirMassFlowConservation is used by @rraustad in #10469
• Fix array bounds error with EquivalentLayer window and shading surface by @mjwitte in #10492
• New attempt at fixing #7464: outlet water temperature control issue for variable speed cooling tower by @lymereJ in #10248
• Fix EMS pump pressure override crash by @lgu1234 in #10422
• Water Use Equipment Shows Volumetric Flow Mismatch with Node Data by @RKStrand in #10497
• Fix FMU Variable Update by @mjwitte in #10510
• Correct logic in supplemental water coil used in UnitarySystem by @rraustad in #10479
• Align PlantLowFlowRateToler with DataHVACGlobals::VerySmallMassFlow by @lymereJ in #10457
• Correction of Generic Contaminant Handling in Some Situations by @RKStrand in #10516
• Fix VRF HeatRecovery Check by @mjwitte in #10515
• Fix #10426 - IndoorLivingWall documentation - Fixup units, format equations and equation description and add hyperlinks by @jmarrec in #10530
• Add convergence check for co2 and contaminant by @lgu1234 in #10500
• Fix #10355 - Correctly Set up Zone Internal Gains when Refrigeration:CompressorRack serves a Refrigeration:WalkIn object with "Zone" Heat Transfer Location by @jmarrec in #10525
• Fix #10302 - CalcEquipmentFlowRates assert failure due to out of bounds std::array indexing by @jmarrec in #10528
• Fix #10399 - Long elapsed times are not recorded correctly by @jmarrec in #10529
• #10531 - Use non-deprecated Github Actions by @jmarrec in #10532
• Fix #10365 - IDD Files Have Inconsistent Encoding by @jmarrec in #10526
• Add Reporting of Incident Solar on Shading Surfaces by @RKStrand in #10539
• Fix #10534 - Chiller:Absorption does not autosize in some cases by @jmarrec in #10540
• Addition of Limit Warnings for Node Temperatures in CondFD Solution Algorithm by @RKStrand in #10541
• Fix #9204 - Overcome StdOutputRecordCount's limit of about 2.1 billion by @jmarrec in #10536
• #9138 - Catch blank values in Schedule:File and Schedule:File:Shading and issue error by @jmarrec in #10533
• Initialize NodeData pressure in class initializer and DefaultNodeValues by @tanaya-mankad in #10485
• fix VRF_FluidTCtrl heating round 2 by @yujiex in #10331
• Fix 10519 UtilityCost:Tariff with Electric:Facility showing zero by @JasonGlazer in #10521
• Correction of Mass Flow Rate Calculation for Pools Served by Low Heater Capacity by @RKStrand in #10551
• #10524 - SetpointManager:ReturnTemperature:Chilled/HotWater (useless) warnings from GetSpecificHeatGlycol by @jmarrec in #10535
• Fix #10439 - Problems building with 3.12 on GHA - Bump python to 3.12.2 by @jmarrec in #10554
• Improve error checking in SQLite database connection (again) by @simularis in #10553
• Correction of Enclosure Based Solar Output Variables by @RKStrand in #10563
• change unit of "Zone ITE Adjusted Return Air Temperature" from W to C by @yujiex in #10565
• Make Phase Change and Variable Thermal Conductivity Material Property Input for the CondFD Solution Extensible by @RKStrand in #10556
• Fix array bounds error for interzone windows and fix convexity of mirrored surfaces by @mjwitte in #10498
• Fix #10279 - Make sure that assigning the result of a TendVariable (eg @TrendValue) results in proper actuator behavior by @jmarrec in #10575
• Correction of FEI Calculation by @RKStrand in #10572
• Correction of Hybrid Model Reporting Issues by @RKStrand in #10581
• Improve coil association in ReportCoilSelection coil sizing reports by @rraustad in #10549
• Fix autosize bug in variable speed cooling coils. by @tanaya-mankad in #10503
• Fix duplicate and near-duplicate eio headers by @mjwitte in #10597
• #10122 - Floating point test equa...