Skip to content

OpenStudio-HPXML v1.0.0

Compare
Choose a tag to compare
@shorowit shorowit released this 29 Oct 15:18
· 11626 commits to master since this release

OpenStudio-HPXML version 1.0.0 has been released. Two packages are available, a minimal zip with a handful of weather files and full zip with all US TMY3 weather files.

The OpenStudio-HPXML workflow uses HPXML building description files to run residential simulations on the Department of Energy's OpenStudio/EnergyPlus building simulation platform.

OpenStudio-HPXML v1.0.0 uses OpenStudio v3.1.0, EnergyPlus v9.4.0, and a proposed HPXML v3.1.

Please visit the OpenStudio-HPXML v1.0.0 documentation for instructions on how to get started, how to generate an appropriate HPXML file, etc.

New Features

  • Updates to OpenStudio 3.1.0/EnergyPlus 9.4.0.
  • Breaking change: Deprecates WeatherStation/WMO HPXML input, use WeatherStation/extension/EPWFilePath instead; also removes weather_dir argument from HPXMLtoOpenStudio measure.
  • Implements water heater Uniform Energy Factor (UEF) model; replaces RESNET UEF->EF regression. Breaking change: FirstHourRating is now a required input for storage water heaters when UEF is provided.
  • Adds optional HPXML fan power inputs for most HVAC system types. Breaking change: Removes ElectricAuxiliaryEnergy input for non-boiler heating systems.
  • Uses air-source heat pump cooling performance curves for central air conditioners.
  • Updates rated fan power assumption for mini-split heat pump models.
  • Allows coal fuel type for non-boiler heating systems.
  • Accommodates common walls adjacent to unconditioned space by using HPXML surfaces where InteriorAdjacentTo == ExteriorAdjacentTo.
  • Adds optional HPXML inputs to define whether a clothes dryer is vented and its ventilation rate.
  • Adds optional HPXML input for SimulationControl/CalendarYear for TMY weather files.
  • Schematron validation improvements.
  • Adds some HPXML XSD schema validation and additional error-checking.
  • Various small updates to ASHRAE 140 test files.
  • Reduces number of EnergyPlus output files produced by using new OutputControlFiles object.
  • Release packages now include ASHRAE 140 test files/results.

Bugfixes

  • EnergyPlus 9.4.0 fix for negative window solar absorptances at certain hours.
  • Fixes airflow timeseries outputs to be averaged instead of summed.
  • Updates HVAC sizing methodology for slab-on-grade foundation types.
  • Fixes an error that could prevent schematron validation errors from being produced.
  • Skips weather caching if filesystem is read only.