OpenStudio-ERI version 1.12.0 has been released. The OpenStudio-ERI workflow calculates an Energy Rating Index (ERI) using the Department of Energy's OpenStudio/EnergyPlus building simulation platform. The open-source workflow is intended to be used by residential software tools that provide a HPXML building description file.
OpenStudio-ERI v1.12.0 uses OpenStudio v3.11.0, EnergyPlus v25.2.0, and HPXML v5.0-rc1. Please visit the OpenStudio-ERI v1.12.0 documentation for instructions on how to get started, how to connect software tools to the workflow, etc. The full set of US TMY3 weather files can be obtained from here.
New Features
- Updates to OpenStudio-HPXML 1.12/OpenStudio 3.11/EnergyPlus 25.2.
- Updates to HPXML v5.0-rc1.
- Breaking change: HPXML namespace changed from http://hpxmlonline.com/2023/09 to http://hpxmlonline.com/2025/12.
- Updated DX heat pump and air conditioner models per HERS Addendum 103.
- Compressor lockout temperatures for Rated Home defaults and Reference Home updated from 0F (single/two stage) and -20F (variable speed) to 5F and -10F, respectively.
- Dual-fuel heat pumps now have the HP sized using the greater of the heating design temperature and 25F.
- Pan heaters no longer operate when the outdoor temperature is below the compressor lockout temperature.
- Adds a warning if there are more than 300 unmet hours for heating or cooling; setpoint tolerance increased from 0.36 deg-F (0.2 deg-C) to 0.5 deg-F.
- Runtime speed improvements for homes with multiple ground source heat pumps.
- Utility bill scenarios can now be defined for the Rated/Reference Homes; see the documentation for more information.
- The
Battery/NominalCapacityinput is no longer used. - Output updates:
- Breaking change: Annual peak load outputs for heating and cooling now use units of Btu/h instead of kBtu/h for consistency with other outputs.
- Updates schematron validation error messages to be more user friendly.
Bugfixes
- Fixes incorrect hot water (gallons) output for solar thermal systems using
SolarFraction. - Fixes possible "Failed to process String" EnergyPlus error when requesting component loads.