Skip to content

OpenStudio-HPXML v1.7.0

Latest
Latest
Compare
Choose a tag to compare
@shorowit shorowit released this 27 Nov 23:46
· 3673 commits to master since this release
v1.7.0
5b26ce2
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-HPXML version 1.7.0 has been released. 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.7.0 uses OpenStudio v3.7.0, EnergyPlus v23.2.0, and HPXML v4.0-rc2. Please visit the OpenStudio-HPXML v1.7.0 documentation for instructions on how to get started, how to generate an appropriate HPXML file, 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:
  • Allows simulating whole multifamily (MF) buildings in a single combined simulation:
    • Breaking change: Multiple elements move from SoftwareInfo/extension to BuildingDetails/BuildingSummary/extension to allow variation across units:
      • HVACSizingControl
      • ShadingControl
      • SchedulesFilePath
      • NaturalVentilationAvailabilityDaysperWeek
    • Allows NumberofUnits to be used as a multiplier on dwelling unit simulation results to reduce simulation runtime.
    • See the OpenStudio-HPXML documentation for more detail.
  • HVAC modeling 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.
    • Allows detailed heating and cooling performance data (min/max COPs and capacities at different outdoor temperatures) for variable-speed systems.
    • 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: "Hot Tub" outputs renamed to "Permanent Spa".
    • Adds "Peak Electricity: Annual Total (W)" output.
    • Adds battery resilience hours output; allows requesting timeseries output.
    • ReportUtilityBills measure: Allows reporting monthly utility bills in addition to (or instead of) annual bills.
  • BuildResidentialHPXML measure:
    • Allow duct area fractions (as an alternative to duct areas in ft^2).
    • Allow duct locations to be provided while defaulting duct areas (i.e., without providing duct area/fraction inputs).
    • Add generic "attic" and "crawlspace" location choices for supply/return ducts, water heater, and battery.
    • Always validate the HPXML file before applying defaults and only optionally validate the final HPXML file.
  • Adds manufactured home belly as a foundation type and allows modeling ducts in a manufactured home belly.
  • Battery losses now split between charging and discharging.
  • Interior/exterior window shading multipliers are now modeled using the EnergyPlus incident solar multiplier.
  • Allows WaterFixture/FlowRate as an alternative to LowFlow; hot water credit is now calculated based on fraction of low flow fixtures.
  • Allows above-grade basements/crawlspaces defined solely with Wall (not FoundationWall) elements.
  • Updates to 2022 EIA energy costs.
  • Added README.md documentation for all OpenStudio measures.

Bugfixes

  • Fixes battery resilience output to properly incorporate battery losses.
  • Fixes lighting multipliers not being applied when kWh/yr inputs are used.
  • Fixes running detailed schedules with mixed timesteps (e.g., hourly heating/cooling setpoints and 15-minutely miscellaneous plug load schedules).
  • Fixes calculation of utility bill fixed costs for simulations with abbreviated run periods.
  • Fixes error if heat pump CompressorLockoutTemperature == BackupHeatingLockoutTemperature.
  • Fixes possible "Electricity category end uses do not sum to total" error for a heat pump w/o backup.
  • Fixes ground source heat pump fan/pump adjustment to rated efficiency.
  • Fixes error if conditioned basement has InsulationSpansEntireSlab=true.
  • Fixes ReportSimulationOutput outputs for the Parametric Analysis Tool (PAT).
  • Fixes missing radiation exchange between window and sky when an interior/exterior window shading multiplier less than 1 exists.
  • Fixes monthly shallow ground temperatures (used primarily in HVAC autosizing) for the southern hemisphere.
  • Various HVAC sizing bugfixes and improvements.
  • Fixes low-speed heating COPs for some two-speed ASHPs and cooling COPs for some single-speed ACs/HPs.
  • BuildResidentialHPXML measure: Fixes air distribution CFA served when there is not a central system that meets 100% of the load.
Assets 3