Skip to content

Releases: NREL/OpenStudio-ERI

OpenStudio-ERI v1.1.0

10 Feb 01:27
@shorowit shorowit
v1.1.0
fc744c6
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.
Compare
Choose a tag to compare
OpenStudio-ERI v1.1.0

OpenStudio-ERI version 1.1.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-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.1.0 uses OpenStudio v3.1.0, EnergyPlus v9.4.0, and a proposed HPXML v3.1.

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

New Features

  • Implements ANSI/RESNET/ICC Standard 301-2019 Addendum B. ERICalculation/Version can now be "2019AB" in the HPXML files.
    • Breaking change: New HVAC installation quality inputs required for air conditioners, heat pumps, and furnaces.
    • Adds modeling of dehumidifiers.
  • Adds modeling of generators (generic on-site power production).
  • Adds modeling of mini-split air conditioners.
  • Allows requesting hourly unmet heating/cooling loads.
  • Includes hot water loads (in addition to heating/cooling loads) when hourly total loads are requested.
  • Breaking change: Simplifies inputs for fan coils and water loop heat pumps by A) removing HydronicAndAirDistribution element and B) moving WLHP inputs from extension elements to HeatPump element.
  • Breaking change: One of the three duct leakage input types is now required for AirDistribution systems.
  • Breaking change: For ERI____Home.csv output files, the first two sections are now prefixed with "Fuel Use:" and "End Use:", respectively.
  • Adds HPXML default values (e.g., Reference Home autosized HVAC capacities) to the four ERI____Home.xml files.
  • Overhauls documentation to be more comprehensive and standardized.

Bugfixes

  • Improved modeling of window/skylight interior shading -- better reflects shading coefficient inputs.
  • Adds various error-checking to the schematron validator.
  • Adds error-checking for empty IDs in the HPXML file.
  • Fixes possible "Error: Electricity category end uses (X) do not sum to total (X)." for a heat pump water heater.
  • Fixes possible OpenStudio ForwardTranslator "surface construction conflicts" errors.
  • HVAC sizing improvements for floors above crawlspaces/basements and walls.
  • Fixes schematron file not being valid per ISO Schematron standard.
  • Fixes error when using energy_rating_index.rb --cache-weather.
Assets 4

OpenStudio-ERI v1.0.0

29 Oct 15:20
@shorowit shorowit
v1.0.0
2a0667a
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.
Compare
Choose a tag to compare
OpenStudio-ERI v1.0.0

OpenStudio-ERI 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-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.0.0 uses OpenStudio v3.1.0, EnergyPlus v9.4.0, and a proposed HPXML v3.1.

Please visit the OpenStudio-ERI v1.0.0 documentation for instructions on how to get started, how to connect software tools to the workflow, 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.
  • 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.
  • Accommodates common walls adjacent to unconditioned space by using HPXML surfaces where InteriorAdjacentTo == ExteriorAdjacentTo.
  • Additional validation checks and error-checking.
  • Various small updates to ASHRAE 140 test files.
  • Release packages now include RESNET HERS test files/results; all tests pass RESNET's proposed stringent acceptance criteria.

Bugfixes

  • EnergyPlus 9.4.0 fix for negative window solar absorptances at certain hours.
  • Fixes ceiling fan configuration in Reference/Rated Homes for 301-2019.
  • Fixes airflow timeseries outputs to be averaged instead of summed.
Assets 4

OpenStudio-ERI v0.11.0 Beta

22 Sep 14:52
@shorowit shorowit
v0.11.0-beta
dab9f63
Compare
Choose a tag to compare
OpenStudio-ERI v0.11.0 Beta Pre-release
Pre-release

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

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

