Skip to content

OpenStudio-ERI v1.7.0
Compare
Choose a tag to compare
@shorowit shorowit released this 14 Dec 16:43
· 543 commits to master since this release
v1.7.0
085d6cd
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

OpenStudio-ERI version 1.7.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.7.0 uses OpenStudio v3.7.0, EnergyPlus v23.2.0, and HPXML v4.0-rc2. Please visit the OpenStudio-ERI v1.7.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 3.7.0/EnergyPlus 23.2.
  • Breaking change: Updates to HPXML v4.0-rc2:
  • HVAC updates:
    • Updated assumptions for variable-speed air conditioners, heat pumps, and mini-splits based on NEEP data. Expect results to change, potentially significantly so depending on the scenario.
    • Updates deep ground temperatures (used for modeling ground-source heat pumps) using L. Xing's simplified design model (2014).
    • Replaces inverse calculations, used to calculate COPs from rated efficiencies, with regressions for single/two-speed central ACs and ASHPs.
  • Output updates:
    • Breaking change: Disaggregates "EC_x Vent" and "EC_x Dehumid" from "EC_x L&A" in ERI_Results.csv.
    • Adds "Peak Electricity: Annual Total (W)" output.
  • Relaxes requirements for some inputs:
    • SolarAbsorptance and Emittance now only required for exterior walls & rim joists (i.e., ExteriorAdjacentTo=outside).
    • Window/PerformanceClass no longer required (defaults to "residential").
    • Allows above-grade basements/crawlspaces defined solely with Wall (not FoundationWall) elements.
  • Adds ZERH Multifamily v2.
  • Updates to ZERH Single Family v2 windows SHGC in climate zone 4 through 8.
  • Allow JSON output files instead of CSV via a new --output-format JSON commandline argument.

Bugfixes

  • Fixes possible "Electricity category end uses do not sum to total" error for a heat pump w/o backup.
  • Fixes error if conditioned basement has InsulationSpansEntireSlab=true.
  • Fixes error if heat pump CompressorLockoutTemperature == BackupHeatingLockoutTemperature.
  • Fixes ground source heat pump fan/pump adjustment to rated efficiency.
  • Fixes missing radiation exchange between window and sky.
  • Minor HVAC design load calculation bugfixes for foundation walls.
  • Fixes nEC_x calculation for a fossil fuel water heater w/ UEF entered.
  • Various HVAC sizing bugfixes and improvements.
Assets 3