Skip to content

OpenStudio-HPXML v0.11.0 Beta

Pre-release
Pre-release
Compare
Choose a tag to compare
@shorowit shorowit released this 22 Sep 14:52
· 11930 commits to master since this release
v0.11.0-beta
64b2d46

OpenStudio-HPXML version 0.11.0 Beta 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 v0.11.0 Beta uses OpenStudio v3.0.0, EnergyPlus v9.3.0, and a proposed HPXML v3.1.

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

New Features

  • New Schematron validation (EPvalidator.xml) replaces custom ruby validation (EPvalidator.rb)
  • [Breaking Change] BuildingConstruction/ResidentialFacilityType ("single-family detached", "single-family attached", "apartment unit", or "manufactured home") is a required input
  • Ability to model shared systems for Attached/Multifamily dwelling units
    • Shared HVAC systems (cooling towers, chillers, central boilers, water loop heat pumps, fan coils, ground source heat pumps on shared hydronic circulation loops)
    • Shared water heaters serving either A) multiple dwelling units' service hot water or B) a shared laundry/equipment room, as well as hot water recirculation systems
    • Shared appliances (e.g., clothes dryer in a shared laundry room)
    • Shared hot water recirculation systems
    • Shared ventilation systems (optionally with preconditioning equipment and recirculation)
    • Shared PV systems
    • [Breaking Change] Appliances located in MF spaces (i.e., "other") must now be specified in more detail (i.e., "other heated space", "other non-freezing space", "other multifamily buffer space", or "other housing unit")
  • Enclosure
    • New optional inputs: Roof/RoofType, Wall/Siding, and RimJoist/Siding
    • New optional inputs: Skylight/InteriorShading/SummerShadingCoefficient and Skylight/InteriorShading/SummerShadingCoefficient
    • New optional inputs: Roof/RoofColor, Wall/Color, and RimJoist/Color can be provided instead of SolarAbsorptance
    • New optional input to specify presence of flue/chimney, which results in increased infiltration
    • Allows adobe wall type
    • Allows AirInfiltrationMeasurement/HousePressure to be any value (previously required to be 50 Pa)
    • [Breaking Change] Roof/RadiantBarrierGrade input now required when there is a radiant barrier
  • HVAC
    • Adds optional high-level HVAC autosizing controls
      • AllowIncreasedFixedCapacities: Describes how HVAC equipment with fixed capacities are handled. If true, the maximum of the user-specified fixed capacity and the heating/cooling design load will be used to reduce potential for unmet loads. Defaults to false.
      • UseMaxLoadForHeatPumps: Describes how autosized heat pumps are handled. If true, heat pumps are sized based on the maximum of heating and cooling design loads. If false, heat pumps are sized per ACCA Manual J/S based on cooling design loads with some oversizing allowances for heating design loads. Defaults to true.
    • Additional HVAC types: mini-split air conditioners and fixed (non-portable) space heaters
    • Adds optional inputs for ground-to-air heat pumps: extension/PumpPowerWattsPerTon and extension/FanPowerWattsPerCFM
  • Ventilation
    • Allows multiple whole-home ventilation, spot ventilation, and/or whole house fans
  • Appliances & Plug Loads
    • Allows multiple Refrigerator and Freezer
    • Allows Pool, HotTub, PlugLoad of type "electric vehicle charging" and "well pump", and FuelLoad of type "grill", "lighting", and "fireplace"
    • [Breaking Change] "other" and "TV other" plug loads now required
  • Lighting
    • Allows lighting schedules and holiday lighting
  • [Breaking Change] For hydronic distributions, HydronicDistributionType is now required
  • [Breaking Change] For DSE distributions, AnnualHeatingDistributionSystemEfficiency and AnnualCoolingDistributionSystemEfficiency are both always required
  • Allows more HPXML fuel types to be used for HVAC, water heating, appliances, etc.
  • New inputs to define Daylight Saving period; defaults to enabled
  • Adds more reporting of warnings/errors to run.log

Bugfixes

  • Fixes pump energy for boilers and ground source heat pumps
  • Fixes incorrect gallons of hot water use reported when there are multiple water heaters
  • No longer report unmet load for buildings where the HVAC system only meets part of the load (e.g., room AC serving 33% of the load)
  • Schedule bugfix for leap years
Assets 4