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

EnergyPlus 23.2.0 IO Freeze

This is the IO freeze of EnergyPlus 23.2.0. Nothing was noted during testing of the test build, so this simply retags the same commit.

23.2 with PLHP Test Fixes (Build 2 of N)

Small change to the condenser side simulate logic for the PLHP. Results look good to me, but needs verification.

23.2 with PLHP Test Fixes (Build 1 of N)

This is a test-only build, primarily for @bonnema and @dareumnam to evaluate fixes for the PLHP model. This test build will be deleted once testing is completed (but of course any confirmed fixes will be in the next official release)

TestPLHPFixes

Use source side loop for source side Cp; try to handle heating demand…

EnergyPlus 23.1.0

EnergyPlus 23.1.0

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

Key notes

• If you are thinking about including EnergyPlus as a part of a larger build, we have started exporting our CMake targets to make it easier to find the CMake pieces you need, see PR #9712
• Pull request #9727 fixed a bug that, in a small corner case, could cause notable differences in results (for the better!) between 22.2 and 23.1
• This will be the last release for Ubuntu 18.04, and probably the last 32-bit Windows release as well.

Supported Platforms

• Windows 10 and 11: 32 and 64-bit versions
• Linux (Ubuntu 18.04, 20.04, 22.04) 64 bit versions
• Mac OSX 10.15, 11, and 12 64 bit versions

What's Changed

New Features 🌟

• Subdivide Heat Balance by Space by @mjwitte in #9394
• Modeling Dynamic Coating for Opaque Surfaces by @yujiex in #9755
• Dynamic coating wall roof feature by @yujiex in #9822
• Gas-Fired Absorption Heat Pump (GAHP) model by @jcyuan2020 in #9405
• NewFeature: Implement Model for Building-Integrated Photovoltaic Thermal (BIPVT) by @khaddad in #9594
• Add ISO 8601 format support to native CSV and JSON output by @jasondegraw in #9848

Performance Enhancing Changes 🏁

• Refactor loops for zone sizing array initialization by @rraustad in #9782
• Enhance perf logging by @lefticus in #9623

Defects Repaired 🪲