New Features

  • New Schematron validation (301validator.xml) replaces custom ruby validation (301validator.rb)
  • 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 shared hot water recirculation systems
    • Shared appliances (e.g., clothes dryer in a shared laundry room)
    • Shared ventilation systems (optionally with preconditioning equipment and recirculation)
    • Shared PV systems
    • [Breaking Change] IsSharedSystem now required for boilers and ground-to-air heat pumps, water heating systems, ventilation systems, and PV systems
    • [Breaking Change] IsSharedAppliance now required for clothes washers, clothes dryers, and dishwashers
    • [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")
  • Allows multiple mechanical ventilation systems (VentilationFan)
  • [Breaking Change] For hydronic distributions, HydronicDistributionType is now required
  • [Breaking Change] For DSE distributions, AnnualHeatingDistributionSystemEfficiency and AnnualCoolingDistributionSystemEfficiency are both always required
  • [Breaking Change] Adds RadiantBarrierGrade as a required input if a roof has a radiant barrier
  • [Breaking Change] Adds extension/PumpPowerWattsPerTon as a required input for ground-to-air heat pumps
  • [Breaking Change] Renames DuctLeakageTestingExemption to DuctLeakageToOutsideTestingExemption, to clarify that it is different from the total duct leakage testing exemption in ANSI/RESNET/ACCA 310
  • [Breaking Change] New FanPowerDefaulted and FlowRateNotTested elements must be provided when ventilation systems have defaulted fan power or unmeasured airflow
  • Allows homes without a refrigerator, dishwasher, range/oven, clothes washer, and/or clothes dryer
  • Rated Home equipment capacities now automatically increased if smaller than auto-calculated design loads
  • Updates Reference Home to have a single water heater even when there are multiple water heaters
  • Updates Reference Home unconditioned basement insulation to be the basement ceiling instead of basement walls
  • Updates Reference Home conditioned basement insulation R-values per RESNET SCC clarifications
  • Various updates to RESNET test files
  • Updates ASHRAE 140 tests to use TMY3 instead of TMY weather
  • Adds more reporting of warnings/errors to run.log

Bugfixes

  • Fixes ERI calculation for some homes with multiple HVAC systems
  • 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)
  • ASHRAE 140 test files now have only heating or cooling systems, not both
Assets 4

OpenStudio-ERI v0.10.0 Beta

09 Jun 21:49
@shorowit shorowit
v0.10.0-beta
d265a59
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.
Compare
Choose a tag to compare
OpenStudio-ERI v0.10.0 Beta Pre-release
Pre-release

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

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

New Features

  • Implements ANSI/RESNET/ICC Standard 301-2019 and Addendum A. Shared systems are not yet supported.
    • ERICalculation/Version can be "2019A" or "2019"
    • [Breaking change] Attic/WithinInfiltrationVolume is required for unvented attics
    • [Breaking change] Foundation/WithinInfiltrationVolume is required for unvented crawlspaces and unconditioned basements
    • ExteriorAdjacentTo can be "other heated space", "other multifamily buffer space", or "other non-freezing space" for Wall, RimJoist, FoundationWall, and FrameFloor elements
    • DuctLocation can be "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space"
    • WaterHeater/Location can be "other housing unit", "other heated space", "other multifamily buffer space", or "other non-freezing space"
    • [Breaking Change] Location is now a required element for dishwashers and cooking ranges.
    • Location can be "other" for all appliances
    • [Breaking change] Window/FractionOperable is required
    • VentilationFan/TestedFlowRate is now optional and can be excluded for unmeasured mechanical ventilation flow rates
    • VentilationFan/FanPower is now optional and can be excluded for unknown mechanical ventilation fan power
    • [Breaking change] LabelUsage is required for clothes washers
    • [Breaking change] LabelElectricRate, LabelGasRate, LabelAnnualGasCost, and LabelUsage are required for dishwashers
    • [Breaking Change] HVACDistribution/ConditionedFloorAreaServed is now required for air distribution systems
    • [Breaking Change] For FrameFloors ExteriorAdjacentTo, "other housing unit above" and "other housing unit below" are replaced with "other housing unit"; floors adjacent to any "other ..." MF space type must have the extension/OtherSpaceAboveOrBelow element set to "above" or "below".
  • [Breaking Change] Lighting inputs now use LightingType[LightEmittingDiode | CompactFluorescent | FluorescentTube] instead of ThirdPartyCertification="ERI Tier I" or ThirdPartyCertification="ERI Tier II".
  • Allows "exterior wall", "under slab", and "roof deck" for DuctLocation.
  • Allows PortableHeater, Fireplace, and FloorFurnace for heating system types.
  • Allows "wood" and "wood pellets" as fuel types for HVAC systems, water heaters, and appliances.
  • Allows additional hourly outputs: airflows (e.g., infiltration, mechanical ventilation, natural ventilation, whole house fan) and weather (e.g., temperatures, wind speed, solar).
  • Improved inferred infiltration height calculation for homes w/ conditioned basements.
  • Reference Home mechanical ventilation that supplements infiltration is now always a balanced system.
  • Additional runtime improvements.
  • [Breaking Change] Many changes to HPXML test files to conform to latest RESNET Publication 002.
  • ERI____Home.xml files:
    • [Breaking Change] WaterHeatingSystem/PerformanceAdjustment is now a multiplier (e.g., 0.92) instead of a derate (e.g., 0.08).
    • Adds AirInfiltrationMeasurement/extension/InfiltrationHeight and AirInfiltrationMeasurement/extension/Aext as diagnostic outputs.
  • Error-checking:
    • Adds more space type-specific error checking of adjacent surfaces.
    • Adds additional HPXML datatype checks.
    • Adds a warning if a HVACDistribution system has ducts entirely within conditioned space and non-zero leakage to the outside.
    • Adds warnings if appliance inputs may be inappropriate and result in negative energy or hot water use.

