EnergyPlus 23.2.0
EnergyPlus 23.2.0
The U.S. Department of Energy (DOE) has released EnergyPlus version 23.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.
Supported Platforms
- Windows 10 and 11: 64-bit versions, 32-bit installers are provided, but we will not be supporting them much longer!
- Linux (Ubuntu 20.04 and 22.04) 64 bit versions
- Mac OSX 10.15, 11, and 12 64 bit versions
What's Changed
New Features 🌟
- Add a couple new API endpoints by @Myoldmopar in #9973
- 90.1 metrics - EER/IEER by @RichSee in #9756
- Evaporative cooler RH control by @yujiex in #9950
- Add Vertical (1-D) Solution to Earth Tube Object by @RKStrand in #10138
- Add
Boiler:HotWater
parasitic fuel field by @shorowit in #9925 - NFP For Ruleset Model Description Phase 2 by @JasonGlazer in #10051
- Improved Support for Multi-speed Fans by @lgu1234 in #9746
- Enhancement to crankcase heater by @yujiex in #9949
- Multistage economizer control by @lymereJ in #9987
- New plant heat pump features and supervisory controller by @rraustad in #9979
- Extend Spaces to Sizing and HVAC by @mjwitte in #9982
- Implement steam features Part 1 by @dareumnam in #9260
- Ruleset Model Description Phase 2 by @jcyuan2020 in #10143
- Space Sizing and HVAC Part 3 by @mjwitte in #10205
- Space Sizing and HVAC Documentation and Unit Test Updates by @mjwitte in #10239
Defects Repaired 🪲
- Address surfaceProperty:ExteriorNaturalVentedCavity results in convection model errors issue by @Nigusse in #9908
- Address Improve documentation for Zone Air Heat Balance Internal Convective Heat Gain Rate by @Nigusse in #9914
- Fixes Kiva:Foundation using wrong initial temperature by @shorowit in #9923
- Minimal fix for VS Furnace Flow Rate when Fan is Off by @mjwitte in #9940
- Fix "Infiltration Sensible Heat Gain Energy" output by @shorowit in #9935
- Corrects Surface Surrounding Surfaces Count Seen by An Exterior Surface by @Nigusse in #9944
- Protect lookup in zone index to avoid crash in debug by @Myoldmopar in #9985
- Address UnitarySystem used as zone equipment does not allow NightCycle availability manager control by @Nigusse in #9974
- #9957 #9998 - get_construction_handle should be available to the EnergyPlus API and not limited to PythonPlugin + API fixes by @jmarrec in #9999
- Fix possible incorrect surface azimuth angle calculations when a surface has non convex vertice by @jcyuan2020 in #9907
- Use rotational angle diffs when comparing the Azimuth angles differences between two surfaces by @jcyuan2020 in #9920
- Fix EMS control of shading surface transmittance by @mjwitte in #10008
- Address Zone Component Load Summary - DOAS Direct to Zone Output Zone Multiplier Issue by @Nigusse in #10025
- API-ish Cleanups May 2023 by @Myoldmopar in #10044
- Correct HTML code when reporting
≤
and≥
by @lymereJ in #10047 - Address peak sensible load with sizing factor at cooling peak conditions reports zero value by @Nigusse in #9970
- Address AirloopHVAC:UnitarySystem CoolReheat Humidity Control Problem by @Nigusse in #10021
- Correction of Calculation Error when using Multiple Swimming Pools by @RKStrand in #10039
- Address Output Report - System Sizing Information Time of Peak Cooling and User Design Capacity In IP Units are Wrong by @Nigusse in #9967
- Fix #10068 - Progress Callback should report 100 when simulation completely succesfully by @jmarrec in #10070
- Fixes failed unit tests when no cooling design day by @Nigusse in #10071
- Fix overlapping shadow calculations for shading surface transmittance >0 and <1 by @mjwitte in #10040
- Fix EIO airflow and capacity reporting for
Coil:Cooling:DX:Multispeed
by @lymereJ in #10036 - Fix #9787 - Large negative values in tables can come out as "Too Big" when they should switch to scientific notation by @jmarrec in #10098
- Fix several issues in checkSubSurfAzTiltNorm() and GetSurfaceData() (lcsz assignment, enum loop etc) by @jcyuan2020 in #9905
- Fix #10064 - EPW file not working if it doesn't have an ending newline by @jmarrec in #10097
- Correction of Bug in HW Baseboard Get Input Routine by @RKStrand in #10078
- Fix issue of reading ConstructionProperty:InternalHeatSource with empty Two-Dimensional Temperature Calculation Position by @yujiex in #9963
- edited curve names to match tables J5/J7 (> changed to >=) by @aowabinr in #10113
- fix curve arg order in documentation in AirConditioner:VariableRefrigerantFlow:FluidTemperatureControl by @yujiex in #10099
- Fix #10103 - CheckConvexity removes colinear vertices but stops when surface is determined non-convex, causing vertex size mismatch fatal error by @jmarrec in #10114
- #9825 - Handle non ASCII command line parameters such as path by @jmarrec in #10120
- Fix reversed low vs high curves in ResidentialACsAndHPsPerfCurves.idf by @shorowit in #10087
- Provide a correct field index to report field input in an error message for Coil:Cooling:DX:MultiSpeed by @lgu1234 in #10126
- Address DOAS Zone Load Calculation Uses Incorrect Mass Flow Rate by @Nigusse in #10030
- Make Water-to-Air Heat Pump cycling and latent degradation consistent with other coils by @nealkruis in #10043
- Prevent division by zero in WAHP heating design day calculations by @lymereJ in #10141
- Implementation of Checks on Charging and Discharging Voltage Curves in Kinetic Battery Model by @RKStrand in #10094
- #9679 - #10111 - Generation of the epJSON schema (python, not embedded) hangs on invalid IDD by @jmarrec in #10149
- Rename SurfaceProperty:LocalEnvironment Input Field and Add Check for Schedules by @RKStrand in #10151
- #9825 - Handle non ASCII command line parameters such as path by @jmarrec in #10148
- Fix Bug in Ground Temperature Model by @mitchute in #10170
- Fix variable speed heating coil defrost power by @jcyuan2020 in #10109
- Update film resistance used in Construction:FfactorGroundFloor effective thermal resistance of the fictitious insulation layer by @rraustad in #10117
- Issue severe errors for component node connection in AirLoopHVAC:OutdoorAirSystem:EquipmentList by @lgu1234 in #10042
- Correction of Incorrect Reporting of Solar at Night with Interzone Windows by @RKStrand in #10083
- Allow zone/space output aggregation of OtherEquipment objects with different fuels by @shorowit in #10131
- Fix #10037 - Allow DDY file to epJSON with ConverterInputFormat by @jmarrec in #10216
- Fix #10190 - Zero DistrictHeatingStream reported in ABUPS by @jmarrec in #10212
- AirloopHVAC:UnitarySystem crashes when no heating coil exists and CoolReheat or Multimode dehumidification is used by @rraustad in #10128
- Fix the default parameter type for the exhaust control function by @jcyuan2020 in #9953
- Variable Relocation for Various Models using Radiant Style Updating by @RKStrand in #10076
- OA Systems with HXAssisted coils fail when both water and DX coils are used leading to invalid warnings and fatal error by @rraustad in #10144
- Correction of Mass Flow Conservation Crash with Uncontrolled Zone using Mixing by @RKStrand in #10217
- Fixes multispeed DX coil defrost calculation when using ReverseCycle w/ Timed control by @shorowit in #10186
- Fix the Heat Pump Water Heater Information table by @shorowit in #10214
- Fix #9621 - AllSummaryAndMonthly option in Output:Table:SummaryReports prompts many warnings and incomplete reports by @jmarrec in #10211
- Fix default design condenser inlet and design evaporator outlet temperatures for Chiller:ConstantCOP by @jcyuan2020 in #10158
- Additional rotational azimuth angles differences changes across the code by @jcyuan2020 in #10014
- UFAD Inconsistencies in Plume Power Calculations by @RKStrand in #10156
- Fix water heater outputs in documentation by @shorowit in #10207
- Fix #9873 - GetVertices is dropping vertices inconsistently, causing fatal error by @jmarrec in #10115
- Fix WaterHeaterReportMonthly source energy output field by @shorowit in #10209
- Follow up fix for PR 9905 checkSubSurfAzTiltNorm() by @jcyuan2020 in #10104
- Corrects ADU upstream air leakage model to use the maximum available flow rate for CV air terminals by @Nigusse in #10124
- Fixing VRF fluid control model heating issue in compressor speed decrease with temperature, TU heating rate much larger than system by @yujiex in #10154
- Energy Meters Table and Increase Decimals for Air Flow (bug fixes to issues #9642 and #9589) by @KarenWGard in #10150
- Correction of Outside Face Conductive Flux Output Variable by @RKStrand in #10090
- Fix issue 9241 leap day monthly reporting by @JasonGlazer in #10185
- escape objectName for xml by @marklemay in #10167
- Fix #10210 - add Calendar Year to ERL, C and Python API by @jmarrec in #10221
- Fix #10220 - LifeCycleCost objects are using "Steam" not "DistrictHeatingSteam" by @jmarrec in #10229
- Fix #9878 - ChillerHeater:Absorption:DoubleEffect should calculate Specific heat of Water and Air at the right temperatures by @jmarrec in #10230
- Correction to Reporting of a Conduction Finite Difference Flux Imbalance by @RKStrand in #10227
- Fixes issue 10055 - If zone sizing is zero and system sizing is zero there is a fatal error leaving no information to help diagnose why by @KarenWGard in #10193
- Fix floor solar heat gain issue from incident solar multiplier by @yujiex in #10010
- Steam features part 1 (#9260) follow-up by @dareumnam in #10222
- V23.2.0-IOFreeze: IDD and transition fixes by @jmarrec in #10215
- Update VRF Heat Pump Cooling/Heating COP documentation by @mdahlhausen in #10085
- DHW end use category changed to WaterSystems by @jcyuan2020 in #10011
- HeatPump:PlantLoop:EIR:* objects using the same inlet/outlet source node is incorrect 9740 by @KarenWGard in #10199
- Allow heat recovery for air-cooled EIR chillers by @rraustad in #10240
- Fix crash with new Multi-speed Fans for WSHP Zone Equipment by @rraustad in #10249
- Correct autosized heat recovery volume flow rate for air-cooled equip… by @rraustad in #10242
- AirLoopHVAC:UnitaryHeatCool:VAVChangeoverBypass with CoilSystem:Cooling:DX:HeatExchangerAssisted shows false fatal error by @rraustad in #10254
- AirLoopHVAC:UnitaryHeatCool:VAVChangeoverBypass with Fan:SystemModel crashes by @rraustad in #10251
Under the Hood Refactoring ⚙
- Integration of FuelTypeName enums & Removal of functions about FuelTypeNames by @dareumnam in #9771
- Improved ReadTheDocs Documentation by @Myoldmopar in #9981
- OA Limiting Factor enum and Related Cleanup by @mjwitte in #9947
- Refactor AvailabilityManager status to equipment managers by @rraustad in #9976
- Refactor logic in VRF control function to simplify code readability by @rraustad in #10015
- Integration of FuelTypeName enums Round 2 by @dareumnam in #10013
- Integration of FuelTypeName enums final round by @dareumnam in #10125
- Update penumbra by @nealkruis in #10202
New Contributors
- @RichSee made their first contribution in #9756
- @mduvanel made their first contribution in #10139
- @KarenWGard made their first contribution in #10150
- @marklemay made their first contribution in #10167
- @chen1682-ntu-edu-sg made their first contribution in #10219
Full Changelog: v23.1.0...v23.2.0