• #9676 Follow Up - Make it more resilient to subtle differences in gfortran versions by @jmarrec in #9682
• Fix #9680 - Avoid an override when getObjectItems is called a second time inside getting Internal heat Gains by @jmarrec in #9681
• Correct HVACTemplate:System:VRF minimum heat pump part load ratio by @rraustad in #9708
• Fix documentation and formatting issues by @yujiex in #9735
• Enable PlantEquipmentOperation objects function of outdoor air conditions to work for Plant Loops by @lymereJ in #9727
• Fix unclear error message in UserDefinedComponent by @mitchute in #9745
• Use StdBaroPress in Component Load Summary by @rraustad in #9729
• AirloopHVAC:DedicatedOutdoorAirSystem HX sizes to 0 air flow when autosized by @rraustad in #9705
• Fix 9301 DX Coil incorrect curve that could result severe errors by @jcyuan2020 in #9694
• Fix 9317 space people density report by @jcyuan2020 in #9719
• Fix PTAC node connection error logic by @mjwitte in #9718
• Fix epw holidays header processing and fix eio reporting for holidays by @mjwitte in #9744
• Sizing:System and AirloopHVAC objects in different order causes differences by @rraustad in #9720
• Fix 9686 and 9724---Correct the zone ideal loads SA HumRat value calculation and the units in Total Outdoor Air by AirLoop report table by @jcyuan2020 in #9723
• Removing minimum temperature for HPWH operation by @nmerket in #9759
• Correct setpoint target for EIRPlantLoopHeatPump::getLoadSideOutletSetPointTemp when using a dual setpoint deadband loop demand calculation scheme by @lymereJ in #9741
• Airloop table reports are using cooling coil sizing type instead of Sizing:System Type of Load to Size On by @rraustad in #9725
• Move HeatPump:PlantLoop:EIR:* sizing calculations by @lymereJ in #9734
• Fix the speed control method field of Fan:SystemModel autogenerated by HVACTemplate:Zone:FanCoil by @jcyuan2020 in #9776
• Fix #9772 - AirLoop Component Load Summary report for Cooling Peak Conditions always shows Mixed Air Temperature = 0 by @jmarrec in #9789
• Fix #9709 - Output:Diagnostics:DisplayWeatherMissingDataWarnings returns false warnings by @jmarrec in #9796
• Fix #9710 - Autocalculated Cw factor for ZoneVentilation:WindandStackOpenArea appears wrong by @jmarrec in #9794
• Fix #9790 - Crash with Pipe:Indoor when temperature is below 1.85C by @jmarrec in #9791
• #9753 - Shadow export csv file contains an extra heading field that causes importing back crashing by @jmarrec in #9801
• Fix #9798 - Conversion from std::string to heap-allocated char pointer is missing a +1 by @jmarrec in #9799
• Indexing issue when using multiple CoilSystem objects in OA System by @rraustad in #9786
• Fix water to air heat pump are sized to an infinite capacity by @lymereJ in #9806
• Addresses VRF Terminal Unit Supplemental Heating Coil Control Problem by @Nigusse in #9768
• Addresses Chillers IPLV calculation issue and missing warning when the curves limit are outside the AHRI test condition by @Nigusse in #9830
• Fix #9835 - The "value" datatype is incorrect in TabularData by @piaoger in #9836
• Fix #9780 - Blank epJSON inputs needed for ZoneHVAC:EquipmentList by @jmarrec in #9808
• #9803 - GetVRFInputData throws a vector error when using multiple VRF types by @jmarrec in #9804
• Electric Heating Coil Inlet and Outlet Air Conditions and Sensible Capacity Tabular Reporting Issue for Four Pipe FCU by @Nigusse in #9826
• Fix UnitarySystem Setpoint Control by @mjwitte in #9850
• #9817 - Enable hardened runtime on Windows installers by @jmarrec in #9866
• Cppcheck errors isolated by @jmarrec in #9859
• Fix issues with zero floor area or zero surfaces due to air boundaries by @mjwitte in #9855
• Fix for the water use inconsistent corner case by @jcyuan2020 in #9778
• Addresses unitary system no load supply air flow rate incorrect sizing report by @Nigusse in #9837
• Fix #9831 - Issue running a model with PIU + ReturnPlenu by @jmarrec in #9843
• Addresses MultiSpeed AirToAirHP Total Electricity Rate is Double Counting the Supplemental Heater Electricity Rate by @Nigusse in #9841
• Avoid overwriting native csv output by @mjwitte in #9869
• Addresses Defrost Cycle Electricity Rate is not Included in Unitary System Electricity Rate by @Nigusse in #9844
• Fix issue with VRF Heat Pump COP and Electricity Rate by @jcyuan2020 in #9792
• EMS coil speed actuator not working for multispeed coils in UnitarySystem by @rraustad in #9761
• Address incorrect average temperature used for condensate volume calculation in DX and Water cooling coils by @Nigusse in #9863
• Update Kiva to version 0.6.6 by @nealkruis in #9884
• Correct error in collection of AirflowNetwork element data by @jasondegraw in #9889
• Minor cleanups to plugins messages by @mitchute in #9915

Under the Hood Refactoring ⚙

• Quick SolveRoot cleanup by @Myoldmopar in #9670
• Simple water-to-air heat pump code clean up by @lymereJ in #9648
• Clean up Par arrays in SolveRoot calls by @jmythms in #9693
• Solve root cleanups continued by @Myoldmopar in #9766
• Quick curve manager cleanup by @Myoldmopar in #9770
• Refactor int to enum as a follow up to previous code changes by @rraustad in #9765
• Curve Manager Round 2 by @Myoldmopar in #9779
• Quick cleaning in General.cc by @Myoldmopar in #9823
• Refactor in RefrigeratedCase and new unit test process_idf for string_view by @Myoldmopar in #9854
• Fix bad uses of (plain) auto part 1: files A-F by @amirroth in #9858
• MaterialProperties Refactoring step 2 by @yujiex in #9812