Bugfixes

  • Reference Homes w/ ACs & furnaces now use the same W/cfm (derived from EAE) for both heating and cooling.
  • Fixes error if a home has both a dual-fuel heat pump and an air-source heat pump.
  • Fixes exterior air film and wind exposure of frame floors over ambient conditions.
  • Fixes air films for ceiling surfaces.
  • Preserve Rated Home appliance locations in the Reference Home.
  • Fixes heat pump defrost control to be Timed instead of OnDemand.
  • Fixes error if there's a FoundationWall whose height is less than 0.5 ft.
  • Fixes vented attic ventilation rate.
  • Reported unmet heating/cooling load now correctly excludes latent energy.
  • Ground-source heat pump backup fuel is now correctly honored instead of always using electricity.
Assets 4

OpenStudio-ERI v0.9.0 Beta

28 Apr 15:21
@shorowit shorowit
v0.9.0-beta
a1434a2
Compare
Choose a tag to compare
OpenStudio-ERI v0.9.0 Beta Pre-release
Pre-release

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

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

New Features

  • [Breaking Change] Updates to OpenStudio v3.0.0 and EnergyPlus 9.3.
  • [Breaking Change] Allows 301-2014 Addenda D & L to be used by providing inputs for A) duct leakage testing exemptions or B) total duct leakage in lieu of leakage to the outside. These inputs should only be used if the conditions specified in ANSI/RESNET/ICC© 301 have been appropriately met. Enumerations for SoftwareInfo/extension/ERICalculation/Version are now "latest", "2014ADEGL", "2014ADEG", "2014ADE", "2014AD", "2014A", "2014".
  • [Breaking Change] BuildingConstruction/ResidentialFacilityType is now required. Valid choices are: "single-family detached", "single-family attached", "apartment unit", "manufactured home".
  • Improves inferred infiltration height for conditioned basements (including walkout basements).
  • A new HPXML input WeatherStation/extension/EPWFilePath can be used instead of WeatherStation/WMO to point directly to the EPW file of interest.
  • Adds hot water outputs (gallons), disaggregated by end use, to annual output. Also available for timeseries outputs.
  • Improved desuperheater model; can now be connected to heat pump water heaters.
  • Solar thermal systems modeled with SolarFraction can now be connected to combi water heating systems.
  • Small improvement to calculation of component loads.
  • Allows buildings to have HVAC systems that do not condition 100% of the load (i.e., where sum of fraction heat/cool load served is greater than zero and less than one).
  • Populates more information in the ERI___Home.xml files (e.g., plug load kWh/yr).
  • [Breaking Change] The --no-ssl argument has been deprecated.
  • [Breaking Change] Switches from BuildingConstruction/extension/FractionofOperableWindowArea to Window/FractionOperable in HPXML test files.

Bugfixes

  • Fixes an unsuccessful simulation for buildings with multiple HVAC air distribution systems, each with multiple duct locations.
  • Fixes an unsuccessful simulation for buildings where the sum of multiple HVAC systems' fraction load served was slightly above 1 due to rounding.
  • Small fix for interior partition wall thermal mass model.
Assets 4

OpenStudio-ERI v0.8.0 Beta

