Skip to content

OpenStudio-ERI v1.5.0
Compare
Choose a tag to compare
@shorowit shorowit released this 19 Nov 02:13
· 935 commits to master since this release
v1.5.0
8e8601e

OpenStudio-ERI version 1.5.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.5.0 uses OpenStudio v3.5.0, EnergyPlus v22.2.0, and a proposed HPXML v4.0. Please visit the OpenStudio-ERI v1.5.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.5.0/EnergyPlus 22.2.
  • Updates to newer proposed HPXML v4.0:
    • Breaking change: Replaces FrameFloors/FrameFloor with Floors/Floor.
    • Breaking change: Floor/FloorType (WoodFrame, StructuralInsulatedPanel, SteelFrame, or SolidConcrete) is a required input.
    • Breaking change: All Ducts must now have a SystemIdentifier.
    • Breaking change: Replaces WallType/StructurallyInsulatedPanel with WallType/StructuralInsulatedPanel.
    • Breaking change: Replaces StandbyLoss with StandbyLoss[Units="F/hr"]/Value for an indirect water heater.
    • Breaking change: Replaces BranchPipingLoopLength with BranchPipingLength for a hot water recirculation system.
    • Breaking change: Replaces Floor/extension/OtherSpaceAboveOrBelow with Floor/FloorOrCeiling.
    • Breaking change: For PTAC with heating, replaces HeatingSystem of type PackagedTerminalAirConditionerHeating with CoolingSystem/IntegratedHeating* elements.
  • Breaking change: Now performs full HPXML XSD schema validation (previously just limited checks); yields runtime speed improvements.
  • Adds ENERGY STAR ERI calculation for SF National v3.2 and MF National v1.2.
  • Adds IECC ERI pathway calculation (2015, 2018, 2021).
  • Adds Zero Energy Ready Homes calculation for v1.
  • Allows SEER2/HSPF2 efficiency types for central air conditioners and heat pumps.
  • Allows calculating all programs (e.g., ERI, ENERGY STAR, IECC, etc.) simultaneously while avoiding duplicate EnergyPlus simulations.
    • Breaking change: Deprecates energy_star.rb script; energy_rating_index.rb will now run all programs specified in the HPXML.
    • Breaking change: The organization of ENERGY STAR output files have changed.
  • Allows modeling CFIS ventilation systems with a supplemental fan.
    • Breaking change: New CFISControls/AdditionalRuntimeOperatingMode input required for CFIS ventilation systems.
  • Breaking change: The ClimateZoneIECC/Year is now more strict:
    • All runs must include a 2006 IECC climate zone.
    • IECC ERI pathway runs must include an IECC climate zone of the same year.
    • ENERGY STAR ERI runs for SF National v3.2 and MF National v1.2 must include a 2021 IECC climate zone.
    • Zero Energy Ready Homes v1 runs must include a 2015 IECC climate zone.
  • Allows modeling room air conditioners with heating or reverse cycle.
  • Allows shared dishwasher/clothes washer to be attached to a hot water distribution system instead of a single water heater.
  • Adds HVAC capacities, design loads, and design temperatures to csv output files.
  • Annual/timeseries outputs:
    • Adds annual emission outputs disaggregated by end use; timeseries emission outputs disaggregated by end use can be requested.
    • Allows generating timeseries unmet hours for heating and cooling.
    • Adds heating/cooling setpoints to timeseries outputs when requesting zone temperatures.
  • Improves Kiva foundation model heat transfer by providing better initial temperature assumptions based on foundation type and insulation levels.

Bugfixes

  • Fixes units for Peak Loads (kBtu/hr, not kBtu) in ERI____Home.csv output files.
  • Bugfix for increasing HVAC capacities due to installation grading.
  • Fixes possible output error for ground source heat pumps with a shared hydronic circulation loop.
  • Fixes zero energy use for a ventilation fan w/ non-zero fan power and zero airflow rate.
Assets 3