New Contributors

• @piaoger made their first contribution in #9836
• @khaddad made their first contribution in https://github.com/NREL/EnergyPlus/...

EnergyPlus 23.1.0 IOFreeze

This is the I/O freeze for 23.1, which is mainly intended as a stopping point for IDD and major output changes. I ran the full set of example files successfully, and my full suite of API tests also pass.

EnergyPlus 22.2.0

EnergyPlus 22.2.0

The U.S. Department of Energy (DOE) has released EnergyPlus version 22.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: 32 and 64-bit versions
• Linux (Ubuntu 18.04, 20.04, 22.04) 64 bit versions
• Mac OSX 10.15, 11, and 12 64 bit versions

What's Changed

New Features 🌟

• Change version numbering approach to YY.N by @Myoldmopar in #9169
• Add workflow file for ConvertInputFormat by @JasonGlazer in #9182
• Enhancing Multi-speed Coil Speed Level Control Actuators by @xuanluo113 in #9185
• CondFD Surface Heat Source Actuators by @mitchute in #9151
• Adding SetpointManager:SystemNodeReset objects by @WooyoungJung0115 in #9261
• Flag added to toggle daylight saving when used with Schedule:File by @prsh5175 in #9251
• Enhancement of Handling of Rainfall by @yujiex in #9177
• Add Window Assembly Factor Reporting and Fix Windows-CalcEngine U-value calculation with shade by @JasonGlazer in #8740
• Dedicated general exhaust system by @jcyuan2020 in #9209
• AirflowNetwork Duct Autosizing by @lgu1234 in #9465
• New Feature Multiple Ground Temperature and Ground Reflectance by @Nigusse in #9409
• Allow running just load calculations and no full simulations by @EnergyArchmage in #9402
• Allow Coil:WaterHeating:Desuperheater to use Coil:Cooling:DX by @mitchute in #9051
• Add staging actuator to Coil:Heating:Electric:MultiStage by @yzhou601 in #9392
• New Feature - Latent Sizing by @rraustad in #9406
• ZoneHVAC:PackagedTerminalAirConditioner transition to UnitarySystem by @mjwitte in #9273
• Support Space for Infiltration and Ventilation by @mjwitte in #9564
• Enhancement to Resilience Metrics by @yujiex in #9156
• Add reference temperatures for water-to-air cooling/heating coil sizing by @lymereJ in #9439
• Enhancement to Simplified Shading by @yujiex in #9404
• Support Space for Mixing and CrossMixing by @mjwitte in #9595
• Add ASHRAE Standard 205 Chiller object by @tanaya-bigladder in #9463
• Luminance-based window shading control per 90.1 Appendix C requirements by @leijerry888 in #9571
• 7038 90.1 metric by @TMaile in #9480
• SEER2 Calculations for Coil:Cooling:DX > CurveFitPerformance > CurveF… by @Brijendra21 in #9618

Performance Enhancing Changes 🏁

• Comment and cleanup of heat balance arrays by @xuanluo113 in #9097
• Daylighting output revisions and other cleanup related to Enclosures vs Zones by @mjwitte in #9102
• Speed up execution of test suite by @lefticus in #9255
• Add Exterior solar surface lists and maybe other performance tweaks by @mjwitte in #9424
• 9560 eliminate loop for surface heat transfer algorithm and replace with select reset by @rraustad in #9561
• Test SetupOutputVariable changes to accept std::string_view type for parameters by @jcyuan2020 in #9557
• Update MovingAvg function by @rraustad in #9600
• Use currDifSolarRad, currBeamSolarRad to hold adjusted solar and other cleanups in the incident solar multiplier feature by @yujiex in #9634

Defects Repaired 🪲