10 Mar 14:45
@shorowit shorowit
v0.8.0-beta
45c6413
Compare
Choose a tag to compare
OpenStudio-ERI v0.8.0 Beta Pre-release
Pre-release

OpenStudio-ERI version 0.8.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-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.8.0 Beta uses OpenStudio v2.9.1, EnergyPlus v9.2.0, and a proposed HPXML v3.1.

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

Breaking Changes

  • The --skip-validation or -s argument has been removed, it's no longer needed now that the primary runtime bottleneck has been addressed.
  • ERI____Home.csv output files:
    • Disaggregates "Electricity: Heating Fans/Pumps" from "Electricity: Heating", "Electricity: Cooling Fans/Pumps" from "Electricity: Cooling", and "Electricity: Television" from "Electricity: Plug Loads"
    • Renames "Annual Load" to "Load" and "Annual Unmet Load" to "Unmet Load"
  • Requesting hourly output is now done via an --hourly TYPE (e.g., --hourly fuels --hourly temperatures) argument instead of --hourly-output. See documentation for more details.
  • Weather cache files are now in .csv instead of .cache format. Re-run --cache-weather if using custom weather files.
  • extension/StandbyLoss changed to StandbyLoss for indirect water heaters.
  • Site/extension/DisableNaturalVentilation changed to BuildingConstruction/extension/FractionofOperableWindowArea for ASHRAE 140-based test files.

New Features

  • Allows modeling of whole-house fans.
  • Adds optional CompressorType input for ACs/ASHPs.
  • Improved natural ventilation algorithm that reduces the potential for incurring additional heating energy.
  • Improved calculation of component heating/cooling loads.
  • Hot water temperatures are now included in the ERI____Home.xml files.
  • Runtime performance improvements, particularly for Windows.
  • Additional hourly outputs can be requested: energy by end use, total heating/cooling loads, and component heating/cooling loads.
  • ERI version in the HPXML file can now be entered as "latest".
  • Additional HPXML error-checking.

Bugfixes

  • Fix for central fan integrated supply (CFIS) fan energy.
  • Fix simulation error when FractionHeatLoadServed (or FractionCoolLoadServed) sums to slightly greater than 1.
  • Fix for running simulations on a different drive (either local or remote network).
  • Fix for HVAC sizing error when latitude is exactly 64 (Big Delta, Alaska).
  • Fix for DSE not being incorporated in the heating/cooling in ERI____Home_Hourly.csv output files.
  • Fix potential simulation error for buildings with foundation walls.
  • Fix radiation heat transfer when conditioned basement walls have a window/door.
  • Fixes weather download location.
  • Fixes Rated Home infiltration rate for homes with below-grade stories and using natural ACH.
Assets 4

OpenStudio-ERI v0.7.0 Beta

27 Dec 22:12
@shorowit shorowit
v0.7.0-beta
0b00952
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.
Compare
Choose a tag to compare
OpenStudio-ERI v0.7.0 Beta Pre-release
Pre-release

OpenStudio-ERI version 0.7.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.7.0 Beta uses OpenStudio v2.9.1, EnergyPlus v9.2.0, and a proposed HPXML v3.0.

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

Breaking Changes

  • OpenStudio version 2.9.1 is now required.
  • The --hourly-output argument now only generates hourly output for the Reference/Rated Homes, not the IAD Homes, for faster runtime.
  • Foundation walls described with the Insulation/Layer approach now require two layers (i.e., interior and exterior). (Foundation walls described using the Insulation/AssemblyEffectiveRValue approach are unchanged.) See here for more information.

New Features

  • Runtime performance improvements for all buildings.
  • Adds dual fuel heat pump model with a switchover temperature input.
  • Adds solar hot water models. Inputs are either a system-level solar fraction or detailed collector inputs for flat-plate, evacuated tube, and ICS systems.
  • Allows input for indirect water heater (combi boiler) standby losses.
  • Allows separate interior vs exterior foundation wall insulation elements.
  • Allows foundation wall insulation that doesn't start at the top of the wall.

