Skip to content

OpenStudio-ERI v1.4.0

Compare
Choose a tag to compare
@shorowit shorowit released this 13 May 01:31
· 1561 commits to master since this release
5ef1477

OpenStudio-ERI version 1.4.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.

Two packages are available, a minimal zip with a handful of weather files and full zip with all US TMY3 weather files. OpenStudio-ERI v1.4.0 uses OpenStudio v3.4.0, EnergyPlus v22.1.0, and a proposed HPXML v4.0. Please visit the OpenStudio-ERI v1.4.0 documentation for instructions on how to get started, how to connect software tools to the workflow, etc.

New Features

  • Updates to OpenStudio 3.4.0/EnergyPlus 22.1.
  • Updates to OpenStudio-HPXML 1.4.0.
  • Implements ANSI/RESNET/ICC Standard 301-2019 Addenda C & D. ERICalculation/Version can now be "2019ABC" or "2019ABCD" in the HPXML files.
    • Adds calculation of CO2e Rating Index and CO2e/NOx/SO2 emissions (annual and hourly).
    • Adds support for shared hot water recirculation systems controlled by temperature.
    • Breaking change: /HPXML/Building/Site is now required with Address/StateCode and Address/ZipCode child elements.
  • Output changes:
    • Adds "Energy Use: Total" and "Energy Use: Net" columns to the ERI____Home.csv output files; allows hourly outputs.
    • Breaking change: New "End Use: <Fuel>: Heating Heat Pump Backup" output, disaggregated from "End Use: <Fuel>: Heating".
  • Breaking change: Deprecates duct leakage to outside exemptions; software tools must provide duct leakage to outside or DSE. SoftwareInfo/extension/ERICalculation/Version enumerations "2014ADEGL", "2014ADEG", "2014ADE" are replaced by "2014AEG" and "2014AE".
  • Breaking change: For CFIS systems, an extension/VentilationOnlyModeAirflowFraction input is now required to address duct losses during ventilation only mode.
  • Allows AirInfiltrationMeasurement/InfiltrationHeight as an optional input; if not provided, it is inferred from other inputs as before.
  • Allows duct leakage to be entered in units of CFM50 as an alternative to CFM25.
  • Adds a --skip-simulation flag that can be used to just generate the ERI Rated/Reference Home HPXMLs and then stop.
  • Adds a --rated-home-only flag to run only the ERI Rated Home simulation (ERI will not be calculated).
  • Simplifies ERI Reference Home configuration with respect to HVAC types and number of DSE distribution systems.

Bugfixes

  • Fixes opaque door R-value in the Reference Home in IECC climate zone 1.
  • Fixes possible NaN result for ERI if, in a very cold climate, the Reference Home has no cooling load.