Skip to content

OpenStudio-ERI v0.4.0 Beta

Pre-release
Pre-release
Compare
Choose a tag to compare
@shorowit shorowit released this 25 Oct 17:11
· 5796 commits to master since this release
v0.4.0-beta
514e242
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 0.4.0 Beta 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 v0.4.0 Beta uses OpenStudio v2.9.0, EnergyPlus v9.2.0, and a proposed HPXML v3.0.

Please visit the OpenStudio-ERI v0.4.0 Beta documentation for instructions on how to get started, how to connect software tools to the workflow, etc.

Breaking Changes

  • Requires OpenStudio 2.9.0
  • The root HPXML element needs to be changed from http://hpxmlonline.com/2014/6 to http://hpxmlonline.com/2019/10 per the latest HPXML v3 schema.
  • Slab/DepthBelowGrade is now required when Slab/InteriorAdjacentTo=’garage’.
  • FrameFloor/ExteriorAdjacentTo must now be either 'other housing unit above' or 'other housing unit below' instead of 'other housing unit'.
  • HeatPump/HeatingCapacity is now a required element.
  • Several reporting changes for results/ERI____Home.csv output files:
    • Hot water recirculation pump energy is now disaggregated.
    • Lighting energy is disaggregated into interior vs exterior vs garage.
    • Hot water load related to tank losses are now reported.
    • Summer/winter peak electricity consumption values are now reported.
    • Peak heating/cooling loads are now reported.
  • A couple reporting changes for HERS test results:
    • Hot water tests: Hot water recirculation pump energy is now disaggregated.
    • ASHRAE 140 tests: Load results are separated into heating/cooling categories.

New Features

  • Adds an optional --hourly-output argument to request an hourly output CSV file that includes zone temperatures and energy uses disaggregated by fuel.
  • Adds ability to model a desuperheater attached to a ground source heat pump, air source heat pump, or air conditioner.
  • Adds SensibleHeatFraction as a new optional input for air conditioners.
  • Adds CoolingSensibleHeatFraction and HeatingCapacity17F as new optional inputs for heat pumps.
  • Improves modeling of ERVs/HRVs (compared to mechanical ventilation systems without energy recovery).
  • Improves modeling of conditioned basements (radiation heat exchange and solar distribution).
  • Improves modeling of exterior incident solar for walls/roofs/etc. without an Azimuth provided.
  • Allows tests to be run in parallel without clobbering each other on the filesystem.

Bugfixes

  • Prevent E+ simulation error due to near zero autosized heating/cooling airflow rate.
  • Fixes incorrect reference in EPvalidator.rb for FoundationWall.
  • Fixes possible "Cannot create a surface with vertices" error.
  • Fixes possible "Unable to calculate a construction for using the provided assembly R-value" errors.
  • Fixes possible "Electric category end uses do not sum to total" error for heat pumps.
  • Fixes possible "Sum of conditioned floor surface areas is greater than ConditionedFloorArea specified" error for buildings with adiabatic ceilings.
  • Fixes possible "Two airloops found for CFIS" error.
  • Fixes error when a FoundationWall is completely below-grade (i.e., DepthBelowGrade = Height).
  • Fixes the infiltration rate in the conditioned basement ASHRAE 140 tests (L322XC and L324XC) and other HERS tests derived thereof.
  • Fixes HERS hot water tests not passing when pasted into the RESNET spreadsheet.
  • Fixes modeling of leakage to outside when all ducts are in conditioned space.
  • Fixes modeling tankless water heaters when the home has >5 or <1 bedrooms.
  • Fixes error for HVAC systems with zero heating/cooling capacity.
  • Fixes error for duct locations that have only supply (or only return) ducts.
  • Various minor fixes to HERS test files.
  • Adds better error-checking if surfaces are missing -- for example, a garage ceiling/roof.
  • Adds error-checking for stranded HVACDistribution elements (i.e., not referenced by an HVAC system).
  • Adds error-checking for a negative water heater standby loss coefficient (UA).

Known Issues

  • Energy results for combination boilers may be incorrect by a few percentage points. The issue is still being investigated.
Assets 2