Bugfixes

  • Fixes Reference Home HVAC sizing when the house has a conditioned basement.
  • Fixes basement slab insulation being ignored.
  • Fixes possible issue with ground-source heat pump ground loop sizing.
  • Fixes return duct losses and duct component load reporting.
  • Fixes desuperheater model bugs.
  • Fixes/updates to Proposed HERS Method Test HPXML files
  • Errors are now generated for duplicate SystemIdentifier IDs, as they are supposed to be unique per the HPXML schema and can result in unpredictable behavior.

Known Issues

  • None
Assets 2

OpenStudio-ERI v0.6.0 Beta

27 Nov 05:50
@shorowit shorowit
v0.6.0-beta
4a1a570
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.
Compare
Choose a tag to compare
OpenStudio-ERI v0.6.0 Beta Pre-release
Pre-release

OpenStudio-ERI version 0.6.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.6.0 Beta uses OpenStudio v2.9.0, EnergyPlus v9.2.0, and a proposed HPXML v3.0.

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

Breaking Changes

  • A Foundations/Foundation[FoundationType/Basement[Conditioned='false']]/ThermalBoundary element is now required for all buildings with unconditioned basements.
  • Several reporting changes for results/ERI____Home.csv output files:
    • "Other Fuel" is now disaggregated into "Fuel Oil" and "Propane"
    • Peak load units are changed from W to kBtu

New Features

  • Adds ability to specify evaporative coolers
  • Adds heating/cooling component loads reporting to results/ERI____Home.csv output files. See the Outputs documentation for more information.
  • When an AirDistribution is specified, only supply duct leakage is now required. Return duct leakage, supply ducts, and return ducts are now optional.

Bugfixes

  • Improves combi boiler model to achieve better control/accuracy.
  • Changes the recovery efficiency (RE) of the Reference Home water heater for consistency with other software tools.
  • Changes the thermal boundary location for unconditioned basements in the Reference Home configuration for consistency with other software tools.
  • Fixes bug where presence of a radiant barrier was not being reflected in the model.
  • Fixes Reference Home configuration for thermal boundary vs. exterior thermal boundary surfaces.
  • Fixes bug where a couple FoundationWall elements were not being properly validated.
  • Improves handling of uninsulated foundation walls defined by assembly R-value.

Known Issues

  • Desuperheater savings is not correct. The issue is being investigated.
  • Return duct losses may not be correct. Heating/cooling loads do not include return duct loads. These issues are being investigated.
Assets 2

OpenStudio-ERI v0.5.0 Beta

06 Nov 16:41
@shorowit shorowit
v0.5.0-beta
ba59b0e
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.
Compare
Choose a tag to compare
OpenStudio-ERI v0.5.0 Beta Pre-release
Pre-release

OpenStudio-ERI version 0.5.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.5.0 Beta uses OpenStudio v2.9.0, EnergyPlus v9.2.0, and a proposed HPXML v3.0.

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

Breaking Changes

  • None

New Features

  • Adds thermostat information (setpoints, setbacks/setups, ceiling fan offset) to all the configured homes' HPXMLs.
  • Runtime improvements for homes with heat pump water heaters.
  • Runtime improvements for homes with slabs/crawlspaces/basements.
  • Reduces number of simulations for Reference/IAD Auto-Generation tests.
  • Simulations are now immediately aborted when an error occurs.

Bugfixes

  • Fixes significant runtime regression for more complex homes.
  • Fixes possibility of IAD Home skylight area exceeding roof area.
  • Fixes Reference Home R-values for non-thermal boundary surfaces.
  • Fixes entered setpoints being used in the Rated Home.
  • Fixes infiltration credit erroneously being applied to SFA/MF mechanical ventilation rates.
  • Fixes cooling system's Sensible Heat Ratio not being preserved in the Reference Home.
  • Fixes attic/crawlspace ventilation rates appearing in the Reference Home HPXML even when there's no vented attic/crawlspace.
  • Fixes zero mechanical ventilation energy when CFIS systems are set to run exactly 24 hrs/day.
  • Fixes ceiling fans running year-round instead of only during certain months.
  • Fixes Reference Home mechanical ventilation when infiltration is entered as CFM50.
  • Increases precision of some outputs (that were previously rounded to 0.01 GJ).

Known Issues

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

OpenStudio-ERI v0.4.0 Beta

25 Oct 17:11
@shorowit shorowit
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.
Compare
Choose a tag to compare
OpenStudio-ERI v0.4.0 Beta Pre-release
Pre-release

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