• Fix Python Prefix Warnings by @Myoldmopar in #9126
• Corrected a link in the readme by @DaveInCaz in #9115
• Fix Bugs in Emmel and Blocken Convection Algorithms by @mitchute in #9129
• Post release I/O changes of the simple glazing frame feature by @xuanluo113 in #9117
• EIO transition changes for simple glazing by @xuanluo113 in #9179
• Fix Space issues: documentation, DesignSpecification:OutdoorAir:Spacelist, and Daylighting:ReferencePoint, InternalMass by @mjwitte in #9132
• Fix multiple absorption chillerheater objects input processing by @jcyuan2020 in #9162
• EPLaunch classic to support two digit version numbers by @JasonGlazer in #9192
• Correct and update all emissions meter source names from 'Electric' to 'Electricity' for consistency. by @matthew-larson in #9101
• Resolve warnings/errors for unreasonable DHW temperatures in Example Files by @matthew-larson in #9078
• Fix Emission Output Variable Names "Environmental Impact OtherFuel1 CO2 Water Consumption Volume" and "Environmental Impact OtherFuel2 CO2 Water Consumption Volume" by @matthew-larson in #9089
• Fix barometric pressure in some DX coil unit tests by @mjwitte in #9208
• Fix zonehvac baseboardradiantconvective, low temperature radiant tube length, and wall:detailed vertice transitions by @jcyuan2020 in #9139
• CondFD Conductivity/Specific Heat Actuator Bug by @mitchute in #9221
• Fix EPW parsing bug by @mbadams5 in #9216
• Add additional python path for use with EP-Launch by @matthew-larson in #8985
• Fix kiva clockwise geometry rule issue by @jcyuan2020 in #9104
• Fix Rounding of minutes Function by @mitchute in #9234
• Fix 9215 central heat pump schedule by @jcyuan2020 in #9226
• Fix enclosure merging when using Construction:AirBoundary by @mjwitte in #9237
• Fix GHE Error Handling by @mitchute in #9259
• Allow multiple python plugin variable objects in idd by @Myoldmopar in #9271
• Fix PixelCounting exception thrown by OpenGL destruction in Windows. by @tanaya-bigladder in #9257
• Fix #8999 - OutputControl:Files is marked unused by @jmarrec in #9292
• Fix Schedule Limits Error Message by @mitchute in #9278
• Pin a specific python version on Github Actions by @jmarrec in #9276
• Fix #9150 - Wild card in meter name no longer works for Output:Meter by @jmarrec in #9293
• Fix Issues with IDFVersionUpdater by @JasonGlazer in #9283
• #9228 - Tabular file not generated with only Output:Table:Annual by @jmarrec in #9296
• #9190 - Site:WaterMainsTemperature CorrelationFromWeatherFile uses bogus values by @jmarrec in #9295
• Fix Integrated Heat Pump Output Variable Setup by @mitchute in #9249
• ZoneHVAC:UnitVentilator shows different autosized min/max OA flow rates for FixedAmount OA control option by @rraustad in #9285
• Add coil cooling dx saturation check by @mjwitte in #9187
• 9202 9222 reset delete state python by @jmarrec in #9304
• Correct Window5 Data File window name if it contains spaces by @matthew-larson in #9324
• Correct Kiva::setMessageCallback std:pair argument by @matthew-larson in #9316
• Fix public linkage of energypluslib to energyplus.exe by @tanaya-bigladder in #9297
• Reset sizing averaging window size when using performance precision modes by @xuanluo113 in #9180
• Add warning for Kiva deep-ground boundary condition and deep-ground depth for auto by @matthew-larson in #9328
• AirLoopHVAC:DedicatedOutdoorAirSystem does not size correctly when multiple DOAS systems are simulated by @rraustad in #9327
• Fix User-input Floor Area for Zone and Space by @mjwitte in #9308
• Fix 8638 chiller condenser recurring warnings by @jcyuan2020 in #9231
• Modify ground surface conduction calculation for Kiva surfaces and ensure conduction heat balance by @matthew-larson in #9269
• Fix #7511 which shows warning for too many controlled sha...

IO Freeze of EnergyPlus 22.2

With the release packages building again, this should be the IO freeze tag.

Version 9.6 with Space Fix and Python 3.7

Internal build. Please do not delete (@bonnema).