Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

Recent Releases of OpenStudio

OpenStudio - v3.8.0

What's Changed

Full Changelog: https://github.com/NREL/OpenStudio/compare/v3.7.0...v3.8.0

Consumption - Buildings and Heating - C++
Published by wenyikuang 12 months ago

OpenStudio - v3.8.0-rc3

What's Changed

Full Changelog: https://github.com/NREL/OpenStudio/compare/v3.8.0-rc2...v3.8.0-rc3

Consumption - Buildings and Heating - C++
Published by wenyikuang 12 months ago

OpenStudio - v3.8.0-rc2

What's Changed

Full Changelog: https://github.com/NREL/OpenStudio/compare/v3.7.0...v3.8.0-rc2

Consumption - Buildings and Heating - C++
Published by wenyikuang 12 months ago

OpenStudio - v3.8.0-rc1

What's Changed

Full Changelog: https://github.com/NREL/OpenStudio/compare/v3.7.0...v3.8.0-rc1

Consumption - Buildings and Heating - C++
Published by wenyikuang 12 months ago

OpenStudio - v3.7.0

OpenStudio SDK:

The 3.7.0 is a major release. This update includes several new features, performance improvements, and bug fixes.

C++ Workflow code

As of OpenStudio SDK 3.7.0 a re-written workflow written in C++ is used by default in place of the Ruby based Workflow Gem that had been used in the past. This enhancement is in support of Python measures being used in an OpenStudio workflow, including mixed language workflows that include both Ruby Measures and Python Measures. If you need to use the older Workflow Gem implementation, you can do that by using the classic subcommand after openstudio. classic will be deprecated in a future version of OpenStudio.

Known Issues / Limitations

  • In some cases you may need to install an extra dependency needed by EnergyPlus on Linux and Mac. See this EnergyPlus issue for details https://github.com/NREL/EnergyPlus/issues/10284
  • While we udpated the gbXML schema to v7.03, the forward and reverse translation between gbXML and OSM does not support any new gbXML fields that may have been added.

New Features, Major Fixes and API-breaking changes

Minor changes and bug fixes

Full Changelog: https://github.com/NREL/OpenStudio/compare/v3.6.0...v3.7.0

New Contributors:

Consumption - Buildings and Heating - C++
Published by wenyikuang over 1 year ago

OpenStudio - v3.7.0-rc3

What's Changed

Full Changelog: https://github.com/NREL/OpenStudio/compare/v3.7.0-rc2...v3.7.0-rc3

Consumption - Buildings and Heating - C++
Published by wenyikuang over 1 year ago

OpenStudio - v3.7.0-rc2

What's Changed

Full Changelog: https://github.com/NREL/OpenStudio/compare/v3.7.0-rc1...v3.7.0-rc2

Consumption - Buildings and Heating - C++
Published by wenyikuang over 1 year ago

OpenStudio - OpenStudio v3.7.0-rc1

What's Changed

New Contributors

Full Changelog: https://github.com/NREL/OpenStudio/compare/v3.6.1...v3.7.0-rc1

Consumption - Buildings and Heating - C++
Published by wenyikuang over 1 year ago

OpenStudio - OpenStudio v3.6.1

What's Changed

Full Changelog: https://github.com/NREL/OpenStudio/compare/v3.6.0...v3.6.1

Consumption - Buildings and Heating - C++
Published by tijcolem almost 2 years ago

OpenStudio - OpenStudio v3.6.1-rc1

What's Changed

Full Changelog: https://github.com/NREL/OpenStudio/compare/v3.6.0...v3.6.1-rc1

Consumption - Buildings and Heating - C++
Published by tijcolem almost 2 years ago

OpenStudio - OpenStudio v3.6.0

OpenStudio Version 3.6.0

Release Notes - 05/09/2023

These release notes describe version 3.6.0 of the OpenStudio SDK developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Sciences Center, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Overview
  • Where to Find OpenStudio Documentation
  • Installation Notes
  • OpenStudio SDK: Changelog

Overview

As of April 2020, development and distribution of the OpenStudioApplication and the SketchUp plugin have transitioned to the OpenStudio Coalition, who is independently managing and distributing the software through its own openstudiocoalition/OpenStudioApplication repository. The OpenStudio SDK is continuing to be actively developed and distributed by NREL and is released two times per year, through a spring and a fall release.

Below is the list of components that is included in this SDK installer:

OpenStudio SDK 3.6.0

  • EnergyPlus
  • Command Line Interface (CLI)
  • Radiance
  • Ruby API
  • C++ SDK

Note that PAT is not included in either the SDK or the OpenStudio Coalition's Application installers. You will need to install PAT separately which is distributed on the OpenStudio-PAT GitHub page.

Where to Find OpenStudio SDK Documentation

Installation Notes

OpenStudio SDK 3.6.0 is supported on:

  • 64-bit Windows 7 – 11
  • macOS: 10.15+ x86_64, 12.1+ arm64
  • Ubuntu: 20.04 x86_64, 22.04 x86_64, 22.04 arm64
  • Centos7

OpenStudio SDK 3.6.0 supports EnergyPlus Release 23.1.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio SDK 3.6.0.

OpenStudio SDK 3.6.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer must install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio SDK 3.6.0.

As usual, you can refer to the OpenStudio SDK Compatibility Matrix for more information.

Installation Steps

  • Download and install OpenStudio SDK and/or openstudiocoalition/OpenStudioApplication depending on your needs. Select components for installation. Note that OpenStudio Application is a standalone app and does not require you to install OpenStudio SDK.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.
  • The OpenStudio Application SketchUp Plug-in requires SketchUp 2021-2022 (not available for Linux). The OpenStudio Application SketchUp Plug-in does not support older versions of SketchUp. SketchUp must be installed before OpenStudio Application to automatically activate the plugin. If you install SketchUp after OpenStudio Application, simply re-run the OpenStudio Application installer.

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/getting_started/getting_started/.

OpenStudio SDK: Changelog

The 3.6.0 is a major release. This update includes several new features, performance improvements, and bug fixes.
You can find the list of Pull Requests that got into this release here.

Python Bindings

As of OpenStudio SDK 3.2.0, Python bindings are officially supported and distributed through Python Package Index (PyPI). To install, users will need to have Python3 installed along with pip and simply run the following command in a terminal window.

pip install openstudio==3.6.0

Please see openstudio on PyPi for further instructions on how to install. Users can also visit the test channel at openstudio on TestPyPi to install development bindings.

You can also refer to the OpenStudio SDK Python Binding Version Compatibility Matrix to see the list of supported platforms and python versions.

New Features, Major Fixes and API-breaking changes

  • #4719,#4721 - Phase 2 support to run Python based measures. This functionality is still experimental and can only be accessed from the CLI using the experimental labs subcommand. Phase 2 now allows users to run both a Python and Ruby measure in the same workflow. To explore the various new options this new feature has to offer, you can access the help menu openstudio labs --help Also, to help jump start python measure development, included in the installation are example .osw workflow files that contain Python, Ruby and Python+Ruby based workflows that can be ran using the labs subcommand. For instance, the following will run a Ruby + Python based workflow: openstudio labs run -w ./Examples/compact_osw/compact_ruby_and_python.osw

  • #4778 - Wrap AirConditioner:VariableRefrigerantFlow:FluidTemperatureControl and AirConditioner:VariableRefrigerantFlow:FluidTemperatureControl:HR

    • ZoneHVAC:TerminalUnit:VariableRefrigerantFlow has API-breaking changes related to setters and getters for its heating and cooling coils. They now use HVACComponent instead of the more restrictive CoilHeatingDXVariableRefrigerantFlow and CoilCoolingDXVariableRefrigerantFlow.
    • AirConditionerVariableRefrigerantFlow::clone was changed to stop cloning the child Curve objects (20 of them)

  • #4740 - Fix issues around ScheduleFixedInterval

    • A minor API breaking change: intervalLength/setIntervalLength now return/accept an int rather than a double to conform to the IDD type \integer
    • Translated daily schedules start on correct day
    • Leap day is no longer ignored on translation
    • Interval no longer restricted to one day or less

  • #4813 - Wrap SolarCollectorPerformance:PhotovoltaicThermal:BIPVT

    • SolarCollectorFlatPlatePhotovoltaicThermal has API-breaking changes in the solarCollectorPerformance getter due to the addition of this new object: it used to return a SolarCollectorPerformancePhotovoltaicThermalSimple (the only performance object at the time), now it's a ModelObject.

  • #4717 Update GroundHeatExchangerHorizontalTrench: wrap Site:GroundTemperature:Undisturbed:XXX objects

    • Wrap Site:GroundTemperature:Undisturbed:KusudaAchenbach and Site:GroundTemperature:Undisturbed:Xing objects
    • Update GroundHeatExchanger:HorizontalTrench to actually use the Ground Temeprature Model field

  • #4532 Performance improvements

  • #4800,#4844 Update to v23.1.0 EnergyPlus

  • #4808 Wrap OutputControl:Timestamp

  • #4825 add Coil:UserDefined

  • #4806 Wrap Gas-Fired Absorption Heat Pump (GAHP)

    • Wrap HeatPump:AirToWater:FuelFired:Heating and HeatPump:AirToWater:FuelFired:Cooling objects
    • The objects define an equation-fit fuel-fired absorption heat pump, based on manufacture-provided performance curves and testing/modeling methods
    • The GAHP is a combined space heating and domestic hot water solution, especially for cold climates. It can serve as heat sources for plant loops of space heating coils, hydronic radiators, DHW water heaters, and low-temperature space heating floors or TABS systems. Driven by gas heat or other types of fuel heat, the equipment can consume very little electricity and can have a much higher overall COP than conventional fuel-combustion type boilers or water heaters.

  • #4799 Add Fuel-related Methods from OpenStudio-Standard

  • #4857 Schedule:File ctor with path

    • Introduce new ScheduleFile constructor with path instead of ExternalFile argument

  • Support Ubuntu 22.04 and remove 18.04

Minor changes and bug fixes

  • #4828 - Fix Space load-based actuator for spaces are named based on thermal zone name
    • As part of this PR, the optional field at the end Zone Name is replaced with Zone or Space and some API changes are there around it. The only minor breaking one is that boost::optional<ModelObject> zoneName() (deprecated) will now return either a Zone or a Space. Before if you called setSpace it would store the space's ThermalZone, now it stores the Space itself. This is unlikely to affect most users.
  • #4769 fix(CSharp): fix buildCSharp CI
  • #4774 Fix #4773 - Remove double % sign in Zone Thermal Comfort ASHRAE 55 Adaptive Model 80% Acceptability Status
  • #4780 Fixup the python bindings during release
  • #4739 Fix #4738 - Workflow: Unify RunOptions/ForwardTranslator Options accross entire code base
  • #4785 Allow forcing conan package build_type via CONAN_CONFIGURATION_TYPES when using non-multi generators
  • #4787 VRF model object lists
  • #4770 Height of shading objects is incorrect
  • #4725 Fuel query updates
  • #4790 Fixes 4783: Triangulation issue in openstudio::subtract
  • #4782 Fix for containingHVACComponent
  • #4810 Fixes CLI --help typo.
  • #4777 4766 different surface counts
  • #4814 GenerateClass update: Rule of 5 for public hpp, const-correctness, automatic clang-format + automatic FT/RT tests
  • #4816 Fix #4815 - Adjust ForwardTranslatorOptions::string() for backward compat with openstudio-workflow-gem
  • #4828 Fix #4786 - Space load-based actuator for spaces are named based on thermal zone name
  • #4805 adding fix and test for oas removal when doas is removed
  • #4819 Properly forward arguments for execute_ruby_script / execute_python_script and allowing omitting the command
  • #4796 autosized methods
  • #4829 Fix some failing tests
  • #4833 Update gems
  • #4835 Fix #4834 - CLI chops inner single quote inside argument since 3.5.1
  • #4836 Fix VersionTranslator use after move (in develop only)
  • #4839 Conan need to be updated to supported for fmt/9.1.0 and cli11/2.3.2
  • #4845 Minor fix to a template sortByObjectName
  • #4848 Fix #4831 - Platform dependent results for joinAll
  • #4849 Update standards to 0.3.1-rc2 and tbd gem to 3.2.2
  • #4851 Recent clang throws on these functions. codecvt_utf8_utf16 is deprecated
  • #4854 Fix #4853 - RemoteBCLTest2
  • #4850 Update standards jsons for SpaceType/Materials suggested Standards information
  • #4855 Update copyrights to 2023
  • #4860 Update cppcheck.yml to use --std=c++20
  • #4859 Fix #4856 - escape path with backward slash in Labs
  • #4862 Fix github action build for python and csharp bindings
  • #4852 Fix #4847 - OpenStudio logging behaves differently on Windows/Linux
  • #4871 update gems and set addressable gem to use v2.8.1
  • #4777 Fix #4766 different surface counts

Full Changelog: https://github.com/NREL/OpenStudio/compare/v3.5.1...v3.6.0

New Contributors:
@wenyikuang

OpenStudio Standards v0.4.0

  • #1475 # Fix issue #109 check hard-sized values before autosized values
  • #1474 # Fix issue #238 space_type_apply_internal_loads to return boolean instead of nil when no infiltration data available
  • #1473 # Add more descriptive warning messages for missing standards space type, to help with issue #516
  • #1470 # Fix issue #1466 by adding a version reference for initialization summary lookup
  • #1447 # Fix issues #1446 and #1395 breaking out lighting controls into individual spaces
  • #1437 # Fix issue #754 add support for HeatExchangerFluidToFluid objects for heating and cooling fuels
  • #1436 # Fix issue #230 improve PRM baseline boiler naming
  • #1435 # Fix issue #1423 typo in find_and_set_insulation_layer method
  • #1428 # Appendix G PRM bug fixes, including unmet hour load loop, error handling, and schedule type checking with EMS
  • #1422 # Fix issue #1417 add default chiller efficiency
  • #1421 # Fix issue #1326 add model argument to create_cubic_curve and create_curve_exponent
  • #1418 # Fix issue #1228 OS_AirLoopHVAC_UnitarySystem typo in heating and cooling fuels system lookup
  • #1414 # Update DEER ventilation rate assumptions
  • #1410 # Remove obsolete OpenStudio model object autosizing and hardsizing methods

OpenStudio Server 3.6.0

  • #686 Using bundled ruby gems with analysis runs
  • #687 add ModelMeasure to schema
  • #690 Short name
  • #694 Update actions

Issue Statistics Since Previous Release

71 Closed Issues
62 New Issues

Consumption - Buildings and Heating - C++
Published by tijcolem almost 2 years ago

OpenStudio - OpenStudio v3.5.1

What's Changed

Consumption - Buildings and Heating - C++
Published by tijcolem over 2 years ago

OpenStudio - OpenStudio v3.5.0

OpenStudio Version 3.5.0

Release Notes - 11/10/2022

These release notes describe version 3.5.0 of the OpenStudio SDK developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Sciences Center, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Overview
  • Where to Find OpenStudio Documentation
  • Installation Notes
  • OpenStudio SDK: Changelog

Overview

As of April 2020, development and distribution of the OpenStudioApplication and the SketchUp plugin have transitioned to the OpenStudio Coalition, who is independently managing and distributing the software through its own openstudiocoalition/OpenStudioApplication repository. The OpenStudio SDK is continuing to be actively developed and distributed by NREL and is released two times per year, through a spring and a fall release.

Below is the list of components that is included in this SDK installer:

OpenStudio SDK 3.5.0

  • EnergyPlus
  • Command Line Interface (CLI)
  • Radiance
  • Ruby API
  • C++ SDK

Note that PAT is not included in either the SDK or the OpenStudio Coalition's Application installers. You will need to install PAT separately which is distributed on the OpenStudio-PAT GitHub page.

Where to Find OpenStudio SDK Documentation

Installation Notes

OpenStudio SDK 3.5.0 is supported on 64-bit Windows 7 – 11, OS X 10.15, Ubuntu 18.04, 20.04 and Centos7

OpenStudio SDK 3.5.0 supports EnergyPlus Release 22.1.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio SDK 3.5.0.

OpenStudio SDK 3.5.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer must install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio SDK 3.5.0.

As usual, you can refer to the OpenStudio SDK Compatibility Matrix for more information.

Installation Steps

  • Download and install OpenStudio SDK and/or openstudiocoalition/OpenStudioApplication depending on your needs. Select components for installation. Note that OpenStudio Application is a standalone app and does not require you to install OpenStudio SDK.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.
  • The OpenStudio Application SketchUp Plug-in requires SketchUp 2021-2022 (not available for Linux). The OpenStudio Application SketchUp Plug-in does not support older versions of SketchUp. SketchUp must be installed before OpenStudio Application to automatically activate the plugin. If you install SketchUp after OpenStudio Application, simply re-run the OpenStudio Application installer.

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/getting_started/getting_started/.

OpenStudio SDK: Changelog

The 3.5.0 is a major release. This update includes several new features, performance improvements, and bug fixes.
You can find the list of Pull Requests that got into this release here.

Python Bindings

As of OpenStudio SDK 3.2.0, Python bindings are officially supported and distributed through Python Package Index (PyPI). To install, users will need to have Python3 installed along with pip and simply run the following command in a terminal window.

pip install openstudio==3.5.0

Please see openstudio on PyPi for further instructions on how to install. Users can also visit the test channel at openstudio on TestPyPi to install development bindings.

You can also refer to the OpenStudio SDK Python Binding Version Compatibility Matrix to see the list of supported platforms and python versions.

New Features, Major Fixes and API-breaking changes

  • #4689,#4702,#4694,#4674,#4641,#4688,#4653 - Phase 1 support to run Python based measures.
    • Currently, this functionality is experimental and can only be accessed from the CLI using the experimental labs subcommand. This also includes a redesigned help menu (openstudio labs --help) to explore the various new options this new feature has to offer.
    • Included in the installation are example .osw workflow files that contain Python based measures that can be ran using the labs subcommand. For instance, the following will run a python based workflow: openstudio run -w ./Examples/compact_osw/compact_python_only.osw
    • For this release, only Python or Ruby can be ran in a single workflow file. Running both Python and Ruby support is planned for the next phase 2 installment in v3.6.0
  • #4600 - Phase 1 support to run Python EMS plugin using OpenStudio.
  • #4623 - FloorspaceJS to OpenStudio direct reverse translator vs the 3-way process of converting FloorspaceJS to ThreeJS to OSM.
  • #4571 - Metadata mapped to GLTF data object at export. Allows users to view metadata in a glTF capable browser.
  • #4587 - Error handling and gbXML schema validation when running gbXML based workflows.
  • #4616 - Addresses #4611, allow non-Quadratic curves for the EIR-f-PLR for the Chiller:Electric:EIR object
    • Chiller:Electric:EIR has a few API-breaking changes related to its Curves. The types for the constructor, getters and setters used to be explicit (eg: CurveBiquadratic): it is now the base class, more generic, Curve type for added flexibility.
  • #4642 - Addresses #4575, API change for EvaporativeCoolerFluid:SingleSpeed
    • EvaporativeCoolerFluid:SingleSpeed has an API-breaking change related to its performanceInputMethod getter. It is now a required field that returns std::string instead of boost::optional<std::string>.
  • #4644 - Addresses #4575, API change for Coil:Cooling:DX:SingleSpeed and Coil:Cooling:DX:TwoSpeed
    • Coil:Cooling:DX:SingleSpeed and Coil:Cooling:DX:TwoSpeed have API-breaking changes related to many of their getters. They are now required fields that return double instead of boost::optional<double>. Also removes many deprecated methods.
  • #4632 - Remove deprecated methods for AirWallMaterial, Node, SizingSystem, ZoneAirMassFlowConservation
    • Removes the deprecated AirWallMaterial class completely, in favor of ConstructionAirBoundary
    • Removes functions in Node that have been deprecated for 9+ years
    • Removes deprecated methods in the SizingSystem, ZoneAirMassFlowConservation, PlantLoop & AirLoopHVAC, AvailablilityManagerNightCycle, ZoneVentilationDesignFlowRate classes
    • Refer to the CSV file at developer/ruby/deprecated_methods.csv for more information
  • #4665 - Deprecate methods on Coil DX objects
    • Coil:Cooling:DX:SingleSpeed, Coil:Cooling:DX:MultiSpeed:StageData, and Coil:Cooling:DX:CurveFit:Speed: ratedEvaporatorFanPowerPerVolumeFlowRate and setRatedEvaporatorFanPowerPerVolumeFlowRate in favor of ratedEvaporatorFanPowerPerVolumeFlowRate2017 and setRatedEvaporatorFanPowerPerVolumeFlowRate2017
    • Coil:Heating:DX:SingleSpeed and Coil:Heating:DX:MultiSpeed:StageData: ratedSupplyFanPowerPerVolumeFlowRate and setRatedSupplyFanPowerPerVolumeFlowRate in favor of ratedSupplyFanPowerPerVolumeFlowRate2017 and setRatedSupplyFanPowerPerVolumeFlowRate2017
  • #4666 - Changes related to availability schedule methods
    • Coil:Heating:Gas:MultiStage has an API-breaking change related to its availabilitySchedule getter. It is now a required field that returns Schedule instead of boost::optional<Schedule>. Method resetAvailabilitySchedule is also removed.
  • #4701 - ZoneHVACPackagedTerminalAirConditioner and ZoneHVACPackagedTerminalHeatPump
    • ZoneHVACPackagedTerminalAirConditioner and ZoneHVACPackagedTerminalHeatPump have an API-breaking change related to its supplyAirFanOperatingModeSchedule getter. It is now a required field that returns Schedule instead of boost::optional<Schedule>. Method resetSupplyAirFanOperatingModeSchedule is also removed.
      • It is set to alwaysOnDiscreteSchedule (=Constant) in the Constructor if you provide a FanConstantVolume (This is required by E+)
      • It is set to alwaysOffDiscreteSchedule (=Cycling) in the Constructor if you provide any other fan types (E+ treats a blank schedule as always off)
    • There are unusual VersionTranslator Rules for Packaged Systems (PTAC or PTHP) that use a FanConstantVolume and that do not have a Supply Air Fan Operating Mode Schedule. In 22.1.0 this would effectively, and mistakenly, function as a cycling fan, but this is now disallowed in E+ 22.2.0. In order to retain a similar functionality and energy usage, the FanConstantVolume will be replaced by a FanSystemModel with an Always Off Schedule (=cycling fan, similar to a Fan:OnOff), mapping inputs such as pressure rise and efficiency appropriately.
  • #4484 - Enable C++20
  • #4671 - New Coil:*:WaterToAirHeatPump:EquationFit fields
  • #4698 - Update EnergyPlus to v22.2.0
  • #4685 - Address #4630, wrap Output:Schedules and Output:Constructions objects
  • #4577 - gbXML translation fixes and enhancements
  • #4610 - Addresses #4538, wrap phase change material properties
  • #4625 - Addresses #4615, wrap OutputControl:Table:Style and Output:SQLite

Minor changes and bug fixes

  • #4580 - Add color for Foundation boundary condition
  • #4568 - Installer adjustments for clang 13.1.6+, and some mac arm64 adjustments
  • #4585 - Add libintl.8.dylib to mac15 x86 for e+
  • #4589 - Switch to E+ Space FT by default
  • #4579 - Add Volume field to Space
  • #4593 - Fix ZoneInfiltration:DesignFlowRate FT when Space FT enabled
  • #4597 - Hotfix GLTF extras broke running tests in Debug
  • #4594 - Bump OS ruby to use fPIC and zlib/minizip to 1.2.12 to match
  • #4590 - Correct typo: Newell, not Newall
  • #4316 - Addresses #2610, insertComponent can create duplicate unique model objects
  • #4604 - Cached getters for all unique model objects
  • #4605 - Gltf Refactor
  • #4612 - Fix build error due to GLTF refactor on Windows
  • #4596 - Bump conan dependencies (which will allow MSVC 2022 and C++20) and clang 13.1+ fixes
  • #4614 - Support Ubuntu 18.04 and Centos7
  • #4619 - Fix #4543 - E+ 22.1.0: Wrap SetpointManager:SystemNodeReset:Temperature and SetpointManager:SystemNodeReset:Humidity
  • #4622 - Addresses #4620, harmonize (remove?) max. material thickness limit
  • #4627 - Fix #4547 - FT always warns about missing Design Specification Outdoor Air for AirTerminalSingleDuctInletSideMixer
  • #4640 - Fix python bindings github workflows with C++20
  • #4626 - Fix #4601 - add some useful log messages when requested WWR is rejected
  • #4592 - Fix#127 - Fix volume calculation to match EnergyPlus
  • #4621 - Fox #4551 - Add minimum/maximum values to numeric OSArguments and use it in validateUserArgument
  • #4643 - Update docs for setThermalConductance and setThermalResistance changing thickness
  • #4650 - Enable centos7 for c++20
  • #4629 - Addresses #3666, CoilWaterHeaterDesuperheater: Issue Error in ForwardTranslator if Heat Reclaim Efficiency is out of bounds
  • #3912 - Add consistently failing test for warnings/errors and document
  • #4669 - Fix #4668 - Wrap E+ 22.2 new People fields
  • #4287 - Build and test CSharp bindings for Linux/Mac/Windows
  • #4652 - Addresses #4647, wrap the E+ Table:Lookup, Table:IndependentVariableList, and Table:IndependentVariable objects
  • #4679 - Remove cruft
  • #4672 - Fix #4645 - Update FT for space-level infiltration/ventilation objects (E+ 22.2.0-IOFreeze)
  • #4676 - Fix #4648 #4654 - SurfaceProperty:GroundSurfaces and SurfaceProperty:IncidentSolarMultiplier
  • #4681 - Fix glass U factor sql error
  • #4661 - Volume, CeilingHeight, FloorArea for Space object
  • #4660 - Fix #4120 - set boost's visibility to global/default instead of hidden
  • #4680 - Update ruby gems including the new tbd gem
  • #4686 - Addresses #4599, documentation for isGroundSurface() is missing an outside boundary condition
  • #4677 - Fix #4675 - E+ 22.2.0 - Sizing:Zone has new fields
  • #4691 - Followup to #4575
  • #4662 - Support CoilCoolingDX on ZoneHVAC, CoilSystem, Desuperheater
  • #4694 - Fix #4638 python ruby workflow
  • #4687 - Fix #4656 - E+ 22.2.0: Wrap Chiller:Electric:ASHRAE205
  • #4697 - Volume, CeilingHeight, FloorArea for Space object
  • #4658 - Update to v22.2.0
  • #4683 - Fix #4663 #4664 - Fix CoilCoolingDXMultiSpeed::clone and extend testing for AirLoopHVAC::clone
  • #4702 - Mod to Python Engine
  • #4700 - Fix #4673 - Allow setting ZoneMixing objects at Space level
  • #4710 - Update gems for standard 0.2.17.rc1
  • #4712 - Fix #4659 - Filesystem fixups

Deprecated methods removed:

  • #4713 - Deprecated methods that date back to as early as v2.5.0 have been removed from this release. Moving forward, it is our goal to support deprecated methods for three release cycles and then remove them. If you run into errors (e.g. undefined method), please reference this list for the suggested replacement.

Developer changes:

Full Changelog: https://github.com/NREL/OpenStudio/compare/v3.4.0...v3.5.0

New Contributors:

OpenStudio Standards v0.3.0

Bug fixes include:

  • #1310 - Fix issue #1309 Lookup template for model_find_target_eui from model
  • #1316 - Add missing small hotel lighting schedules in ComStock data
  • #1320 - Adjust lighting values and schedules in ComStock data
  • #1342 - Add missing schedules for elevators in ComStock data
  • #1346 - Fix issue #1345 Air-cooled chiller efficiency lookup returning multiple results because there is no default for condenser type
  • #1379 - NRCan changes
  • #1383 - Catch exceptions for some OS prototypes
  • #1384 - Include global scorecard for openstudio-standards prototypes
  • #1393 - Fix issues generated from E+ and OS API changes in OS 3.5.0-alpha
  • #1394 - Fix issue #1372 to use VRP enumeratiosn for newer E+ versions and make Evz template-dependent
  • #1396 - Fix issue #1338 corect heating setpoint schedule method for low temperature radiant electric objects
  • #1397 - Fix issue #1343 check that wall area is non-zero for wwr calculation and error gracefully
  • #1399 - Fix issue #1254 create temperature schedule limits object for heat pup water heater when no thermal zone specified
  • #1400 - Fix issue #1339 give a path length warning when loading weather files
  • #1401 - Fix issue #1151 missing laboratory exterior lighting and entryway data
  • #1402 - Fix issue #1352 correct UA units in info messages
  • #1403 - Fix issue #1382 small data centers failing on cold climates (CZ6-8)

PNNL extended and expanded the Create Baseline Building measure to include the 2019 version of ASHRAE 90.1 Appendix G and generate a more complete baseline model. This was a significant effort thanks to contributions from Doug Maddox, Jeremy Lerond, Weili Xu, Jian Zhang, Yunyang Ye, Xuechen (Jerry) Lei, and Juan Gonzalez Matamoros.

Appendix G PRM release notes:

Pull Request | Description

  • #809 - Update WWR adjustment for Appendix G stable baseline
  • #823 - Constructions for Appendix G stable baseline
  • #837 - Lighting power for Appendix G stable baseline
  • #863 - Lighting occupancy sensor for Appendix G stable baseline
  • #921 - Infiltration calculations for Appendix G stable baseline
  • #923 - Baseline system mapping and assignment for Appendix G stable baseline
  • #949 - WWR determination based on actual space conditioning type
  • #967 - Add system 11 and related SAT controls
  • #1003 - HVAC sizing for Appendix G stable baseline
  • #1086 - Set number of chillers and number of boilers for Appendix G stable baseline
  • #1230 - CHW and HW supply temperature reset for Appendix G stable baseline
  • #1238 - Add preheat coil for Appendix G stable baseline
  • #1266 - Handle multiple building area types for Appendix G stable baseline
  • #1297 - Update minimum flow setpoints for VAV terminals for Appendix G stable baseline
  • #1300 - Update parallel PIU fan control for Appendix G stable baseline
  • #1301 - Check vav part load curve for Appendix G stable baseline
  • #1308 - Economizer exception for Appendix G stable baseline
  • #1312 - Set lighting space types from user data for Appendix G stable baseline
  • #1314 - Remove piping losses from Appendix G stable baseline
  • #1315 - Fan power adjustments for Appendix G stable baseline
  • #1319 - Set plug load from user data for Appendix G stable baseline
  • #1322 - Building rotation requirements for Appendix G stable baseline
  • #1325 - F/C-factor requirements and unenclosed/unconditioned spaces for Appendix G stable baseline
  • #1327 - Update minimum HVAC efficiency requirements for Appendix G stable baseline
  • #1331 - Assign space conditioning category for supply air plenums
  • #1334 - Check user and baseline model unmet load hours
  • #1335 - Demand controlled ventilation for Appendix G stable baseline
  • #1349 - HVAC controls for Appendix G stable baseline
  • #1350 - Exterior lighting for Appendix G stable baseline
  • #1351 - Window to wall ratio increase methods
  • #1354 - Lighting exceptions for Appendix G stable baseline
  • #1371 - Enthalpy recovery ratio requirements for Appendix G stable baseline
  • #1374 - Configure primary/secondary pumping for Appendix G stable baseline
  • #1375 - Add user data option for number of systems per zone for Appendix G stable baseline
  • #1380 - Baseline elevator power and process loads for Appendix G stable baseline

OpenStudio Server 3.5.0

  • #662 - Update mongoid queries
  • #664 - Fix Radar plot
  • #658 - Fix #539 and add significant digit toggle
  • #665 - Update plots with display name choices in
  • #670 - Ubuntu 20.04
  • #668 - Sobol and morris fix
  • #671 - Uo update
  • #672 - Add URBANopt template OSA for single_run

Issue Statistics Since Previous Release

68 Closed Issues
77 New Issues

Consumption - Buildings and Heating - C++
Published by tijcolem over 2 years ago

OpenStudio - OpenStudio v3.4.0 vcomp fix (Windows Installer Only)

This is an update to the v3.4.0 Windows installer that includes vcomp140.dll for EnergyPlus. This dll is a pretty common library that gets installed alongside with various software so many systems likely already have this (i.e. Windows 2019 server edition), but some bare bones Windows versions may not and will hit the error mentioned on #4581

Consumption - Buildings and Heating - C++
Published by tijcolem almost 3 years ago

OpenStudio - OpenStudio v3.4.0

OpenStudio Version 3.4.0

Release Notes - 05/05/2022

These release notes describe version 3.4.0 of the OpenStudio SDK developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Sciences Center, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Overview
  • Where to Find OpenStudio Documentation
  • Installation Notes
  • OpenStudio SDK: Changelog

Overview

As of April 2020, development and distribution of the OpenStudioApplication and the SketchUp plugin have transitioned to the OpenStudio Coalition, who is independently managing and distributing the software through its own openstudiocoalition/OpenStudioApplication repository. The OpenStudio SDK is continuing to be actively developed and distributed by NREL and is released two times per year, through a spring and a fall release.

Below is the list of components that is included in this SDK installer:

OpenStudio SDK 3.4.0

  • EnergyPlus
  • Command Line Interface (CLI)
  • Radiance
  • Ruby API
  • C++ SDK

Note that PAT is not included in either the SDK or the OpenStudio Coalition's Application installers. You will need to install PAT separately which is distributed on the OpenStudio-PAT GitHub page.

Where to Find OpenStudio SDK Documentation

Installation Notes

OpenStudio SDK 3.4.0 is supported on 64-bit Windows 7 – 10, OS X 10.15, and Ubuntu 18.04, 20.04

OpenStudio SDK 3.4.0 supports EnergyPlus Release 22.1.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio SDK 3.4.0.

OpenStudio SDK 3.4.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer must install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio SDK 3.4.0.

As usual, you can refer to the OpenStudio SDK Compatibility Matrix for more information.

Installation Steps

  • Download and install OpenStudio SDK and/or openstudiocoalition/OpenStudioApplication depending on your needs. Select components for installation. Note that OpenStudio Application is a standalone app and does not require you to install OpenStudio SDK.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.
  • The OpenStudio Application SketchUp Plug-in requires SketchUp 2019 (not available for Linux). The OpenStudio Application SketchUp Plug-in does not support older versions of SketchUp. SketchUp must be installed before OpenStudio Application to automatically activate the plugin. If you install SketchUp after OpenStudio Application, simply re-run the OpenStudio Application installer.

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/getting_started/getting_started/.

OpenStudio SDK: Changelog

The 3.4.0 is a major release. This update includes several new features, performance improvements, and bug fixes.
You can find the list of Pull Requests that got into this release here.

Python Bindings

As of OpenStudio SDK 3.2.0, Python bindings are officially supported and distributed through Python Package Index (PyPI). To install, users will need to have Python3 installed along with pip and simply run the following command in a terminal window. 

pip install openstudio==3.4.0

Please see openstudio on PyPi for further instructions on how to install. Users can also visit the test channel at https://test.pypi.org/project/openstudio/ to install development bindings.

New Features, Major Fixes and API-breaking changes

  • #4560, #4540 - Update to EnergyPlus v22.1.0
  • #4550 - Addresses #4403, add Sql helper methods to retrieve assembly U-factor, SHGC, and Visible Transmittance values for glazing systems
  • #4456 - Fix #4456 - Improve performance of OpenStudio::UnzipFile::extractAllFiles
  • #4424 - Fixes #4361 OpenStudio API-reported surface "netArea" (when dealing with Frame & Divider objects)
  • #4502 - #4496 - Add gems cbor and msgpack and allow using a package from an openstudio-gems PR
  • #4497 - Addresses #4495, ElectricLoadCenterDistribution FT has incomplete charge/discharge logic
  • #4494 - Addresses #4483, OS:Coil:Heating:DX:MultiSpeed:StageData has no Name field
  • #4499 - Addresses #4410, wrap AirflowNetwork:MultiZone:SpecifiedFlowRate
  • #4510 - Addresses #4509, bad nodes created for AirLoopHVAC:UnitarySystem with only cooling coil and supplemental heating coil
  • #4508 - Addresses #4469, method to reverse translate the EnergyPlus ScheduleYear object to the OpenStudio ScheduleRuleset object
  • #4525 - Fixes #4387 gltf changes as per PR 4520 comments/suggestions
  • #4485 - Fixes #4438 gbXML export order is not reproducible
  • #4444 - Fixes #4375 gbXML Import reverses floors/ceilings normals and surface types
  • #4527 - Fixes #4372 intersection issue found using create bar
  • #4535 - Fixes #4533 - Wrap SurfaceProperty:LocalEnvironment and SurfaceProperty:SurroundingSurfaces
  • #4513 - Addresses #4457, support gbXML reverse translation where user-input <Name> is different from the ID
  • #4534 - Addresses #4311, add water heaters (mixed or stratified) to the supply side of different plant loops using source/use side connections (e.g., to configure a heat recovery chiller)
  • #4528 - Cooling tower fixes (ctor for SingleSpeed, and missing IDD defaults) and model tests
  • #4520 - Adds exports functionality to a use web standard glTF to replace deprecated three.js JSON format
  • #4548 - Addresses #4531, breaking changes for some model getters:
    • CoolingTower:*Speed
      • evaporationLossMode (boost::optional<std::string> to std::string)
      • blowdownCalculationMode (boost::optional<std::string> to std::string)
      • cellControl for CoolingTower:VariableSpeed
    • PlantLoop
      • commonPipeSimulation (boost::optional<std::string> to std::string)
      • add new methods: isCommonPipeSimulationDefaulted, commonPipeSimulationValues, and validCommonPipeSimulationValues
  • #4505 Addresses #4477, improve handling of invalid values passed to SDK by adding optional switch for turning off IDD validity checking
  • #4504 Fix #2941 - Add option to show workflow run stdout + style + timings

Minor changes and bug fixes

  • #4487 - Add operator< for BCLComponent and BCLMeasure
  • #4482 - Fix #4481 - add missing \ip-units W to the OpenStudio.idd
  • #4491 - Fix #4490 - Expose RoofGeometry helpers to Swig bindings
  • #4498 - Bump to 3.3.1 and add default VT
  • #4474 - Better string representation of Matrix and Transformation in the bindings
  • #4475 - Add a method on the FT to get known ft options
  • #4512 - Update copyrights 2022
  • #4537 - Review PR #4534 (for issue #4311) - Proposed changes
  • #4553 - HotFix #4550 - Remove getExteriorFenestrationValue from public API
  • #4555 - Adjustments to WindowPropertyFrameAndDivider and new model gtest
  • #4562 - Update idfs to V22.1.0
  • #4564 - update openstudio gems for standards 0.2.16
  • #4518 - Bump openstudio-gems, conan-openstudio-ruby and add support for Apple M1
  • #4558 - Update macOS M1 (arm64) dependencies

Developer changes:

OpenStudio New Contributors

OpenStudio Standards v0.2.16

  • #1229 Fix autosized minimum OA flow rate for OA controllers and ERV SAT control
  • #1231 Fixed bug adding duplicate water heater object when adding a heat pump water heater
  • #1248 Update deprecated methods from OS 3.2
  • #1249 Fix ERV lookup for 90.1-2019
  • #1250 Fix high-rise apartment water heater ambient temperature
  • #1242 Enable autosizing for HPWHs
  • #1244 Fix check for zone unitary system fuel and fan power lookup
  • #1253 Fix skylight requirements for 90.1-2016, 90.1-2019
  • #1255 Implement new construction search method to accommodate wwr specific lookups
  • #1259 Update ground construction properties to use FC factor constructions for non-prototype uses
  • #1257 Adjust climate zone lookup in construction search to account certain sub-climate zone variations
  • #1263 Add U-values for pre 90.1-2004 attic roofs tagged as residential
  • #1268 Update deprecated zone ventilation method
  • #1270 Fix non-rectangular sky-light in primary school prototype
  • #1271 Remove fluid cooler artifact from geometry templates
  • #1272 Add guard clause in the efficiency lookup in case coil has no capacity
  • #1276 Updated college building occupancy schedules
  • #1281 Correct design outdoor air requirements for some building types, which fixes issue #933
  • #1284 Fix #1284 (low U-value constructions) by removing insulation for low U-value constructions
  • #1278 Fix issue #1278 by adding lab fumehood exhaust fan
  • #1288 Expose occupancy hours for radiant slab controls
  • #1291 Fix issue #1226 by also removing AirLoopHVACDedicatedOutdoorAirSystem objects when removing all HVAC systems
  • #1292 Fix issue #1100 by adding support for propane heating systems
  • #1293 Fix issue #1221 by coordinating inputs to hot water boilers
  • #1294 Fix issue #170 by explicitly setting the standards construction type for exterior doors
  • #1295 Fix issue #1295 by using longstanding ruby syntax
  • #1304 Fix issue #1119 (duplicate constant day schedules) by using a tolerance instead of value check for constant day schedules
  • #1305 Enable and fix testing for college and courthouse prototypes #1302
  • 1306 Fix issue #1306 by setting the correct arguments when adding psz-ac systems to avoid an empty hot water loop

OpenStudio Server v3.4.0

  • Update to 3.4.0 OpenStudio
  • #651 Update rails and puma for security patches
  • #642 pass in allow_disk_usage to mongo in
  • #646 Remove references to travis in documentation and fix badges
  • #647 Update rails for security patches

Issue Statistics Since Previous Release

35 Closed Issues
39 New Issues

Consumption - Buildings and Heating - C++
Published by tijcolem almost 3 years ago

OpenStudio - OpenStudio v3.3.0

OpenStudio Version 3.3.0

Release Notes - 11/05/2021

These release notes describe version 3.3.0 of the OpenStudio SDK developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Sciences Center, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Overview
  • Where to Find OpenStudio Documentation
  • Installation Notes
  • OpenStudio SDK: Changelog

Overview

As of April 2020, development and distribution of the OpenStudioApplication and the SketchUp plugin have transitioned to the OpenStudio Coalition, who is independently managing and distributing the software through its own openstudiocoalition/OpenStudioApplication repository. The OpenStudio SDK is continuing to be actively developed and distributed by NREL and is released two times per year, through a spring and a fall release.

Below is the list of components that is included in this SDK installer:

OpenStudio SDK 3.3.0

  • EnergyPlus
  • Command Line Interface (CLI)
  • Radiance
  • Ruby API
  • C++ SDK

Note that PAT is not included in either the SDK or the OpenStudio Coalition's Application installers. You will need to install PAT separately which is distributed on the OpenStudio-PAT GitHub page.

Where to Find OpenStudio SDK Documentation

Installation Notes

OpenStudio SDK 3.3.0 is supported on 64-bit Windows 7 – 10, OS X 10.15, and Ubuntu 18.04, 20.04

OpenStudio SDK 3.3.0 supports EnergyPlus Release 9.6, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio SDK 3.3.0.

OpenStudio SDK 3.3.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer must install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio SDK 3.3.0.

As usual, you can refer to the OpenStudio SDK Compatibility Matrix for more information.

Installation Steps

  • Download and install OpenStudio SDK and/or openstudiocoalition/OpenStudioApplication depending on your needs. Select components for installation. Note that OpenStudio Application is a standalone app and does not require you to install OpenStudio SDK.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.
  • The OpenStudio Application SketchUp Plug-in requires SketchUp 2019 (not available for Linux). The OpenStudio Application SketchUp Plug-in does not support older versions of SketchUp. SketchUp must be installed before OpenStudio Application to automatically activate the plugin. If you install SketchUp after OpenStudio Application, simply re-run the OpenStudio Application installer.

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/getting_started/getting_started/.

OpenStudio SDK: Changelog

The 3.3.0 is a major release. This update includes several new features, performance improvements, and bug fixes.
You can find the list of Pull Requests that got into this release here.

Python Bindings

As of OpenStudio SDK 3.2.0, Python bindings are officially supported and distributed through Python Package Index (PyPI). To install, users will need to have Python3 installed along with pip and simply run the following command in a terminal window.

pip install openstudio==3.3.0

Please see openstudio on PyPi for further instructions on how to install. Users can also visit the test channel at https://test.pypi.org/project/openstudio/ to install development bindings.

New Features, Major Fixes and API-breaking changes

  • #4406 - Update to EnergyPlus v9.6.0_PlusSpaceFix1
    • Experimental Support for the EnergyPlus 9.6.0 space concept was added
      • This feature is currently opt-in, either by manually calling ForwardTranslator::setExcludeSpaceTranslation(false) before calling ForwardTranslator::translateModel(Model&) or passing the CLI argument --space-translation to the run method (eg: openstudio run --space-translation -w workflow.osw)
      • A few limitations due to DaylightingControls/IlluminanceMap exist: in case one of these objects is found in a ThermalZone, spaces will be combined for that ThermalZone (historical behavior)
      • #4471 - Space PR: adjustments to make DaylightingControls work
      • #4434 - Addresses #4409, forward translate Space
      • #4447 - Add ForwardTranslator options to the CLI run method
      • #4465 - [Developer] Refactor Forward Translation of ThermalZone in particular for Space translation PR
    • Note: EnergyPlus due to the Space feature now enforces unicity of names within the Zone, Space, ZoneList and SpaceList objects. As a result, we are now enforcing this in the openstudio::model namespace: the same name can no longer be used for objects of type ThermalZone, Space, SpaceType.
  • #4350 - Fix #3599 - Add new fields to control outdoor air for AirTerminalSingleDuctInletMixer
  • #4365 - Addresses #4364, Availability Schedule for DaylightingControl
  • #4342 - Fix #4327 - FanSystemModel electricPowerFraction should be optional
  • #4368 - Addresses #4362, add support of HeatPump:PlantLoop:EIR:Heating and HeatPump:PlantLoop:EIR:Cooling to model air-to-water heat pump
  • #4382 - Addresses #4380, completing SDK support of Tubular and Light Well Daylighting Devices
  • #4381 - Addresses #3906, support new field 'Minimum Air Flow Turndown Schedule Name' for AirTerminals
  • #4407 - Add AirLoopHVAC to ThreeJS user data by @antoine-galataud
  • #4402 - Addresses #3910, realign OS:SizingPeriod:DesignDay with E+ IDD
  • #4417 - Fix #4156 - Support nested subfolders in approved Measure directories
  • #4452 - Fix #4448 - Issues with angles in DaylightingControl
  • #4317 - Addresses #3147, add HeatExchanger:Desiccant:BalancedFlow
  • #4326 - Fix Wrap E+ WaterHeater:Sizing object
  • #4319 - Fix Wrap E+ FuelFactors object
  • #4418 - Resolves #4395 Add in CLI option to use epJSON
  • #4347 - Fix #227 - Actually use the EPW start year or start day of week when "UseWeatherFile" is used in YearDescription for assumedYear
    • Please note that before, while the IDD default was UseWeatherFile, it would typically use the Assumed Base Year instead (2009) which resulted in using Thursday as a Start Day of Week for simulation. Depending on your weather file, you might experience a different Start Day of Week which could lead to slight EUI deviations. More information can be seen on NREL/OpenStudio-resources#153
  • #4389 - Update BCL to use BCL2 (https://bcl2.nrel.gov/)

Minor changes and bug fixes

  • #4349 - Fix #3514 - Make strings returned from openstudio to ruby UTF8
  • #4346 - Addresses #4329 and #4330, issues with AirLoopHVAC:UnitaryHeatCool:VAVChangeoverBypass
  • #4356 - Fix #4353 - Add a missing reference in E+ Idd for PythonPlugin:Instance (ProgramNames)
  • #4355 - Fix #4354 - Issue AirLoopHVACOutdoorAirSystem::reliefComponents with ZoneHVACComponents: wrong order
  • #4348 - Fix #2145 - Do not create an extra singlezone SPM humidity min created if humidifier downstream of fan
  • #4343 - Fix #4335 - Should reset the air nodes when cloning a AirLoopHVACUnitarySystem
  • #4345 - #4046 - Clarify the situation with output file in the ReportingMeasure Template
  • #4339 - Fix #4338 - AirLoopHVAC_Impl::terminalForLastBranch doesn't handle Dual duct correctly
  • #4359 - Addresses #4314, add ScheduleRuleset custom day methods
  • #4352 - Fix #1571 - building.clone breaks space surface matching
  • #4378 - Addresses #1515, Reverse Translator should retain thermal zone name from IDF instead of re-naming it
  • #4385 - Fixes Crash in floorplanToThreeJS https://github.com/NREL/OpenStudio/issues/4384
  • #4398 - ref #4397 - Fix some issues in our Init calls for embedded ruby
  • #4305 - Fix #4304 - Minimal fix for GroundHeatExchanger:Vertical to avoid confusion between maximum and design flow rates
  • #4400 - #4399 - Surface fixes
  • #4392 - Fix #4390 - add OSRunner::getOptionalBoolArgumentValue
  • #4420 - Fix #4419 - custom mapping for LCC Use Price Escalation
  • #4428 - Avoid issues with openstudio_ruby revision not matching
  • #4440 - Fix #4439 - Correctly Reverse Translate gbXML Schedules
  • #4450 - Fix #4446 - add SizingSystem::autosizedOccupantDiversity.
  • #4454 - Fix #4404 #4453 - Fix issues with ForwardTranslator options
  • #4431 - Fixed an issue in Surface splitSurfaceForSubSurfaces
  • #4459 - Fix #3426 - ZoneHVACUnitHeater components missing air inlet/outlet node names when Fan:OnOff
  • #4455 - Fix #4445 - Fix API issues in Controller:WaterCoil
  • #4462 - Fix #4461 - DesignSpecificationOutdoorAir: when combining, Outdoor Air Flow rate for ACH is off by 3600 when "Maximum" method is used
  • #4473 - Fix #4472 - Modify Python in typemaps for path to accept string with Python 3 support
  • #4307 - Standardize Curve IDD references like E+ does (Uni/Bi...variateFunctions) and remove hard check in model code
  • #4337 - Fix Encode searchTerm in BCL (including spaces, not only "+" signs)
  • #4344 - Update openstudio-gems for new versions: openstudio-extension-gem (v0.5.1), openstudio-workflow-gem (v2.3.1) and openstudio-standards (v0.2.15)
  • #4332 - Fix StringHelpers openstudio::replace
  • #4324 - Fix Do not Warn if Sql doesn't have a Year field
  • #4376 - Fix #4309 - disable RUBYLIB env and use --include or -I using cli

Developer changes:

  • #4401 - Update to new stable tag from Github Actions CI (includes CP720 fix)
  • #4476 - Update gems for workflow and extension gem updates
  • #4463 - Add a full FT test for DaylightingControls (backport from Space PR)
  • #4467 - Update unit tests for ElectricEquipmentITEAirCooled
  • #4383 - Provide more options for installation of openstudio dlls
  • #4302 - Fix Deprecation Warning of last argument as keyword parameters
  • #4421 - Fix #4220 - Don't pass built in POD types by const ref& but by value
  • #4371 - Github Actions to publish python bindings to pypi when it's a release and testing worked
  • #4466 - Add Full detailed tests for the FT of SpaceInfiltration objects (whether assigned to space or spacetype)
  • #4468 - Add a full FT test for ElectricEquipmentITEAirCooled (backport Space PR)
  • #4427 - Fix #4423 - enable coverage on one of the linux runners
  • #4369 - #4214 Add in automated testing for 32/64 bit nuget package

OpenStudio Standards v0.2.15

  • #1153 - Fix error handling in thermal zone occupancy schedule method

  • #1160 - Fix HPWH capacity fix

  • #1123 - Updated documentation to cover all methods #1123

  • #1131 - Updated gem dependencies to resolve security issues #1131

  • #1120 - Added college building prototype #1120

  • #1117 - Fixed bug in schedule_compact_annual_min_max_value method #1117

  • #1113 - Disable sizing run periods after sizing run #1113

  • Added new requirements for ASHRAE Standard 90.1-2019:

    • Hotel guest room ventilation and thermostat control
    • Update to freezer and reach-in refrigerator efficiency
    • Multi-zone system temperature supply applied to warm and humid climate zones
    • Update to computer room air-conditioning efficiency
    • Update to walk-in cooler and freezer efficiency
    • Update to damper leakage rate requirements
    • Added clean water pumps requirements
    • Update to boiler and furnace efficiency
    • Added logic to implement occupant standby mode control requirements
    • Updated daylighting control dimming requirements
    • Added non-transient dwelling units energy recovery based on enthalpy recovery ratio
    • Added ASHRAE Standard 62.1-2019 Simplified Procedure

OpenStudio Server v3.3.0

  • #633 - Merge urbanopt/reopt
  • #634 - Fix in.osm not downloadable
  • #635 - Bump puma version for security
  • #636 - Add docker container scanning using Trivy

Issue Statistics Since Previous Release

116 Closed Issues
99 New Issues

Consumption - Buildings and Heating - C++
Published by tijcolem over 3 years ago

OpenStudio - OpenStudio v3.2.1

OpenStudio Version 3.2.1

Changes since 3.2.0

  • #4307 - Standardize Curve IDD references like E+ does (Uni/Bi...variateFunctions) and remove hard check in model code
  • 4337 - Fix Encode searchTerm in BCL (including spaces, not only "+" signs)
  • #4344 - Update openstudio-gems for new versions of measure-tester-gem (v0.3.1), openstudio-extension-gem (v0.4.3), openstudio-workflow-gem (v2.2.1) and openstudio-standards (v0.2.14).
  • #4332 - Fix StringHelpers openstudio::replace
  • #4326 - Fix Wrap E+ WaterHeater:Sizing object
  • #4324 - FIx Do not Warn if Sql doesn't have a Year field
  • #4319 - Fix Wrap E+ FuelFactors object
  • #4302 - Fix Deprecation Warning of last argument as keyword parameters

OpenStudio Standards v0.2.14

  • Added comstock 2016 and 2019 templates
  • Fixed a coil reference for radiant systems
  • Fixed a method name compatibility issue for VAV terminals for OS v3.0.0 and earlier
  • Adjusted radiant fractions for lighting to better reflected lighting fractions in newer lighting technology

Consumption - Buildings and Heating - C++
Published by tijcolem almost 4 years ago

OpenStudio - OpenStudio v3.2.0

OpenStudio Version 3.2.0

Release Notes - 05/04/2021

These release notes describe version 3.2.0 of the OpenStudio SDK developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Sciences Center, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Overview
  • Where to Find OpenStudio Documentation
  • Installation Notes
  • OpenStudio SDK: Changelog

Overview

As of April 2020, development and distribution of the OpenStudioApplication and the SketchUp plugin have transitioned to the OpenStudio Coalition, who is independently managing and distributing the software through its own openstudiocoalition/OpenStudioApplication repository. The OpenStudio SDK is continuing to be actively developed and distributed by NREL and is released two times per year, through a spring and a fall release.

Below is the list of components that is included in this SDK installer:

OpenStudio SDK 3.2.0

  • EnergyPlus
  • Command Line Interface (CLI)
  • Radiance
  • Ruby API
  • C++ SDK

Note that PAT is not included in either the SDK or the OpenStudio Coalition's Application installers. You will need to install PAT separately which is distributed on the OpenStudio-PAT GitHub page.

Where to Find OpenStudio SDK Documentation

Installation Notes

OpenStudio SDK 3.2.0 is supported on 64-bit Windows 7 – 10, OS X 10.14 – 10.15, and Ubuntu 18.04, 20.04

OpenStudio SDK 3.2.0 supports EnergyPlus Release 9.5, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio SDK 3.2.0.

OpenStudio SDK 3.2.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer must install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio SDK 3.2.0.

OpenStudio SDK 3.2.0 now uses Ruby 2.7.2 as the supported version (2.5.5 previously in the 3.x series, and 2.2.4 for 2.x series).

As usual, you can refer to the OpenStudio SDK Compatibility Matrix for more information.

Installation Steps

  • Download and install OpenStudio SDK and/or openstudiocoalition/OpenStudioApplication depending on your needs. Select components for installation. Note that OpenStudio Application is a standalone app and does not require you to install OpenStudio SDK.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.
  • The OpenStudio Application SketchUp Plug-in requires SketchUp 2019 (not available for Linux). The OpenStudio Application SketchUp Plug-in does not support older versions of SketchUp. SketchUp must be installed before OpenStudio Application to automatically activate the plugin. If you install SketchUp after OpenStudio Application, simply rerun the OpenStudio Application installer.

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/getting_started/getting_started/.

OpenStudio SDK: Changelog

The 3.2.0 is a major release. This update includes several new features, performance improvements, and bug fixes.
You can find the list of Pull Requests that got into this release here.

Update to Ruby 2.7.2

OpenStudio SDK now comes with Ruby 2.7.2 (#4207) which provides many improvements over the previous version, v2.5.5, such as pattern matching, REPL improvement, compaction GC, separation of positional and keyword arguments, and security related improvements.

To see the full list of Ruby updates and improvements, please refer to the official ruby release notes.

Python Bindings

New for OpenStudio SDK is support for Python bindings ( #4122). OpenStudio users can now use the popular Python Programming language across supported platforms to interface with OpenStudio SDK. Users can install the bindings using the Python package tool called pip. To install, users will need to have Python3 installed along with pip and simply run the following command in a terminal window.

pip install openstudio==3.2.0

Please see openstudio on PyPi for further instructions on how to install. Users can also visit the test channel at https://test.pypi.org/project/openstudio/ to install development bindings.

New Features, Major Fixes and API-breaking changes

A number of new features and API-breaking changes have been implemented in OpenStudio SDK 3.2.0:

  • #4271 - Update to EnergyPlus v9.5.0

    • Most of the actual changes were done in #4212 - Update to V9.5.0-IOFreeze

  • New objects:

    • #4155 - Wrap Humidifier:Stream:Gas in OS SDK
    • #4157 - Wrap ZoneHVAC:CoolingPanel:RadiantConvective:Water in OS SDK
    • #4159 - Wrap Refrigeration:ComporessorRack in OS SDK
    • #4186 - Wrap Chiller:Electric:ReformulatedEIR in OS SDK
    • #4192 - Wrap Generator:WindTurbine in OS SDK
    • #4193 - Wrap Fan:ComponentModel in OS SDK
    • #4194 - Wrap PhotovoltaicPerformance:Sandia in OS SDK
      • The recommended instantiation is via the factory methods GeneratorPhotovoltaic::sandia(const Model&) or GeneratorPhotovoltaic::fromSandiaDatabase(const Model&, const std::string& sandiaModulePerformanceName) where sandiaModulePerformanceName is one of keys in the now-embedded Sandia database. Please use the PhotovoltaicPerformanceSandia::sandiaModulePerformanceNames() static method to lookup the valid names.
    • #4225 - Wrap ElectricLoadCenter:Storage:LiIonNMCBattery in OS SDK
    • #4236 - Wrap CoilSystem:IntegratedHeatPump:AirSource and Coil:WaterHeating:AirToWaterHeatPump:VariableSpeed in OS SDK
    • #4258 - Wrap ZoneInfiltration:FlowCoefficient in OS SDK.
      • This object is wrapped as SpaceInfiltrationFlowCoefficient and is a SpaceLoad

  • #4199 - Add support for translating a Workspace/IdfFile to epJSON

  • #4253 - Allow ZoneHVAC:TerminalUnit:VariableRefrigerantFlow to connect to AirLoopHVAC

  • #4180 - Fixes #4175, issues with ft for ElectricLoadCenter:Distribution

    • ElectricLoadCenterDistribution objects are now possible with no generators / transformers
    • A default ElectricLoadCenterDistribution is no longer instantiated in the constructor of children objects: GeneratorFuelCell, GeneratorMicroTurbine, GeneratorPhotovoltaic, GeneratorPVWatts

  • #4153 - Fix #3532 #4152 - Make heating/cooling coils optional for ZoneHVACLowTempVariableFlow and add missing fields to coils

    • This is an API breaking change, the coils are now optional so the getters have been modified to account for this.
    - HVACComponent heatingCoil() const;
+ boost::optional<HVACComponent> heatingCoil() const;
- HVACComponent coolingCoil() const;
+ boost::optional<HVACComponent> coolingCoil() const;

  • #4221 - Geometry improvements including fixing intersection issues

Minor changes:

  • #4136 - Fix #4125, Fix #4135 - GbXML ForwardTranslator: clear map&set, and add a modelToGbXMLString method

  • #4137 - Addresses #4076, radiant system enhancements

  • #4149 - Addresses #3706, add drain water heat exchanger methods to WaterUseConnections

  • #4188 - Fix #4187 - speed up IdfFile::save (and derived, such as Model::save) and general serialization to string by using '\n' instead of std::endl

  • #4239 -Fix #4226 - add int argument for ScheduleFile.setMinutesperItem method

  • #4061 - Fix Cloning a DualDuct AirLoopHVAC breaks the existing loop

  • #4081 - #4077 Remove name field from common HVAC data objects that are not visible to user

Minor Bug Fixes

  • #4123 - Addresses #4110, align PTAC and PTHP coils with EnergyPlus
  • #4173 - Fixes FT of Design Maximum Continuous Input Power for ElectricLoadCenterStorageConverter
  • #4179 - Fixes bug in SurfaceProperty:ExposedFoundationPerimeter IDD
  • #4180 - Addresses #4175, issues with ft for ElectricLoadCenter:Distribution
  • #4211 - Fix #4205 - WorkspaceObject::setString allows setting invalid names for ModelObjects
  • #4218 - Fix #4217 - Do not make an PlantEqOperationUncontrolled for a Component that is already on a PlantEquipmentOperationComponentSetpoint
  • #4245 - Fix #4166 - Merging FloorSpaceJS can delete unique model Objects such as Facility, Building, Site (and children)
  • #4235 - Fix #4111 - Shading:Building is improperly mapped when "World" coordinates are used for Rectangular Surfaces
  • #4256 - Fix #4254 - Set ComponentType::COOLING for EvaporativeFluidCoolerTwoSpeed
  • #4243 - Fix #4240 (and more): add missing \ip-units gal/min via a script

OpenStudio Standards v0.2.13

  • Fixed a bug related to the implementation of DCV requirements which now impacts many more buildings
  • Zone HVAC equipment now defaults to the zone occupancy schedule if it provides ventilation, otherwise it cycles
  • Added the ability to export standards .json data to a separate repository https://github.com/NREL/BuildingStandardsData
  • Refactored PSZ systems to use the unitary system object for all PSZ types
  • Clarified the distinction between and added support for fluid coolers and closed cooling towers
  • Added standards 90.1-2016 and 90.1-2016 methods and data
  • Included several updates to ComStock versions of standards for commercial stock modeling

OpenStudio Server v3.2.0

  • Update to OpenStudio SDK v3.2.0 and EnergyPlus 9.5
  • #615 Include optional UrbanOpt
    to run UrbanOpt workflows
  • $625 Update rails to 6.1.3.1 and ruby to use 2.7.2 along with other core dependency gems.
  • #617 Move CI from Travis to GitHub actions
  • #613 Update mongo to 4.4.2 and redis 6.0.9 and allow for optional authetication of mongo and redis.

Issue Statistics Since Previous Release

184 Closed Issues
86 New issues

Consumption - Buildings and Heating - C++
Published by tijcolem almost 4 years ago

OpenStudio - OpenStudio v3.1.0

OpenStudio Version 3.1.0

Release Notes - 10/16/2020

These release notes describe version 3.1.0 of the OpenStudio SDK developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Sciences Center, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Overview
  • Where to Find OpenStudio Documentation
  • Installation Notes
  • OpenStudio SDK: Changelog

Overview

As of April 2020, development and distribution of the OpenStudioApplication and the SketchUp plugin have transitioned to the OpenStudio Coalition, who is independently managing and distributing the software through its own openstudiocoalition/OpenStudioApplication repository. The OpenStudio SDK is continuing to be actively developed and distributed by NREL and is released two times per year, through a spring and a fall release.

Below is the list of components that is included in this SDK installer:

OpenStudio SDK 3.1.0

  • EnergyPlus
  • Command Line Interface (CLI)
  • Radiance
  • Ruby API
  • C++ SDK

Note that PAT is not included in either the SDK or the OpenStudio Coalition's Application installers. You will need to install PAT separately which is distributed on the OpenStudio-PAT GitHub page.

Where to Find OpenStudio SDK Documentation

Installation Notes

OpenStudio SDK 3.1.0 is supported on 64-bit Windows 7 – 10, OS X 10.14 – 10.15, and Ubuntu 18.04.

OpenStudio SDK 3.1.0 supports EnergyPlus Release 9.4, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio SDK 3.1.0.

OpenStudio SDK 3.1.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer must install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio SDK 3.1.0.

OpenStudio SDK 3.x now uses Ruby 2.5.5 as the supported version (2.2.4 previously).

As usual, you can refer to the OpenStudio SDK Compatibility Matrix for more information.

Installation Steps

  • Download and install OpenStudio SDK and/or openstudiocoalition/OpenStudioApplication depending on your needs. Select components for installation. Note that OpenStudio Application is a standalone app and does not require you to install OpenStudio SDK.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.
  • The OpenStudio Application SketchUp Plug-in requires SketchUp 2019 (not available for Linux). The OpenStudio Application SketchUp Plug-in does not support older versions of SketchUp. SketchUp must be installed before OpenStudio Application to automatically activate the plugin. If you install SketchUp after OpenStudio Application, simply rerun the OpenStudio Application installer.

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user- documentation/help/troubleshooting/.

OpenStudio SDK: Changelog

The 3.1.0 is a major release. This update includes several new features, performance improvements, and bug fixes.
You can find the list of Pull Requests that got into this release here.

New Features, Major Fixes and API-breaking changes

A number of API-breaking changes have been implemented in OpenStudio SDK 3.1.0:

  • #3960 - Added support for building the C# bindings via dotnet CLI, including on Unix platforms
  • #3966 - Closes #3945 - Support the EnergyPlus object SurfaceControl:MovableInsulation which can be used to add insulation surface(s) on top of opaque surfaces, such as a transparent coating that affects the radiative gains to a roof surface
  • #3959 - Also included some improvements in the generated C# bindings by reducing build warnings and properly exposing some types via SWIG
    • ScheduleTypeKey (which is normally only use by OpenStudio internals in ScheduleTypeRegistry checks) previously mapped to a std::pair<std::string, std::string> which was SWIGed in ruby as an Array of strings of size two, but improperly exposed in C#. It now uses a dedicated helper class with two methods ScheduleTypeKey::className() and ScheduleTypeKey::scheduleDisplayName()
  • #3987 - Closes #3907 - Support new Coil:Cooling:DX, Coil:Cooling:DX:CurveFit:Performance, Coil:Cooling:DX:CurveFit:OperatingMode, Coil:Cooling:DX:CurveFit:Speed objects
  • #4009 - Closes #4006 - Add SwimmingPool:Indoor to SDK
  • #4050 - Fixes #3921 - Some children of RefrigerationSystem can be added several times and produce a fatal when System is removed
    • RefrigerationSystem will now be enforcing unicity for all children. This was already the case for a few of the child objects such as Case and WalkIns, it is now the case for all objects (RefrigerationCondenserCascade, RefrigerationSubcoolerMechanical and RefrigerationSubcoolerLiquidSuction, etc.). What this means is that setter methods (or add methods in case of a list) will remove the child for any current RefrigerationSystem it is on first.
  • #4066 - Multiple shading controls referenced by a single subsurface
    • SubSurface was historically the one referencing the ShadingControl object. Now it's a many-to-many relationship where ShadingControl has an extensible 'Sub Surface Name' field, and multiple ShadingControl objects can reference the same SubSurface. This is trickling down from a change introduced in EnergyPlus version 9.4, and specifically in PR NREL/EnergyPlus#8196
    • Methods in SubSurface have been deprecated but are kept for backward compatibility. They will be removed in a future version of OpenStudio:
      • shadingControl(): prefer shadingControls()
      • setShadingControl(ShadingControl&): use addShadingControl(SubSurface&), addShadingControls(std::vector<SubSurface>&) or setShadingControls(std::vector<SubSurface>&)
      • resetShadingControl(): use removeAllShadingControls() instead
    • All Shading Control Type values should now be supported. Refer to issue #4074 for more information
    • Fields 'Glare Control Is Active', 'Type of Slat Angle Control for Blinds', 'Slat Angle Schedule Name', 'Setpoint2', and 'Multiple Surface Control Type' are now implemented as well
  • #4026 - Fix OpenStudio Windows crashed during save attempt
  • #4028 - Fixes #3835 - Decrease overall load time of CLI and lazy load OpenStudio ruby bindings when possible
  • #4059 - Add new OutputControl:Files object to SDK, which allows conditionally turning on/off output from EnergyPlus
  • #4101 - Update EnergyPlus v940 official

Minor changes:

  • #3961 - Update cmake to use included FindPython method and fix zlib's crypt.h
  • #3970 - Update conan dependency fmt/6.2.0 and use option to define FMT_HEADER_ONLY
  • #3979, #4004, #4071 - Update openstudio-gems to include openstudio-extension v0.3.0, openstudio-workflow v2.1.0, openstudio-standards v0.2.12, openstudio_measure_tester v0.2.3
  • #4015, #4047- Updates the conan dependencies to try and pin version using hash
  • #4027 - Include 64/32 bit universal nuget package in cmake build process.
  • #4029 - Closes #3832 - Allow for silent install on windows
  • #4055 - Closes #4054 - Add latitude, longitude, elevation accessors to FloorplanJS
  • #4068 - Closes #4067 - Remove the ENV ruby bundle variables so the cli does not use them

Minor Bug Fixes

  • #3957 - Fix for ruby bundle changes.
  • #3971 - Fixes #3943 - ThreeJS should handle ConstructionAirBoundary
  • #3973 - Fixes #3972 - ScheduleRuleset remove winterDD/summerDD/holiday ScheduleDay in reset.
  • #3978 - Fixes #3976 - Add 'Minimum Outdoor Dry-Bulb Temperature for Compressor Operation' to all Coil:Cooling:DX:XXX objects
  • #3980 - Fixes #2033 - Properly connected the secondary/induced air node for ATUs
  • #3981 - Fixes #2977 - Make VAVReheat Method consistent with IDD and other objects
  • #3983 - Fixes #1058 - Warn only if the file extension isn't OSM, OSC, IDF, IMF, or DDY
  • #3985 - Fixes #3926, Fixes #3984 - Handle multiple AirLoopHVACs and assign the DSOA to all ControllerMechanicalVentilation objects. AirLoopHVAC translates the AirLoopHVACOutdoorAirSystem, which in turns translates the ControllerOutdoorAir
  • #3986 - Fixes #2797 - Do not translate a ZoneHVACLowTempRadiant object if it doesn't have any surfaces with Internal Source
  • #3988 - Fix bug in GenerateClass.rb
  • #3989 - Fixes #3076 - Make openstudio::Vector "Enumerable" in ruby
  • #3993 - Added logic to rejoin previously triangulated window geometry before calling computeTriangulation on the base surface. Fixed several bugs in joinAll and translation to ThreeJS format
  • #3995 - Implements eql? and hash for UUID in Ruby so UUID can be used as a key in a Ruby Hash
  • #3996 - Fixes #3990 - Add an API to CoilCoolingDXMultiSpeed to add/remove stages
  • #3998 - Fixes #3997 - GbXMLReverseTranslator applies incorrect scaling to windows when unit isn't meter
  • #3999 - Removes a "Propane deprecated" warning message that no longer makes sense
  • #4000 - Fixes #3314 - GBXML translate spaces etc even if Facility and/or Building aren't isntantianted
  • #4002 - Fixes #2100 - Remove if defaulted statements in ForwardTranslateThermalZone
  • #4005 - Fixes #4001 - gbXML issue on ForwardTranslation - surfaceType attribute written twice for SlabOnGrade
    3_bind* to ensure proper escaping of parameters such as Zone Names etc
  • #4008 - Fixes #1906 - Use sqlite
  • #4010 - Fixes #4007 - Model objects returned in inconsistent order
  • #4011 - Fixes #1675 - ForwardTranslate WaterHeater:Mixed when not on loop but has Peak Use Flow Rate (standalone operation)
  • #4012 - Fixes #2895 - Extend the list of acceptable SubSurface types to include Skylight
  • #4013 - Fixes 32867 - Sum of fraction radiant, fraction lost, etc can be > 1
  • #4021 - Fixes #4014 - Extend download time to BCL
  • #4023 - Fixes #3936 - SubSurface Type reset when assigned to surface
  • #4030 - Fixes #4030 - AvailabilityManagerNightCycle: Ensure ModelObjectLists are handled in clone/remove
  • #4032 - Fixes #4016 - Move VT from 2.9.0 to 3.0.0 for new fields at end of the ZoneHVAC:TerminalUnit:VariableRefrigerantFlow
  • #4037 - Fixes #3369 - Add missing fields to AvailabilityManager:HybridVentilation
  • #4044 - Fixes #4039 - Add field ' Design Return Air Flow Fraction of Supply Air Flow' to AirLoopHVAC
  • #4048 - Fixes #4036 - Don't create windows or doors for plenums when translating from FloorspaceJSON
  • #4065 - Fixes #4033, Fixes #4034 - Fix AVMList clone between different models
  • #4072 - Fixes #4064 - RunPeriodControlSpecialDays are not Forward Translated
  • #4080 - Fixes #4079 - Install E+ pythonwrapper lib via CMake
  • #4088 - Hotfix for sql queries
  • #4093 - Fixes #4091 - Update FuelType/EndUseFuelType (and Sql) to match E+ 9.4.0
  • #4097 - Fixes #4096 - RT error for ZoneControlThermostat
  • #4099 - Fixes #4089 - Confirm if idf_output_requests still works in reporting measure template
  • #4104 - Fixes #4102 - Fuel Type Renames in EMS Actuator Names
  • #4155 - Fixes #4109 - Fixes ruby bindings issue on windows when working with Sqlite3 db

OpenStudio Standards v0.2.12

  • added missing nonresidential construction properties to the ZE standards
  • updated data center model
  • changed the location for climate zone 0 and 1 weather files
  • use common geometry templates
  • ground refactor to use the FC-factor methodology for 90.1 prototype models
  • bug fixes to align with the OpenStudio 3.0.1 API using Ruby 2.5
  • bug fix to fuel type naming FuelOil#1 -> FuelOil No1 per a recent EnergyPlus change
  • added more detailed logging for economizer logic
  • switch tests to use Jenkins instead of CircleCI
  • updates to central plant models for LargeOffices and Hospitals
  • bug fix to schedule type limits
  • updates to elevators
  • additional support for other types of fluid coolers and cooling towers in the HVAC constructor logic
  • added missing refrigerator case lookups
  • added transformers to several prototypes
  • moved heat recovery lookups to data .json files
  • moved economizer lookups to data .json files
  • bug fix to DCV logic
  • added TallBuilding and SuperTallBuilding prototypes
  • added draft College prototype. While this release includes data for colleges, this only an early draft and should not be used for anything other that early testing or work to improve the college prototype.
  • removed old, central data .json files

OpenStudio Server v3.1.0

  • #555 - Update Ruby gem envs in the openstudio_meta cli
  • #561 - Fixes #560 - Fixes unzip method
  • #563 - Add linux support for extracted gems.
  • #564 - Remove hardcoded openstudio version and sha
  • #566 - Make tmpname deprecate
  • #571 - Make downloading files back to server optional
  • #602 - Add algorithmic test suites
  • #597 - Save the travis gem package artifacts
  • #599 - Save the windows gem package artifacts
  • #580 - add report capability to PSO
  • #579 - Update nokogiri
  • #585 - Update docker-compose version
  • #589 - Use most recent rubocop rules

Issue Statistics Since Previous Release

  • 70 new issues were filed since the 3.0.0 release of OpenStudio (not including opened pull requests)

  • 143 issues were closed since the 3.0.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by tijcolem over 4 years ago

OpenStudio - OpenStudio v3.0.1

Consumption - Buildings and Heating - C++
Published by tijcolem almost 5 years ago

OpenStudio - OpenStudio v3.0.0

OpenStudio Version 3.0.0

Release Notes - 4/24/2020

These release notes describe version 3.0.0 of the OpenStudio SDK developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Overview
  • Where to Find OpenStudio Documentation
  • Installation Notes
  • OpenStudio SDK: Changelog

Overview

Following an important announcement related to future development of the OpenStudio Application released in September 2019 (A Shift in BTO’s BEM Strategy: A New Future for the OpenStudio Application), this release marks the first installment of the separated OpenStudio SDK from the Application.
Going forward, the SDK will continue to be distributed and released two times per year, in April and October. Development of the OpenStudioApplication has been moved to its own NREL/OpenStudioApplication GitHub.

Below is the list of components that is included in this SDK installer:

OpenStudio SDK 3.0.0

  • EnergyPlus
  • Command Line Interface (CLI)
  • Radiance
  • Ruby API
  • C++ SDK

Note that PAT and DView are not included in either the SDK or Application installers. You will need to install PAT separately which is distributed on the OpenStudio-PAT GitHub page and DView at the Dview home page.

Long-Term Support of 2.x version: 2.9.X-LTS

This new major release is bringing a lot of changes not the least of which is the separation of the OpenStudioApplication as well as some API breaking changes.
Only critical bug-fixes will be implemented in the LTS branch and no new features will be developed. The supported EnergyPlus version will remain 9.2.0 in the LTS branch. We encourage users to transition to the 3.x version of OpenStudio.

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio 3.0.0 is supported on 64-bit Windows 7 – 10, OS X 10.12 – 10.15, and Ubuntu 18.04.

OpenStudio 3.0.0 supports EnergyPlus Release 9.3, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 3.0.0.

OpenStudio 3.0.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer must install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio 3.0.0.

OpenStudio 3.x now uses Ruby 2.5.5 as the supported version (2.2.4 previously).

As usual, you can refer to the OpenStudio Compatibility Matrix for more information.

Installation Steps

  • Download and install OpenStudio SDK and/or [OpenStudioApplication]( depending on your needs. Select components for installation. Note that OpenStudio Application is a standalone app and does not require you to install OpenStudio SDK.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.
  • The OpenStudio Application SketchUp Plug-in requires SketchUp 2019 (not available for Linux). The OpenStudio Application SketchUp Plug-in does not support older versions of SketchUp. SketchUp must be installed before OpenStudio Application to automatically activate the plugin. If you install SketchUp after OpenStudio Application, simply rerun the OpenStudio Application installer.

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user- documentation/help/troubleshooting/.

OpenStudio SDK: Changelog

The 3.0.0 is a major release
The 3.0.0 release updates OpenStudio to use EnergyPlus 9.3. This update includes several new features, performance improvements, and bug fixes.
You can find the list of Pull Requests that got into this release here.

New Features, Major Fixes and API-breaking changes

A number of API-breaking changes have been implemented in OpenStudio 3.0:

  • Updated EnergyPlus from v9.2.0 to v9.3.0

  • (#3044) Added support for FanSystemModel to the Model API

  • ThermalZone::addEquipment is no longer exposed to the bindings to avoid confusion and problems, as you should always use ZoneHVACComponent::addToThermalZone instead (#2920, #3758)

  • #3814 - Add ability to create Holiday Schedules in ScheduleRuleset

  • #3882 - Add methods to edit Output:Table:SummaryReports in OpenStudio SDK

  • #3875 - Add OutputDiagnostics, OutputDebuggingData and OutputJSON to model SDK

  • #3853 - Fixes bug where MasslessOpaqueMaterial incorrectly had methods for setting and getting conductivity, density, and specific heat

  • #3744 - New native extension gems have been added into the CLI:

    • pycall v1.2.1 - Allows for calling Python functions from the Ruby language
    • sqlite3 v1.3.13 - Ruby bindings for the SQLite3 embedded database
    • Oga v3.2 - Oga is an XML/HTML parser written in Ruby
    • jara_winker v.1.5.4 - implementation of Jaro-Winkler distance algorithm needed for newer versions of rubocop >= v0.80.0

  • #23 - Updated extension gems have been added into the CLI:

    • bundler v2.1.0
    • openstudio-extension v0.2.1
    • openstudio-workflow v2.0.0
    • openstudio-standards v0.2.11
    • openstudio_measure_tester v0.2.2

  • #3796 - Reporting Measure: you can now pass model to the arguments() method of a reporting measure, for easier setup of output variables

  • #3847 - Chiller:Electric:EIR node API refactor, ChillerAbsorption/ChillerAbsorption tertiary node refactor

    • ChillerElectricEIR::designHeatRecoveryWaterFlowRate() now returns an OptionalDouble instead of a double since it can be now be autosized
    • ChillerElectricEIR no longer has getter/setters that set/return std::string for Node Names. It also wraps two new E+ fields: "Condenser Heat Recovery Relative Capacity Fraction", "Heat Recovery Inlet High Temperature Limit Schedule Name" and "Heat Recovery Leaving Temperature Setpoint Node Name"
    • Added missing Tertiary nodes for ChillerAbsorption
    • For ChillerAbsoprtion, ChillerAbsoprtionIndirect, ChillerElectricEIR:
      • addToTertiaryNode overriden to only allow supply side connection.
      • addToNode overriden to connect to tertiary loop if primary loop is already connected, and Node to connect to is on the supply side of a different plant loop than the current primary loop

  • #3913 - E+ 9.3.0: Update ShadowCalculation to match object refactor in EnergyPlus

    • ShadowCalculation::calculationMethod was renamed to ShadowCalculation::shadingCalculationUpdateFrequencyMethod (same for setter, defaulted, and reset methods)
    • ShadowCalculation::calculationFrequency was renamed to ShadowCalculation::shadingCalculationUpdateFrequency (same for setter, defaulted, and reset methods)
    • ShadowCalculation::polygonClippingAlgorithm() and ShadowCalculation::skyDiffuseModelingAlgorithm(): return type changed from OptionalString (which was always initialized) to std::string
    • All new fields in E+ 9.3.0 were also added

Minor changes:

  • #3846 - SiteWaterMainsTemperature now defaults to the CorrelationFromWeatherFile Calculation Method just like in EnergyPlus.
  • #3846 - BoilerHotWater "Design Water Outlet Temperature" field to match E+
  • #3868 - Fix an error when querying surfaces() of ZoneHVACLowTemperature objects and surfaces have no construction
  • #3844 - Fix crash in FT for HeatPumpWaterToWaterEquationFitCooling/Heating when they reference each other as companion coils
  • #3871 - Remove deprecated Active Year/Institution fields in OS:ClimateZones
  • #3878 - Reporting Frequencies (eg: for OutputVariable) now differentiates between RunPeriod and Annual frequencies
  • #3805 - Support year in EpwFile/EpwDataPoint
  • #3813 - Change default specific heat of new materials to match E+
  • #3849 - Add a missing entry in ScheduleTypeRegistry for SurfacePropertyOtherSideCoefficients
  • #3855 - Autosize ZoneHVACUnitHeater Maximum Water flow rate in constructor
  • #3857 - Reverse translation of WindowMaterial:Glazing sets Optical Data type field incorrectly
  • #3858 - Wrong OS:Daylighting:Control rotation angle translated
  • #3862 - Minor change to the E+ IDD for LifeCycleCost:UsePriceEscalation
  • #3867 - Reset Surface Wind/SunExposure to NoSun/NoWind when setting Outside Boundary Condition to OtherSideCoefficients Fixed in #3916
  • #3903 - Add new fields to PerformancePrecisionTradeoffs for E+ 9.3.0
  • #3898 - Add Minimum zone ventilation efficiency
  • #3894 - SqlFile need to support the "Year" field for IlluminanceMaps
  • #3892 - Add Wrap SimulationControl's Do HVAC Sizing Simulation for Sizing Periods
  • #3885- Allow "CorrelationFromWeatherFile" for SiteWaterMainsTemperature's calculation method
  • #3872 - Adding advanced output variables
  • #3786 #3787 - Allow SDK users to not have to write out SQLite files
  • #3785 - Expose the ZoneVentilation:WindandStackOpenArea in the Model SDK

Minor Bug Fixes

  • #3938 - Fix loading native ext gems for new gems that were added.
  • #3917 - Connecting two ThermalZones in series on an AirLoopHVAC demand branch shouldn't be allowed
  • #3888 - Fix cloning issue for model objects.
  • 3866 - Fix Forward translator Runtime Error if a model has a ZoneHVAC:LowTemperatureRadiant:VariableFlow but no constructions assigned
  • #3854 - Fix Maximum Hot Water Flow Rate to autosize
  • #3823 - Fix RoofGeometry build errors
  • #3793 - Fix ITE object supply/approach temperature difference schedule
  • #3792 - Fix in support of OpenStudio Application

OpenStudio Standards

  • correctly enable DOAS DCV
  • updated and add values for the NREL ZNE Ready 2017 standard and added a ZE AEDG Multifamily standard
  • updated refrigeration code to add walk-in refrigators and freezers to all relevant zones
  • updated economizer logic
  • add properties for climate zones 0A and 0B
  • refactor methods to work with OS 3.0
  • add doors to DOE prototype models
  • updated multizone ventilation calculation logic in the prototype models
  • various bug fixes to prototype models and hvac system methods

Issue Statistics Since Previous Release

  • 67 new issues were filed since the 2.9.1 release of OpenStudio (not including opened pull requests)

  • 124 issues were closed since the 2.9.1 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by tijcolem about 5 years ago

OpenStudio - OpenStudio v2.9.1

Consumption - Buildings and Heating - C++
Published by tijcolem over 5 years ago

OpenStudio - OpenStudio SDK v3.0.0-pre1 and OpenStudio Application v1.0.0-pre1

Release Notes - 11/20/2019

This is a pre-release of both OpenStudio SDK v3.0.0-pre1 and OpenStudio Application (GUI) v1.0.0-pre1 developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators.

This pre-release marks the first installment of the separated OpenStudio SDK from the Application. Going forward, once OpenStudio SDK v3.0.0 is officially released (mid-April 2020), the SDK and Application will be distributed as separate applications and will be released on different schedules.

Below is a list of components that will be included in each respective installer:

OpenStudio SDK 3.0.0-pre1

  • EnergyPlus
  • Command Line Interface (CLI)
  • Radiance
  • Ruby API

OpenStudio Application 1.0.0-pre1

  • OpenStudio Application (GUI)
  • RubyAPI
  • Application Resources
  • EnergyPlus
  • Radiance
  • Command Line Interface (CLI)

Note that PAT will no longer be included in either the SDK or Application installers. You will need to install PAT separately which will be posted on the PAT GitHub page (coming soon).

OpenStudio SDK 3.0.0-pre1 and OpenStudio Application v1.0.0-pre1 are supported on 64-bit Windows 7 – 10, OS X 10.12 – 10.14, and Ubuntu 18.04.

Both the SDK 3.0.0-pre1 and Application v1.0.0-pre1 support EnergyPlus Release 9.2, which is bundled with the installers. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported.

Both support Radiance 5.0.a.12, which is bundled with the installers; users no longer must install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported.

Installation Steps

  • Download and install OpenStudio SDK and/or Application depending on your needs. Select components for installation. Note that OpenStudio Application is a standalone app and does not require you to install OpenStudio SDK.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.
  • The OpenStudio Application SketchUp Plug-in requires SketchUp 2019 (not available for Linux). The OpenStudio Application SketchUp Plug-in does not support older versions of SketchUp. SketchUp must be installed before OpenStudio Application to automatically activate the plugin. If you install SketchUp after OpenStudio Application, simply rerun the OpenStudio Application installer.

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/help/troubleshooting/.

Overview

You can follow announcements related to future development of the OpenStudio Application, which is available at: https://www.openstudio.net/new-future-for-openstudio-application. Please send any questions, comments, or concerns to [email protected] and we will try our best to address them.

Note that this pre-release includes all of the same features included in the 2.9.0 release. Please review the 2.9.0 release notes for information on new features, performance improvements, and bug fixes. It does not contain any new features and/or bug fixes. The official release scheduled for April 2020 will contain new features, improvements and bug fixes.

Consumption - Buildings and Heating - C++
Published by tijcolem over 5 years ago

OpenStudio - OpenStudio v2.9.0

OpenStudio Version 2.9.0

Release Notes - 10/11/2019

These release notes describe version 2.9.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio 2.9.0 is supported on 64-bit Windows 7 – 10, OS X 10.11 – 10.14, and Ubuntu 16.04.

OpenStudio 2.9.0 supports EnergyPlus Release 9.2, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 2.9.0.

OpenStudio 2.9.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer must install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio 2.9.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2017 or 2018 (not available for Linux). OpenStudio 2.9.0 is not compatible with SketchUp 2019. The OpenStudio 3.0 prerelease in October 2019 will be the first version of OpenStudio compatible with SketchUp 2019. The OpenStudio SketchUp Plug-in does not support older versions of SketchUp. SketchUp must be installed before OpenStudio to automatically activate the plugin. If you install SketchUp after OpenStudio, simply rerun the OpenStudio installer.
  • Download and install OpenStudio. Select components for installation.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user- documentation/help/troubleshooting/.

Overview

An important announcement related to future development of the OpenStudio Application is available at: https://www.openstudio.net/new-future-for-openstudio-application. Please read this announcement carefully to understand changes coming for the OpenStudio Application over future releases. Please send any questions, comments, or concerns to [email protected] and we will try our best to address them.

OpenStudio SDK:

The 2.9.0 release updates OpenStudio to use EnergyPlus 9.2. This update includes several new features, performance improvements, and bug fixes.

Updates, Improvement and Fixes:

  • Added missing methods to model API, FT, RT and VT for HeaderedPumpsConstantSpeed and HeaderedPumpsVariableSpeed (#3553). These fields are related to the Design Sizing Method and allow you to enter electric power per flow rate, or per flow rate and head.
  • Updated spider gbXML viewer (#3668)
  • Added new Fields in AirLoopHVACUnitaryHeatCoolVAVChangeoverBypass (#3639). Added a new ‘Priority Control Mode’ choice LoadPriority, added the ‘Minimum Runtime Before Operating Mode Change’ field, and the ‘Plenum or Mixer Inlet Node Name’. For the latter, you can use AirLoopHVACUnitaryHeatCoolVAVChangeoverBypass::setPlenumorMixer(const Mixer& returnPathComponent) to connect it to a AirLoopHVAC:Mixer or a AirLoopHVAC:ReturnPlenum object.
  • Added ‘Temperature Difference Between Cutout And Setpoint’ for ZoneControl:Thermostat (#3584). This field is added to the ThermostatSetpointDualSetpoint class and handled during ForwardTranslation
  • Translate AirWalls to Construction:AirBoundary (#3635)
  • Added ThermalStorage:Ice:Detailed Charging and Discharging Curve Variable Specifications (#3654)
  • Updated EnergyPlus from v9.1 to v9.2
  • Display plantLoop supply equipment in OpenStudioApplication in the same order as the resulting PlantEquipmentList after ForwardTranslaton (#3600)
  • Updated idf translator for E+ change Table:MultiVariableLookup (#3651) In Energyplus version 9.2.0, the table objects such as Table:MultiVariableLookup object were replaced with a new Table:Lookup object. The corresponding OpenStudio API remains the same using TableMultiVariableLookup, and the appropriate adjustments have been made to OpenStudio's EnergyPlus translator to create valid Table:Lookup objects. For more information please review the New Feature Proposal for EnergyPlus https://github.com/NREL/EnergyPlus/blob/v9.2.0/design/FY2018/NFP-Table-Refactor.md.
  • Display non-zero north angle (#3594)
  • Adds ‘Calculation Method’ field to ShadowCalculation (#3571)
  • Allow AirConditioner:VariableRefrigerant condenser Type=WaterCooled (and EvaporativelyCooled (#3604). VRFs can now be connected to the demand side of a PlantLoop, including in the OpenStudioApplication directly, be sure to update the performance curves if you do so.
  • Fixed Import ScheduleFile from IDF (#3347)
  • Added gbXMLId and improving CADObjectId import (#3555, #3554)
  • Fixes crash in CLI if json native gem is installed (#3590)
  • ForwardTranslate End Use by Subcategory for Fan:VariableVolume and Fan:ConstantVolume (#3591)
  • Fix FloorspaceJS json north axis not being imported into OS model (#3585)
  • Added exportToBCVTB field to EnergyManagementSystemGlobalVariable (#3420)
  • Fix crash when leaving tabs with combobox2 (#2792)
  • Use Custom Blocks in Foundation Kiva which implements use of custom blocks in the Foundation:Kiva object. Custom blocks can be used to represent solid materials in the two-dimensional context that are not otherwise covered by the other Foundation:Kiva fields (#3567)
  • Add more heating source object type and tank object type enumerations for Coil:WaterHeating:Desuperheater object (#3565, #3647)
  • Wrap ZoneProperty:UserViewFactors:bySurfaceName object which allows users to specify the thermal radiation exchange view factors between surfaces in a zone (#3664, #3671)
  • Wrap PerformancePrecisionTradeoffs object which enables users to choose certain options that speed up EnergyPlus simulations (#3631)
  • Change the Sequential Load Fractions on ZoneHVAC:EquipmentList into schedules (#3583)
  • ScheduleFixedInterval now with option to translate schedule to ScheduleFile using new CSVFile class (#50, #3610)

OpenStudio Server:

  • Resolved gem dependencies issues for faraday and nio4r

OpenStudio Standards:

  • Split standards data spreadsheet into multiple spreadsheets for each class of standards (e.g. DEER, 90.1)
  • Split standards space types data spreadsheet into multiple spreadsheets to allow notes on individual fields
  • Split out standards data into individual files per standard
  • Added ComStock DEER templates to represent actual building performance in California
  • Added laboratory prototype model
  • Enabled DOE Prototype regression tests
  • Multiple changes to better align openstudio-standards with the PNNL DOE Prototype .idf models
  • Add data and methods for water source heat pump efficiency
  • Added typical refrigeration methods to populate grocery store refrigeration
  • Added additional properties to lighting objects specifying the LPD fraction that is linear, highbay, specialty, or exit lighting
  • Parameterize schedules to allow adjustments depending on hours of operation
  • Added radiant slab system option to model_add_hvac_system with control sequences developed by CBE at UC Berkeley

Issue Statistics Since Previous Release

  • 75 new issues were filed since the 2.8.1 release of OpenStudio (not including opened pull requests).
  • 66 issues were closed since the 2.8.1 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by tijcolem over 5 years ago

OpenStudio - OpenStudio v2.8.1

Consumption - Buildings and Heating - C++
Published by tijcolem almost 6 years ago

OpenStudio - OpenStudio v2.8.0

OpenStudio Version 2.8.0

Release Notes – 4/12/2019

These release notes describe version 2.8.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio 2.8.0 is supported on 64-bit Windows 7 – 10, OS X 10.11 – 10.14, and Ubuntu 16.04.

OpenStudio 2.8.0 supports EnergyPlus Release 9.1, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 2.8.0.

OpenStudio 2.8.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer must install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio 2.8.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2017 or 2018 (not available for Linux). OpenStudio 2.8.0 is not compatible with SketchUp 2019. The OpenStudio 3.0 prerelease in October 2019 will be the first version of OpenStudio compatible with SketchUp 2019. The OpenStudio SketchUp Plug-in does not support older versions of SketchUp. SketchUp must be installed before OpenStudio to automatically activate the plugin. If you install SketchUp after OpenStudio, simply rerun the OpenStudio installer.
  • Download and install OpenStudio. Select components for installation.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/help/troubleshooting/.

Overview

An important announcement related to future development of the OpenStudio Application is available at: https://www.openstudio.net/new-future-for-openstudio-application. Please read this announcement carefully to understand changes coming for the OpenStudio Application over future releases. Please send any questions, comments, or concerns to [email protected] and we will try our best to address them.

OpenStudio SDK:

The 2.8.0 release updates OpenStudio to use EnergyPlus 9.1. This update includes several new features, performance improvements, and bug fixes. LBNL contributed new OpenStudio ModelObjects ElectricEquipmentITEAirCooledDefinition and ElectricEquipmentITEAirCooled which can be used to model air-cooled electric information technology equipment (ITE) with variable power consumption as a function of loading and temperature. Users can now set sequential load heating/cooling fractions for equipment on the ZoneHVACEquipmentList object. The DefaultConstructionSet now has an Adiabatic Surface Construction. End-Use Subcategory fields were added for pumps.

Other changes:

  • Remove 'file://' prefix for file paths listed in OSM files. External files are now referenced by filename only with search path specified in OSW. Affects WeatherFile and ScheduleFile.
  • Sql methods now make use of the Year field that was added in E+ 8.9.0 to avoid problems with leap years (#3453).
  • Force unique names to match new E+ convention following re-factor of E+’s Input Processor. For example, LifeCycleCost objects can no longer bear the same name (#3458).
  • Show Measure Directory Name in OpenStudio Application (#3465). This should make it easier to understand which measure is used even after the user has changed the editable name.
  • Remove non-implemented UtilityCost_* objects from API documentation (#3462)
  • Fix an error in AirTerminalSingleDuctConstantVolumeFourPipeBeam::remove() method that was making the OpenStudio Application crash (#3440)
  • Fixes to API for CoilSystemCoolingDXHeatExchangerAssisted and CoilSystemCoolingWaterHeatExchangerAssisted (#3449)
  • Fix forward translator issues in CoilHeatingDesuperheater and CoilWaterHeatingDesuperheater (#3452)
  • AirLoop::clone was modified to reconnect any supply side coils to the same plant loops as the original coils. This method will clone an AirLoopHVAC with the following rationale:
    • Handle all non-branch components from both the supply and the demand side
    • On the demand side branches, place one terminal of each IddObjectType that is present on the original AirLoopHVAC
    • Clone any SetpointManagers and add them to the correct location
    • If the supply component that is cloned is connected to a PlantLoop, we try to the connect the clone to the same PlantLoop by adding a demand branch
  • PlantLoop::clone was added and follows the same logic. This method will clone a Plant Loop with the following rationale:
    • Handle all non-branch components from both the supply and the demand side
    • Handle branch components on the supply side (between supply splitter and mixer)
    • Clone any SetpointManagers and add them to the correct location
    • If the component that is cloned is connected to another PlantLoop, we try to connect the clone to the same other PlantLoop (if comp is on the supply side, we add a demand branch to the other Plantloop)

OpenStudio Server:

  • Upgraded to Ubuntu 16.04 and R version 3.5.2
  • Added plots for Sobol method
  • Added argument to do out of bounds check for Morris method. If selected true, analysis won't run if created data points do not respect max/min of variables.
  • Correct Morris results json format
  • Correctly kill OpenStudio process after timeout.
  • Timeouts increased from 2hrs to 4hrs for each data point.
  • Adjusted processor allocation for remote deployments.
  • Fixed "Cancel" functionality.
  • Set analysis status to "post-processing" while analysis finalization script is running.
  • Better support for publishing custom AMIs and Docker images.

OpenStudio Standards:

  • Adds a model for heat pump water heaters (HPWH) which uses the WaterHeaterMixed object with an electric fuel and a higher-than-1 efficiency to mimic HPWHs without incurring the significant penalty of the stratified tank. The nuances of some HPWH behavior are lost, so we don’t recommend using this unless you investigate and accept the accuracy tradeoffs for your application.
  • Adds typical refrigeration methods. This method adds detailed refrigeration systems to grocery stores and adds single-walkin systems to other building types with kitchens. For grocery stores, the typical characteristics are based on a combination of expert knowledge and the ASHRAE grocery store Advanced Energy Design Guide. Case and walkin lineups for the grocery store are scaled based on the store size. Walkins for kitchens are not scaled.
  • Adds a new standards worksheet and methods to determine the number of elevators based on building type. Elevator schedules are now based on adjustments to the occupancy schedule rather than set explicitly. changed code to pull elevator logic from this new sheet.
  • Elevator end uses are now tagged with end use category 'Elevators'.
  • Adds in both ASHRAE 169-2006 and ASHRAE 169-2013 climate zone definitions to the spreadsheet and the code base. ASHRAE 169-2013 updates city locations and ground temperatures for each climate zone.
  • Adds the ability to model air to water heat pumps on hot water loops in place of boilers. The equipment is modeled with a PlantComponentUserDefined object. A full air to water heat pump object will be available in the next EnergyPlus/OpenStudio release.
  • Change the default condenser loop to follow OATwb with 7F approach instead of a fixed setpoint temperature.
  • Default to mandate off-hour controls for air loops per 90.1 section 6.4.3.3, based on zone occupancy schedules on an air loop.
  • Use a default infiltration rate matched to the PNNL modeling guideline value of 1.8 cfm/ft2 exterior surface area at 75 Pa instead of zero.
  • Exterior equipment now uses the ExteriorFuelEquipment object instead of the ExteriorLights object.
  • Exterior lighting calculations now estimate the number of doors based on ground floor area, not total area.
  • Refactors exterior area and length calculations for exterior lighting to use standards building type, not standards space type. Before, the method was looping over standards space types and adding a minimum of one building entry per space type, resulting in very high main entryway lighting.

DOE prototype model changes:

  • Uses ASHRAE 169-2013 for climate zone definitions and locations instead of ASHRAE 169-2006
  • Adds small office and large office detailed prototypes models.
  • Deactivate daylighting control for side lighting for the retail prototypes for 90.1-2010 (exception c to section 9.4.1.4 of 90.1-2010) and 90.1-2013 (exception 3 to section Section 9.4.1.1(e)).
  • Add Computer Rooms to All 90.1 Schools Templates.
  • Fix issue to add thermal zone multipliers where present.

Bug fixes:

  • DEER schedules now include explicit design day schedules.
  • Fix issue where duplicate internal mass objects were being added to the same zone.
  • Add more detailed error messages for economizers.
  • Set heating maximum air flow fraction to 1.0 for ZoneHVACIdealLoadsAirSystem to allow full heating airflow during sizing.

Issue Statistics Since Previous Release

  • 56 new issues were filed since the 2.7.0 release of OpenStudio (not including opened pull requests).
  • 86 issues were closed since the 2.7.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by tijcolem about 6 years ago

OpenStudio -

Consumption - Buildings and Heating - C++
Published by macumber over 6 years ago

OpenStudio - OpenStudio v2.7.1

Consumption - Buildings and Heating - C++
Published by macumber over 6 years ago

OpenStudio - OpenStudio v2.7.0

OpenStudio Version 2.7.0

Release Notes – 10/12/2018

These release notes describe version 2.7.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – Windows 10, OS X 10.10 – 10.11, and 64-bit Ubuntu 14.04.

OpenStudio 2.7.0 supports EnergyPlus Release 9.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 2.7.0.

OpenStudio 2.7.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer must install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio 2.7.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2017 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp.
    • If the OpenStudio Plug-in does not automatically load in SketchUp, open the Window->Preferences->Extensions window in SketchUp and enable the OpenStudio plug-in if it is listed.
  • Download and install OpenStudio. Select components for installation.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/help/troubleshooting/.

Overview

An important announcement related to future development of the OpenStudio Application is available at: https://www.openstudio.net/new-future-for-openstudio-application. Please read this announcement carefully to understand changes coming for the OpenStudio Application over future releases. Please send any questions, comments, or concerns to [email protected] and we will try our best to address them.

OpenStudio SDK:

The 2.7.0 release updates OpenStudio to use EnergyPlus 9.0. This update includes several new features, performance improvements, and bug fixes. This release also includes two new command line switches for the OpenStudio Command Line Interface (CLI): --bundle and --bundle_path. These switches allow the OpenStudio CLI to use a pre-made bundle of Ruby gems, allowing more control over gems used by measures. Geometry import and merge functionality was enhanced from gbXML, IDF, and OSM sources. Users can import and merge geometry from these file types with their existing OpenStudio Models. The OpenStudio API was extended to support multiple AirloopHVAC objects per ThermalZone. New model objects were added for ExternalFile and ScheduleFile allowing CSV files to be used for schedule input. There is a known issue (#3297) with ScheduleFile objects created using Apply Measure Now. The ElectricLoadCenterTransformer object was also added to allow modeling of electrical transformers. Many bugs were addressed in this release. Notably, several issues with forward translation of EMS programs were resolved. Serious issues related to SetpointManagers and other HVAC equipment introduced into the C# bindings as of OpenStudio 2.6.0 were resolved.

2.7.0 API Changes:

  • The class AirTerminalSingleDuctUncontrolled was renamed to AirTerminalSingleDuctConstantVolumeNoReheat for consistency with EnergyPlus, a back port was added to the Ruby bindings to preserve compatibility with the old name AirTerminalSingleDuctUncontrolled.
  • The methods constantMinimumAirFlowFraction and fixedMinimumAirFlowRate of AirTerminalSingleDuctVAVReheat now return an optional double rather than a double.

OpenStudio Server:

OpenStudio Server has been updated to address several important issues:

The OpenStudio Server was updated to run datapoints via the OpenStudio Command Line Interface rather than Workflow Gem. This update includes use of the new --bundle and --bundle_path command line switches allowing OpenStudio gems (bundle) to be customized independent of OpenStudio Server bundle. Analysis Initialize and Finalize Scripts can be run for Resque-based environments (ie not on local PAT). Datapoint Initialize and Finalize Scripts have been restructured and can be run on Resque-based environments.

OpenStudio Standards:

OpenStudio Standards underwent a major HVAC system code refactor with updates to the DOE and DEER Prototypes.

  • Adds optimum start
  • Adds door and attic infiltration to DOE prototypes
  • Adds skylight frames
  • Fixes construction sets for attics and soffits
  • Disables ERV SAT outlet control
  • Updates motorized OA damper control to skip loop if a schedule other than AlwaysOn is set for min OA
  • Changes SEER and EER to COP conversion formulas
  • Changes UnitHeaters to be normal (as opposed to small) fans
  • Adds vestibule control for unit heaters
  • Condenses geometry and HVAC JSON files for DOE prototypes to avoid duplication
  • Updates water heater skin loss coefficients
  • Adds water heater to zone (instead of assuming 70F air)
  • Other minor changes to hard-coded DOE prototype assumptions
  • Fixes to DOE and DEER prototype geometries
  • Moves HVAC inference and size categorization to the standards spreadsheet
  • Adds fans as a database in standards spreadsheet
  • HVAC system methods now use keyword arguments and assume defaults, with component constructors (coils, fans, boilers) moved to their own modules
  • Adds several NZE systems, including:
    • VRF
    • DOAS
    • DOAS with DCV controls
  • Name HVAC objects, including naming nodes to be more descriptive
  • Aligns design system, coil, loop, and setpoint manager temperatures where appropriate
  • General bug fixes to HVAC systems
  • Set acoustical tile ceiling construction for models with plenum zones (DOE MediumOffice, DOE LargeOffice, and most DEER models)
  • Adds infiltration to 'DOE Ref 1980-2004' and 'DOE Ref Pre-1980' plenums

Issue Statistics Since Previous Release

  • 39 new issues were filed since the 2.6.0 release of OpenStudio (not including opened pull requests).
  • 73 issues were closed since the 2.6.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by macumber over 6 years ago

OpenStudio - OpenStudio v2.6.1

Consumption - Buildings and Heating - C++
Published by macumber over 6 years ago

OpenStudio - OpenStudio v2.6.0

OpenStudio Version 2.6.0

Release Notes – 6/30/2018

These release notes describe version 2.6.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – Windows 10, OS X 10.10 – 10.11, and 64-bit Ubuntu 14.04.

OpenStudio 2.6.0 supports EnergyPlus Release 8.9.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 2.6.0.

OpenStudio 2.6.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer must install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio 2.6.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2017 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp.
    • If the OpenStudio Plug-in does not automatically load in SketchUp, open the Window->Preferences->Extensions window in SketchUp and enable the OpenStudio plug-in if it is listed.
  • Download and install OpenStudio. Select components for installation.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/help/troubleshooting/.

Overview

OpenStudio SDK:

The 2.6.0 release of OpenStudio includes new features to help write better measures! The new measure templates have been updated to create a license and README.mb.erb for each new measure. When a measure is updated, the README.mb.erb is configured with information from the measure to create a README.md file which is the perfect place to document your measure. You can reference images or other content your measure’s docs/ folder from the README.md file to make your documentation really stand out. Additionally, a new option has been added to the OpenStudio CLI which runs the tests for all measures in a directory and saves a dashboard with results: openstudio measure -r /dir/to/measures/. This dashboard quickly shows all passing/failing tests as well as provide input on Ruby style using Rubocop. Code coverage will be added to the measure testing dashboard in a future release.

The following new model objects have been added to the OpenStudio SDK:

  • GeneratorPVWatts
  • ElectricLoadCenterInverterPVWatts
  • PlantComponentUserDefined
  • AirTerminalSingleDuctConstantVolumeFourPipeBeam
  • CoilCoolingFourPipeBeam
  • CoilHeatingFourPipeBeam

EMS Sensor and Actuator have been expanded to include SpaceLoads arguments. This will allow for correct EMS actuators on SpaceLoads that end up in ZoneLists in E+. The next release will expand on this capability.

OpenStudio Server:

OpenStudio Server has been updated to address several important issues:

  • Fix cursor deleted with accessing /analyses//analysis_data
  • Set version of mongo and redis for docker deploys
  • Backend for Docker deployment now used Resque with Redis instead of delayed jobs.
  • Large Uploads to Server (i.e. lots of weather files) seem to Timeout

OpenStudio Standards:

OpenStudio Standards has the following updates:

  • Added additional DEER prototypes, including multifamily
  • Added service hot water to DEER prototypes
  • General bug fixes for DEER prototypes

Issue Statistics Since Previous Release

  • 48 new issues were filed since the 2.5.0 release of OpenStudio (not including opened pull requests).
  • 15 issues were closed since the 2.5.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by macumber almost 7 years ago

OpenStudio - OpenStudio v2.5.2

Consumption - Buildings and Heating - C++
Published by macumber almost 7 years ago

OpenStudio - OpenStudio v2.5.1

Consumption - Buildings and Heating - C++
Published by evanweaver almost 7 years ago

OpenStudio - OpenStudio v2.5.0

OpenStudio Version 2.5.0

Release Notes – 3/30/2018

These release notes describe version 2.5.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – Windows 10, OS X 10.10 – 10.11, and 64-bit Ubuntu 14.04.

OpenStudio 2.5.0 supports EnergyPlus Release 8.9.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 2.5.0.

OpenStudio 2.5.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer have to install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio 2.5.0.

Installation Steps

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/help/troubleshooting/.

Overview

OpenStudio SDK

OpenStudio now includes the generic AdditionalProperties object that can be used to apply user-defined properties to objects in the OSM. These properties do not directly change the model in any way nor are they forward-translated to EnergyPlus. Rather they can be used by measures to apply logic.

OpenStudio also now includes the Kiva foundation heat transfer calculation tool, a two-dimensional finite difference approach for determining convective heat gains and temperatures for foundation surfaces.

All Energy Management System (EMS) actuators and sensors are now available in the OpenStudio SDK through the methods emsActuatorNames() and emsInternalVariables().

ExteriorFuelEquipment, ExteriorWaterEquipment, and their associated definition objects (ExteriorFuelEquipmentDefinition, ExteriorWaterEquipmentDefinition) have been added to OpenStudio. All exterior equipment, including the existing ExteriorLights (and ExteriorLightsDefinition) now have the same parent classes: ExteriorLoadInstance and ExteriorLoadDefinition.

Preliminary support for the EnergyPlus AirflowNetwork feature is now provided in OpenStudio. Envelope leakage and core elements of distribution networks are supported. Changes are expected to support ongoing enhancements of the AirflowNetwork model (e.g. multiple air loops).

OpenStudio Server

OpenStudio Server has been updated addressing several issues with simulations not completing or running indefinitely.

OpenStudio Standards

Added initial support for the CA DEER Prototype buildings. Refactored codebase to make the addition of new standards easier and more isolated from other code. Added support for additional HVAC systems that can be used for model articulation.

EnergyPlus

Openstudio now incorporates EnergyPlus Release 8.9, which provides new capabilities, and numerous bug fixes.

Known Issues

  • Radiance Daylighting Measure - The Radiance Daylighting Measure is incompatible with EnergyPlus 8.9 (writing results will cause a segfault); we are working on a fix.

  • EnergyPlus no longer allows non-unique names, and while OpenStudio provides unique names for most objects, it does not for objects that do not belong to a reference group. Future OpenStudio SDK changes will ensure that all objects belong to a reference group.

Issue Statistics Since Previous Release

  • 120 new issues were filed since the 2.4.0 release of OpenStudio (not including opened pull requests).
  • 205 issues were closed since the 2.4.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by evanweaver about 7 years ago

OpenStudio - OpenStudio v2.4.3

Consumption - Buildings and Heating - C++
Published by evanweaver about 7 years ago

OpenStudio -

Consumption - Buildings and Heating - C++
Published by evanweaver about 7 years ago

OpenStudio - OpenStudio v2.4.1

Consumption - Buildings and Heating - C++
Published by evanweaver about 7 years ago

OpenStudio - OpenStudio v2.4.0

OpenStudio Version 2.4.0

Release Notes – 12/20/2017

These release notes describe version 2.4.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – Windows 10, OS X 10.10 – 10.11, and 64-bit Ubuntu 14.04.

OpenStudio 2.4.0 supports EnergyPlus Release 8.8.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 2.4.0.

OpenStudio 2.4.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer have to install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio 2.4.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2017 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp.
    • If the OpenStudio Plug-in does not automatically load in SketchUp, open the Window->Preferences->Extensions window in SketchUp and enable the OpenStudio plug-in if it is listed.
  • Download and install OpenStudio. Select components for installation.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/help/troubleshooting/.

Overview

OpenStudio SDK:

OpenStudio HVAC capability was extended with the following additions:

  • New Model API AirLoopHVACUnitarySystem::setControlType
  • Allow AirLoopHVACUnitarySystem object as Zone HVAC Equipment
  • Added support for more E+ fields in pump objects
  • Added new Model object, AirTerminalDualDuctVAVOutdoorAir
  • Added support for more E+ fields in cooling tower objects
  • Added support for more E+ fields in the AvailabilityManagerNightCycle object.
  • Allow ZoneHVACTerminalUnitVariableRefrigerantFlow to be configured without a heating coil

Many new external interface objects have been wrapped and are available in the API:

  • OS:ExternalInterface
  • OS:ExternalInterface:Schedule
  • OS:ExternalInterface:Variable
  • OS:ExternalInterface:Actuator
  • OS:ExternalInterface:FunctionalMockupUnitImport
  • OS:ExternalInterface:FunctionalMockupUnitImport:From:Variable
  • OS:ExternalInterface:FunctionalMockupUnitImport:To:Schedule
  • OS:ExternalInterface:FunctionalMockupUnitImport:To:Actuator
  • OS:ExternalInterface:FunctionalMockupUnitImport:To:Variable
  • OS:ExternalInterface:FunctionalMockupUnitExport:From:Variable
  • OS:ExternalInterface:FunctionalMockupUnitExport:To:Schedule
  • OS:ExternalInterface:FunctionalMockupUnitExport:To:Actuator
  • OS:ExternalInterface:FunctionalMockupUnitExport:To:Variable

The Energy Management System (EMS) Actuator actuatedComponent method was changed to return an Optional to handle cases where the modelObject is deleted during Forward Translation without the knowledge of the actuator.

EMS Actuators can now be constructed with SpaceLoads. To use, pass a SpaceLoad object to the constructor and the Actuator will be attached to the “ThermalZone SpaceLoad” object as required by the Actuator naming convention.

The EMS Sensor constructor was changed to use the OutputVariable keyValue if it is not defaulted (since * is not a valid value for EMS)

OS:Output:Variable, OS:EnergyManagementSystem:OutputVariable, OS:ExternalInterface:Schedule, OS:ExternalInterface:Variable, OS:ExternalInterface:Actuator have received the new IDD field “Export To BCVTB” which defaults to “True”. If set to true, it will add the variable or external interface object to the variable.cfg file that is now auto-generated on E+ translation. Note: the order of the variables in the file is not guaranteed to remain the same between different translations, however it can be easily hand-edited.

The OpenStudio SDK now includes the EMPD (Effective Moisture Penetration Depth) model, a simplified approach to simulate surface moisture adsorption and desorption.

OpenStudio Server

Several new algorithms have been added to the OpenStudio Server and are available through PAT:

Existing OpenStudio Server algorithms received the following improvements:

  • Morris R2 parameter is available for using the Campolongo space filling improvement.
  • Sobol now has the following methods available for computing Sobol indices:
    • Sobol
    • Sobol2002
    • Sobol2007
    • Jansen
    • Mara
    • Martinez
  • 'random_seed' is now an algorithm level parameter and can be set for reproducibility across analyses. The default value is nil which makes repeated runs non-deterministic.
  • R is now using version 3.4.2.
  • Rserve is now using version 1.8-4.

Known Issues

DView is not currently available in Ubuntu packages. We hope to address this in the near future.

Issue Statistics Since Previous Release

  • 51 new issues were filed since the 2.3.0 release of OpenStudio (not including opened pull requests).
  • 156 issues were closed since the 2.3.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by evanweaver over 7 years ago

OpenStudio - OpenStudio v2.3.1

Consumption - Buildings and Heating - C++
Published by evanweaver over 7 years ago

OpenStudio - OpenStudio v2.3.0

OpenStudio Version 2.3.0

Release Notes – 9/30/2017

These release notes describe version 2.3.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – Windows 10, OS X 10.10 – 10.11, and 64-bit Ubuntu 14.04.

OpenStudio 2.3.0 supports EnergyPlus Release 8.8.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 2.3.0.

OpenStudio 2.3.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer have to install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio 2.3.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2017 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp.
    • If the OpenStudio Plug-in does not automatically load in SketchUp, open the Window->Preferences->Extensions window in SketchUp and enable the OpenStudio plug-in if it is listed.
  • Download and install OpenStudio. Select components for installation.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/help/troubleshooting/.

Overview

The biggest new feature in OpenStudio 2.3.0 is the integration of the OpenStudio Geometry Editor in the OpenStudio Application. The OpenStudio Geometry Editor is a new, open source software module that developers can leverage to produce building energy modeling UIs that include geometry creation. The OpenStudio Geometry Editor is meant to cover simple building geometry use cases only. More complex building geometry is best developed in a full featured CAD tool and exported to gbXML for building energy modeling. The OpenStudio Geometry Editor is implemented in JavaScript with minimal dependencies, allowing it to be integrated into a wide range of applications. The OpenStudio Geometry Editor reads and writes a custom floorplan.json JSON file format. New methods have been added to the OpenStudio SDK, which can translate this file format to OSM. Additionally, new methods have been added to the SDK, which allows two OpenStudio Models to be merged. These new methods are demonstrated by integrating the Geometry Editor directly within the OpenStudio Application. The OpenStudio Geometry Editor and integration within the OpenStudio Application are experimental, and are not recommended for production workflows. However, we invite users to try these software components out and provide feedback to help us make them better for use by third party developers. Instructions for use are at: http://nrel.github.io/OpenStudio-user-documentation/reference/geometry_editor/

EnergyPlus

Openstudio now incorporates EnergyPlus Release 8.8, which provides additional speed improvements, as well as bug fixes.

OpenStudio

Through workspace code optimization, large HVAC model creation time has been reduced by roughly 75%. An example test model which originally took 416 seconds to create, took only 101 seconds after this code improvement.

DView

For many years, OpenStudio has included ResultsViewer to visualize timeseries data. In this release, ResultsViewer is now replaced by a visualization tool called DView which was originally developed for viewing residential building and solar energy simulation data. DView brings additional capabilities that ResultsViewer does not have, including IP unit conversion, CSV data import/export, image export, EPW weather file visualization, two synchronized views, stacked timeseries, average profiles, overview statistics, histograms, cumulative density plots, duration curves, and scatter plots.

Known Issues

DView is not currently available in Ubuntu packages. We hope to address this in the near future.

PAT's algorithmic method 'RGenoud' is unstable. A software patch will be provided once a fix is in place. Please use 'PSO' until it's fixed.

Issue Statistics Since Previous Release

  • 81 new issues were filed since the 2.2.0 release of OpenStudio (not including opened pull requests).
  • 42 issues were closed since the 2.2.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by evanweaver over 7 years ago

OpenStudio - OpenStudio v2.2.2

Consumption - Buildings and Heating - C++
Published by evanweaver over 7 years ago

OpenStudio - OpenStudio v2.2.1

Consumption - Buildings and Heating - C++
Published by evanweaver over 7 years ago

OpenStudio - OpenStudio v2.2.0

These release notes describe version 2.2.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – 10, OS X 10.10 – 10.11, and 64-bit Ubuntu 14.04.

OpenStudio 2.2.0 supports EnergyPlus Release 8.7.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 2.2.0.

OpenStudio 2.2.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer have to install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio 2.2.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2017 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp.
    • If the OpenStudio Plug-in does not automatically load in SketchUp, open the Window->Preferences->Extensions window in SketchUp and enable the OpenStudio plug-in if it is listed.
  • Download and install OpenStudio.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

Overview

DView: the future ResultsViewer replacement
For many years, OpenStudio has included ResultsViewer to visualize timeseries data. The plan for the next OpenStudio release (2.3.0) is to replace ResultsViewer with a visualization tool called DView, which was originally developed for viewing Residential Building and Solar data. DView brings additional capabilities that ResultsViewer does not have, including IP unit conversion, CSV data export, image export, EPW weather file visualization, two synchronized views, stacked timeseries, average profiles, overview statistics, histograms, cumulative density plots, duration curves, and scatter plots.

DView can load EnergyPlus .sql files just like ResultsViewer. Please download DView via the links below, try it out, and send any feedback you may have.

https://github.com/NREL/wex/releases

The Hourly, Daily, and Monthly graphs allow you to turn variables on or off with a single click, and to zoom and pan very easily. DView has the ability to display simultaneous line and stacked areas as demonstrated in the Hourly graph below.
dualhourlygraph
Hourly graph

Daily and Monthly timeseries graphs are automatically created by averaging or summing the hourly data:
hourlygraph
Hourly graph

dailygraph
Daily graph

monthlygraph
Monthly graph

If the underlying data is sub-hourly, an additional Timeseries graph displays the raw data and the Hourly graph becomes the result of averaging or summing. If the underlying data is multi-hourly (for example, a 3-hour timestep), a Timeseries graph displays the raw data, there is no Hourly graph, and the Monthly graph is the result of averaging or summing the timeseries data

The Heat Map graph displays a whole year of data at once, with the day of the year on the x-axis and time of day on the y-axis, so that each time step corresponds to a small rectangle. That rectangle gets assigned a color based on the value in that time step. Using this format, it is possible to identify both diurnal and seasonal patterns. The example below shows the direct normal solar radiation in Boulder, Colorado from the TMY2 data set. The image shows that the days are longer in the summer than in the winter, the most intense direct radiation values tend to occur in the spring and fall, and summer afternoons tend to be cloudy:
heatmap
Heat map graph

The Profile graph illustrates average daily profiles for each month of the year (with the ability to also show an annual average daily profile). The graph below demonstrates daily profiles for electric cooling and gas heating in a building:
profilegraph
Profile graph

The Statistics table shows annual or monthly statistical values (e.g., mean, minimum, maximum, sum) for each variable in tabular format:
statistics
Statistics table

The PDF/CDF graph shows the Probability Distribution Function (PDF) and Cumulative Distribution Function (CDF) for the dataset. These functions are useful to illustrate the distribution and spread of values for a given variable:
pdfcdf
PDF/CDF graph

The Duration curve orders the data from highest value to lowest value. By doing so, one can quickly identify, for example, the number of hours for which the variable is above or below a certain threshold:
durationcurve
Duration curve graph

The Scatter plot allows graphing one or more y-axis variable against an x-axis variable. For example, the below graph shows a scatter plot for space heating and space cooling in a building as a function of outdoor drybulb temperature. It can also be useful to compare measured data against simulated data (for which the "line of perfect agreement" can also be displayed).
scatterplot
Scatter plot

OpenStudio Application
OpenStudio Application now provides a newly implemented 3D geometry preview tab.

OpenStudio Model
OpenStudio Model received the following updates:

  • Exposed SetpointManager:FollowGroundTemperature - Reference Ground Temperature Object Type to the OpenStudio API
  • Added UnitarySystemPerformance:Multispeed object
  • Allowed Availability Manager to be attributed to Plant Loop
  • Permitted glycols to be used in Plant Loop
  • Added GroundHeatExchanger:Vertical gFunctions

Additionally, the following objects have been wrapped:

  • GeneratorFuelCell
  • GeneratorFuelCellPowerModule
  • GeneratorFuelCellPowerModule
  • GeneratorFuelCellAirSupply
  • GeneratorFuelCellWaterSupply
  • GeneratorFuelCellAuxiliaryHeater
  • GeneratorFuelCellExhaustGasToWaterHeatExchanger
  • GeneratorFuelCellElectricalStorage
  • GeneratorFuelCellInverter
  • GeneratorFuelCellStackCooler
  • GeneratorFuelSupply

The GeneratorFuelCellExhaustGasToWaterHeatExchanger object works in the OpenStudio Application and when added to a plant loop, adds all necessary GeneratorFuelCell and related components to the model and is user-configurable in the OpenStudio Application.

OpenStudio Standards Gem
OpenStudio Standards Gem was updated 0.1.15. This added additional HVAC system types.

OpenStudio Workflow Gems (WFG)
OpenStudio Workflow Gems have been updated to 1.3.0 which offers the following refinements:

  • ScriptError subclasses, including LoadError and SyntaxError, as well as NoMemoryError are now handled by the WFG and persisted to the log
  • New method runner.haltWorkflow(completedStatus) stops the execution of additional measures and the simulation, and sets the datapoint's completion status appropriately

OpenStudio Server
OpenStudio Server’s robustness has been improved with the following updates:

  • Fixed an issue where output variables would overwrite each other if the same measure was run multiple times
  • Ensured that all results are available in the csv results list, not just those which were completed successfully
  • Changed algorithm retry procedures to ensure no infinite looping of datapoints
  • Support datapoints being halted using the runner.haltWorkflow method
  • Minor extensibility improvements
  • Ensured all deployment environments support configuration of the R queue size
  • Variable distribution plots are working again for LHS analyses

Issue Statistics Since Previous Release

  • 111 new issues were filed since the 2.1.0 release of OpenStudio (not including opened pull requests).
  • 154 issues were closed since the 2.1.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by evanweaver almost 8 years ago

OpenStudio - OpenStudio v2.1.2

Consumption - Buildings and Heating - C++
Published by evanweaver almost 8 years ago

OpenStudio - OpenStudio v2.1.1

Consumption - Buildings and Heating - C++
Published by evanweaver about 8 years ago

OpenStudio - OpenStudio v2.1.0

These release notes describe version 2.1.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – 10, OS X 10.10 – 10.11, and 64-bit Ubuntu 14.04.

OpenStudio 2.1.0 supports EnergyPlus Release 8.7.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 2.1.0.

OpenStudio 2.1.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer have to install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio 2.1.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2017 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp.
    • If the OpenStudio Plug-in does not automatically load in SketchUp, open the Window->Preferences->Extensions window in SketchUp and enable the OpenStudio plug-in if it is listed.
  • Download and install OpenStudio.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

Overview

The OpenStudio 2.x line is an aggressive overhaul of OpenStudio to make the SDK smaller and more accessible for third party software developers. The new package includes two major new components: a command line interface (CLI) and a new version of the Parametric Analysis Tool (PAT). A new component based installer gives users the choice to install only the components that they need. OpenStudio 2.1.0 is the first major release of the OpenStudio 2.x line.

The OpenStudio command line interface (CLI) allows software developers to execute a series of OpenStudio Measures and other simulation steps as described in an OpenStudio Workflow (OSW) file. The OSW defines a set of paths to search for OpenStudio Measures, initial seed model, weather file, and other supporting files. When an OSW is run through the CLI, the initial seed model is loaded and OpenStudio Model Measures are applied to the seed model. After these measures, the OpenStudio Model is translated to EnergyPlus IDF format. Once in EnergyPlus IDF format, OpenStudio EnergyPlus Measures are applied. After these measures, the EnergyPlus simulation is executed. Once the EnergyPlus simulation is complete, OpenStudio Reporting Measures are applied which generate reports. Once the workflow is completed (successfully or unsuccessfully), an output OSW file is written which contains output related to running the workflow. The OpenStudio CLI contains a Ruby interpreter, Ruby standard library, OpenStudio Ruby bindings, and a core set of gems (including the OpenStudio Standards Gem). It does not have any shared library dependencies outside of system runtime libraries. EnergyPlus and Radiance are not embedded within the CLI, they are included as part of the OpenStudio installation. There is an example OSW included in this package in the compact_osw directory under the Examples directory. This example contains everything to run a simple OpenStudio workflow from loading a seed model, applying measures, running EnergyPlus, and running reporting measures. To run this example:

cd path/to/Examples/compact_osw
./path/to/openstudio.exe run -w compact.osw

More information about the OpenStudio CLI is available at: http://nrel.github.io/OpenStudio-user-documentation/reference/command_line_interface/

A new version of the OpenStudio Parametric Analysis Tool (PAT) is part of OpenStudio 2.1.0 packages. This new version of PAT has been rewritten from the ground up as an example of JavaScript application development with OpenStudio. It has been packaged as an Electron desktop application and leverages OpenStudio Server for improved robustness, scalability, and capability. This new version of PAT provides similar functionality (and we hope improved usability) as compared to PAT 1.14.0. However, the new version of PAT is not backwards compatible with PAT 1.14.0 projects. Additionally, this new version of PAT supports “algorithmic” workflows – methods for automatically generating large sets of analysis data points. Choose from Design Of Experiments, Latin Hypercube Sampling, multiple optimization methods, and more to identify the most sensitive parameters in a model, calibrate a model against real consumption data, or optimize a model to balance multiple design objectives. Algorithmic analyses tend to be computationally intensive, so the new PAT supports simulation on Amazon Web Service or other resources provisioned with OpenStudio Server.

The Radiance functionality (Radiance Daylighting Measure) has been updated to work with OpenStudio 2.x, including the OS Application, PAT, and Server. The measure has been relocated to the Building Component Library, but its operation remains the same. The measure is also backward compatible to OpenStudio v1.14.

The Ruby and C# binding footprints have been greatly reduced in the OpenStudio 2.1.0 package. Previously, deploying the Ruby and C# bindings required deployment of many shared library and file dependencies. In OpenStudio 2.1.0, the Ruby bindings are contained in a single openstudio.so (.bundle on Mac) file and the C# bindings in an OpenStudio.dll and two supporting dll files. These are the only files required to distribute the OpenStudio 2.1.0 bindings with a third party application. Note that the openstudio.so Ruby file does not contain any gems or the Ruby standard library; these must be configured using typical Gemfile configuration for your Ruby project. Similarly, the C# bindings do not include a Ruby interpreter or OpenStudio Ruby bindings needed to apply OpenStudio Measures. If a C# project desires to run measures or simulations, it can write an OSW file and make a system call to the CLI.

OpenStudio 2.1.0 is mostly backwards compatible with OpenStudio 1.1.4. One primary difference is that PAT is not backwards compatible with PAT 1.1.4 projects. Also, upgrading a 1.1.4 version OSM to 2.1.0 will not preserve the associated run.db, any measures associated with the OSM will have to be re-added in 2.1.0. The API for OpenStudio Model and other core namespaces was mostly preserved during the OpenStudio 2.1.0 conversion. However, the RunManager, Analysis, Project, and AnalysisDriver namespaces were completely removed. The CLI and OSW format replace the functionality of RunManager. The OpenStudio Analysis (OSA) format replaces the functionality of Analysis, Project, and AnalysisDriver. The Ruleset namespace has been renamed to Measure to better reflect its functionality.

OpenStudio 2.1.0 has been updated to EnergyPlus 8.7, Ruby 2.2.4, and is compatible with SketchUp 2017. ResultsViewer is included in the 2.1.0 release.

Known Issues

This is a list of known issues, if you find an issue not on this list please let us know so we can fix it.

Installer

  • Spaces in the install path will cause PAT to fail.
  • Firewall rules are not configured at install time, user is prompted to allow http communication between OpenStudioApp and the CLI as well as between PAT and the CLI.

Measures

  • Measures written for OpenStudio 1.14.0 and earlier may not work with OpenStudio 2.0.0, measure authors are encouraged to test their measures and update them to ensure compatibility.
  • Reporting measures do not have access to offline JavaScript libraries included with the OpenStudio installation. Measure writers can include offline JavaScript libraries in the resources directory of their measure.

OpenStudioApp

  • The app may appear to freeze on return from BCL measure dialog on Mac, a workaround is to select File -> Quit and when prompted to save the Model, select cancel to abort the quit operation or press the escape key.
  • Using the file menu very quickly after launching OpenStudio may cause a crash if the OpenStudio Results measure has not been downloaded on Mac. Wait until the vertical tabs are re-enabled before using the file menus.

PAT

  • “Create One Design Alternative with Each Measure Option” duplicates options that already exist
  • Cannot enter user defined string for Measure Choice arguments
  • Display name is not shown when browsing measures
  • Measures associated with seed model are not imported

Issue Statistics Since Previous Release

  • 103 new issues were filed since the 1.14.0 release of OpenStudio (not including opened pull requests).
  • 87 issues were closed since the 1.14.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by evanweaver about 8 years ago

OpenStudio - OpenStudio v2.0.5

Consumption - Buildings and Heating - C++
Published by evanweaver about 8 years ago

OpenStudio - OpenStudio v2.0.4

Consumption - Buildings and Heating - C++
Published by evanweaver about 8 years ago

OpenStudio - OpenStudio v2.0.3

Consumption - Buildings and Heating - C++
Published by evanweaver about 8 years ago

OpenStudio - OpenStudio v2.0.2

Consumption - Buildings and Heating - C++
Published by kbenne about 8 years ago

OpenStudio - OpenStudio v2.0.1

Consumption - Buildings and Heating - C++
Published by kbenne over 8 years ago

OpenStudio - OpenStudio v1.14.0

These release notes describe version 1.14.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – 10, OS X 10.9 – 10.10, and 64-bit Ubuntu 14.04.

OpenStudio 1.14.0 supports EnergyPlus Release 8.6.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 1.14.0.

OpenStudio 1.14.0 supports Radiance 5.0.a.8, which is bundled with the OpenStudio installer. It is no longer necessary to download and install Radiance separately. However, an installer is available at https://github.com/NREL/Radiance/releases/tag/5.0.a.8. Other builds of Radiance are not supported by OpenStudio 1.14.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2016 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp. SketchUp 2016 is available in 32 and 64-bit versions; the 32-bit version of OpenStudio on Windows will only work with the 32-bit version of SketchUp 2016, and the 64-bit version of OpenStudio will only work with the 64-bit version of SketchUp 2016.
    • If the OpenStudio Plug-in does not automatically load in SketchUp, open the Window->Preferences->Extensions window in SketchUp and enable the OpenStudio plug-in if it is listed.
  • Download and install OpenStudio.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

Overview

Within EnergyPlus, advanced building controls are typically implemented utilizing the EnergyManagementSystem (EMS) suite of objects. This involves defining Sensors and Actuators that interact with building parameters through Programs which are written in the EnergyPlus Runtime Language (ERL). With the creation and larger adoption of OpenStudio Measures, the desire to simulate advanced building and grid interaction related control strategies has only increased. To facilitate those efforts, the EMS objects have been wrapped in both the forward and reverse translators. The model objects are:

• EnergyManagementSystemActuator
• EnergyManagementSystemConstructionIndexVariable
• EnergyManagementSystemCurveOrTableIndexVariable
• EnergyManagementSystemGlobalVariable
• EnergyManagementSystemInternalVariable
• EnergyManagementSystemMeteredOutputVariable
• EnergyManagementSystemOutputVariable
• EnergyManagementSystemProgram
• EnergyManagementSystemProgramCallingManager
• EnergyManagementSystemSensor
• EnergyManagementSystemSubroutine
• EnergyManagementSystemTrendVariable
• OutputEnergyManagementSystem

Currently the interface to include EMS into an OSM is strictly Measure based. Adding these Objects to the GUI in the OS Application is currently being scoped for the upcoming fiscal year, however it is funding dependent.

In the OSM file, most EMS objects will attach directly to Model objects thru their Handles or UIDs. Upon EnergyPlus translation, those UIDs are replaced with Object names. While most Objects have restricted parameters, Programs and Subroutines can either be defined line by line thru the Measure API or all at once by defining a large string block.

Also, all EMS objects reverse translate so if there are large legacy IDF models, the user can use this to at least get a start on what the new OSM would look like. One caveat is that when a referenced object exists that won’t reverse translate, OpenStudio will still translate the EMS object, but leave the referenced field blank and a warning message is thrown. The name of the object that didn’t translate is put in a comment above the EMS object so that the user can go find it in the IDF and manually figure out how to connect it up in the new OSM.

In addition to the aforementioned EMS functionality, the following OpenStudio capability was implemented:

• Added BuildingUnit class for grouping Spaces into logical units
• Updated template OpenStudio Measures to work with OpenStudio 1.x and 2.x
• Added fuel type to OtherEquipment and CoilHeatingGas
• Enforce lowercase names in runner.registerValue
• Allow display name to be set instead of value for choice arguments

OpenStudio 1.14.0 includes many bug fixes. For a full list of changes included in OpenStudio 1.14.0, please see the complete changelog.

Issue Statistics Since Previous Release

  • 22 new issues were filed since the 1.13.0 release of OpenStudio (not including opened pull requests).
  • 27 issues were closed since the 1.13.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by evanweaver over 8 years ago

OpenStudio - OpenStudio v2.0.0

OpenStudio 2.0.0 Overview

OpenStudio 2.0.0 is an aggressive overhaul of OpenStudio to make the SDK smaller and more accessible for third party software developers. The new package includes two major new components: a command line interface (CLI) and a new version of the Parametric Analysis Tool (PAT). A new component based installer gives users the choice to install only the components that they need. OpenStudio 2.0.0 is a developer release, we encourage users to try it out and let us know about any issues. However, because external users have not yet heavily tested OpenStudio 2.0.0 it is not yet recommended for production work. OpenStudio 1.14.0 remains the current stable release. In March of 2017, OpenStudio 2.1.0 release will replace OpenStudio 1.14.0 as the stable release.

The OpenStudio command line interface (CLI) allows software developers to execute a series of OpenStudio Measures and other simulation steps as described in an OpenStudio Workflow (OSW) file. The OSW defines a set of paths to search for OpenStudio Measures, initial seed model, weather file, and other supporting files. When an OSW is run through the CLI, the initial seed model is loaded and OpenStudio Model Measures are applied to the seed model. After these measures, the OpenStudio Model is translated to EnergyPlus IDF format. Once in EnergyPlus IDF format, OpenStudio EnergyPlus Measures are applied. After these measures, the EnergyPlus simulation is executed. Once the EnergyPlus simulation is complete, OpenStudio Reporting Measures are applied which generate reports. Once the workflow is completed (successfully or unsuccessfully), an output OSW file is written which contains output related to running the workflow. The OpenStudio CLI contains a Ruby interpreter, Ruby standard library, OpenStudio Ruby bindings, and a core set of gems (including the OpenStudio Standards Gem). It does not have any shared library dependencies outside of system runtime libraries. EnergyPlus and Radiance are not embedded within the CLI, they are included as part of the OpenStudio installation. There is an example OSW included in this package in the compact_osw directory under the Examples directory. This example contains everything to run a simple OpenStudio workflow from loading a seed model, applying measures, running EnergyPlus, and running reporting measures. To run this example, copy it to a user writable location and then:

cd path/to/Examples/compact_osw
./path/to/openstudio.exe run -w compact.osw

More information about the OpenStudio CLI is available at: http://nrel.github.io/OpenStudio-user-documentation/reference/command_line_interface/

A new version of the OpenStudio Parametric Analysis Tool (PAT) is part of OpenStudio 2.0.0 packages. This new version of PAT has been rewritten from the ground up as an example of JavaScript application development with OpenStudio. It has been packaged as an Electron desktop application and leverages OpenStudio Server for improved robustness, scalability, and capability. The initial version of PAT in 2.0.0 provides similar functionality (and we hope improved usability) as compared to PAT 1.14.0. Subsequent releases will add sampling and optimization capability that had previously been available via the “OpenStudio Spreadsheet.” PAT 2.0.0 is not backwards compatible with PAT 1.14.0 projects. Complete documentation for PAT 2.0.0 is underway, a getting started video is available in the meantime.

The Ruby and C# binding footprints have been greatly reduced in the OpenStudio 2.0.0 package. Previously, deploying the Ruby and C# bindings required deployment of many shared library and file dependencies. In OpenStudio 2.0, the Ruby bindings are contained in a single openstudio.so (.bundle on Mac) file and the C# bindings in an OpenStudio.dll and two supporting dll files. These are the only files required to distribute the OpenStudio 2.0.0 bindings with a third party application. Note that the openstudio.so Ruby file does not contain any gems or the Ruby standard library; these must be configured using typical Gemfile configuration for your Ruby project. Similarly, the C# bindings do not include a Ruby interpreter or OpenStudio Ruby bindings needed to apply OpenStudio Measures. If a C# project desires to run measures or simulations, it can write an OSW file and make a system call to the CLI.

OpenStudio 2.0.0 is mostly backwards compatible with OpenStudio 1.14.0. One primary difference is that PAT 2.0.0 is not backwards compatible with PAT 1.14.0 projects. Also, upgrading a 1.14.0 version OSM to 2.0.0 will not preserve the associated run.db, any measures associated with the OSM will have to be re-added in 2.0.0. The API for OpenStudio Model and other core namespaces was mostly preserved during the OpenStudio 2.0.0 conversion. However, the RunManager, Analysis, Project, and AnalysisDriver namespaces were completely removed. The CLI and OSW format replace the functionality of RunManager. The OpenStudio Analysis (OSA) format replaces the functionality of Analysis, Project, and AnalysisDriver. The Ruleset namespace has been renamed to Measure to better reflect its functionality.

Known Issues

This is a list of known issues, if you find an issue not on this list please let us know so we can fix it.

Installer

  • The 64 bit Windows installer incorrectly installs to ’ C:\Program Files (x86)\’ by default.
  • Firewall rules are not configured at install time, user is prompted to allow http communication between OpenStudioApp and the CLI as well as between PAT and the CLI.

CLI

  • The Ruby Gems library (require 'rubygems') cannot be loaded by the CLI. If you need to require Ruby Gems, you can use a system Ruby 2.0 installation and require the OpenStudio Ruby Bindings as a workaround.

Measures

  • Measures written for OpenStudio 1.14.0 and earlier may not work with OpenStudio 2.0.0, measure authors are encouraged to test their measures and update them to ensure compatibility.
  • Reporting measures do not have access to offline JavaScript libraries included with the OpenStudio installation. Measure writers can include offline JavaScript libraries in the resources directory of their measure.

SketchUp Plug-in

  • The OpenStudio SketchUp Plug-in does not yet support SketchUp 2017

OpenStudioApp

  • The apply measure now dialog does not correctly report advanced output.
  • The app may appear to freeze on return from BCL measure dialog on Mac, a workaround is to select File -> Quit and when prompted to save the Model, select cancel to abort the quit operation or press the escape key.
  • The user is not prompted to save their model before running.
  • Simulation results are deleted when saving an OSM on Mac.
  • There is a crash if user turns on output variables then switch away from and back to the output variable tab.

PAT 2.0

  • Ability to access or start remote OpenStudio Server instances is not yet available
  • Algorithmic sampling and optimization capabilities are not yet available
  • Cannot re-run a subset of the design alternatives
  • OpenStudio Measures with errors can be added to the project without warning
  • Scatter Plot report does not work
  • “Duplicate Measure & Option” button on analysis page not functioning
  • “Create One Design Alternative with Each Measure Option” duplicates options that already exist
  • Measure option descriptions are not populated with the measure description by default.
  • Cannot enter user defined string for Measure Choice arguments
  • Project paths cannot contain whitespace or be on network drives
  • Columns do not correct size to data
  • User is not prompted to replace or rename seed model if one with same name is imported
  • Help text is not implemented
  • Simulation information is not properly formatted on the run tab
  • User is not prompted with correct Save, Don't Save and Cancel options when closing project
  • Display name is not shown when browsing measures
  • Copying a measure without renaming it causes an error
  • “New Measure” button is missing from BCL dialog
  • Measures associated with seed model are not imported
  • Cannot create and run a single design alternative
  • Report name dropdown on run tab is not working correctly

Consumption - Buildings and Heating - C++
Published by evanweaver over 8 years ago

OpenStudio - OpenStudio v1.13.4

Consumption - Buildings and Heating - C++
Published by evanweaver over 8 years ago

OpenStudio - OpenStudio v1.13.3

Consumption - Buildings and Heating - C++
Published by evanweaver over 8 years ago

OpenStudio - OpenStudio v1.13.2

Consumption - Buildings and Heating - C++
Published by evanweaver over 8 years ago

OpenStudio - OpenStudio v1.13.1

Consumption - Buildings and Heating - C++
Published by evanweaver over 8 years ago

OpenStudio - OpenStudio v1.13.0

These release notes describe version 1.13.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – 10, OS X 10.9 – 10.10, and 64-bit Ubuntu 14.04.

OpenStudio 1.13.0 supports EnergyPlus Release 8.6.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 1.13.0.

OpenStudio 1.13.0 supports Radiance 5.0.a.8, which is bundled with the OpenStudio installer. It is no longer necessary to download and install Radiance separately. However, an installer is available at https://github.com/NREL/Radiance/releases/tag/5.0.a.8. Other builds of Radiance are not supported by OpenStudio 1.13.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2016 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp. SketchUp 2016 is available in 32 and 64-bit versions; the 32-bit version of OpenStudio on Windows will only work with the 32-bit version of SketchUp 2016, and the 64-bit version of OpenStudio will only work with the 64-bit version of SketchUp 2016.
    • If the OpenStudio Plug-in does not automatically load in SketchUp, open the Window->Preferences->Extensions window in SketchUp and enable the OpenStudio plug-in if it is listed.
  • Download and install OpenStudio.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

Overview

Generating code baseline models (aka Appendix G, LEED, Performance Rating Method) is a big part of an energy modeler's job because many things (LEED certification, utility incentives, etc.) are based on the difference between the proposed and baseline model. Historically, this process has been performed largely by hand, leaving room for errors in manual data entry or interpretation of the modeling requirements. These errors cause delays and cost money because, when identified, they must be corrected by the modeler. In an effort to reduce the time modelers spend on this process (and free them up for more design work), the OpenStudio team has automated this baseline model generation process via a Measure, which will be available on BCL. This Measure modifies the envelope, loads, HVAC efficiencies, controls, etc. in the proposed model to transform it into the baseline. While it may not cover all situations (specific limitations are listed when the Measure is run), it is expected to work for a large majority of projects. Because the result is an OpenStudio model, anything not covered by the Measure can be modified by hand. This Measure was funded by Xcel Energy’s Energy Design Assistance Program, and was based on previous work to create the DOE Prototype Buildings.

OpenStudio is now a Level 2 certified gbXML authoring tool, http://gbxml.org/OpenStudioCertification_Latest. A variety of enhancements and bug fixes were made to support the certification effort, see the full changelog for details.

The OS:Meter object has been renamed to OS:Output:Meter, the Meter class name remains supported in Ruby bindings but users are encouraged to move to the new name OutputMeter.

The following OpenStudio Model objects were added

  • OS:Generator:MicroTurbine
  • OS:Generator:MicroTurbine:HeatRecovery
  • OS:ElectricLoadCenter:Storage:Simple
  • OS:ElectricLoadCenter:Storage:Converter
  • OS:Meter:Custom
  • OS:Meter:CustomDecrement

GridView speed was further enhanced with the use of ConcreteModelObjects

OpenStudio 1.13.0 includes many bug fixes. For a full list of changes included in OpenStudio 1.13.0, please see the complete changelog.

Issue Statistics Since Previous Release

  • 45 new issues were filed since the 1.12.0 release of OpenStudio (not including opened pull requests).
  • 22 issues were closed since the 1.12.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by evanweaver over 8 years ago

OpenStudio - OpenStudio v1.12.6

Consumption - Buildings and Heating - C++
Published by evanweaver over 8 years ago

OpenStudio - OpenStudio v1.12.5

Consumption - Buildings and Heating - C++
Published by evanweaver over 8 years ago

OpenStudio - OpenStudio v1.12.4

Consumption - Buildings and Heating - C++
Published by evanweaver over 8 years ago

OpenStudio - OpenStudio v1.12.3

Consumption - Buildings and Heating - C++
Published by evanweaver over 8 years ago

OpenStudio - OpenStudio v1.12.2

Consumption - Buildings and Heating - C++
Published by evanweaver almost 9 years ago

OpenStudio - OpenStudio v1.12.1

Consumption - Buildings and Heating - C++
Published by evanweaver almost 9 years ago

OpenStudio - OpenStudio v1.12.0

These release notes describe version 1.12.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – 10, OS X 10.9 – 10.10, and 64-bit Ubuntu 14.04.

OpenStudio 1.12.0 supports EnergyPlus Release 8.5.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 1.12.0.

OpenStudio 1.12.0 supports Radiance 5.0.a.8, which is bundled with the OpenStudio installer. It is no longer necessary to download and install Radiance separately. However, an installer is available at https://github.com/NREL/Radiance/releases/tag/5.0.a.8. Other builds of Radiance are not supported by OpenStudio 1.12.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2016 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp. SketchUp 2016 is available in 32 and 64-bit versions; the 32-bit version of OpenStudio on Windows will only work with the 32-bit version of SketchUp 2016, and the 64-bit version of OpenStudio will only work with the 64-bit version of SketchUp 2016.
    • If the OpenStudio Plug-in does not automatically load in SketchUp, open the Window->Preferences->Extensions window in SketchUp and enable the OpenStudio plug-in if it is listed.
  • Download and install OpenStudio.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

Overview

Starting with 1.11.1, OpenStudio has included a new Ruby library called openstudio-standards. This library allows users to create the DOE Prototype Building and DOE Reference Building models in OpenStudio format. These models represent 16 different building types across all of the US climate zones for 6 vintages: pre-1980, 1980-2004, 90.1-2004, 90.1-2007, 90.1-2010, and 90.1-2013. These models can be used for tasks like portfolio-scale studies and energy code change impact analysis. These models also provide examples of how to model a wide variety of 90.1 energy code requirements in OpenStudio.

Model coverage has been expanded in OpenStudio 1.12.0, with the addition of 3 new OpenStudio model classes (SiteGroundTemperatureDeep, SiteGroundTemperatureShallow, and SiteGroundTemperatureFCfactorMethod), and the extension of the existing class ChillerElectricEIR with the addition of heat recovery.

OpenStudio 1.12.0 includes many bug fixes. For a full list of changes included in OpenStudio 1.12.0, please see the complete changelog.

Issue Statistics Since Previous Release

  • 65 new issues were filed since the 1.11.0 release of OpenStudio (not including opened pull requests).
  • 38 issues were closed since the 1.11.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by evanweaver almost 9 years ago

OpenStudio - OpenStudio v1.11.6

Consumption - Buildings and Heating - C++
Published by evanweaver almost 9 years ago

OpenStudio - OpenStudio v1.11.5

Consumption - Buildings and Heating - C++
Published by evanweaver almost 9 years ago

OpenStudio - OpenStudio v1.11.4

Consumption - Buildings and Heating - C++
Published by evanweaver almost 9 years ago

OpenStudio - OpenStudio v1.11.3

Consumption - Buildings and Heating - C++
Published by evanweaver almost 9 years ago

OpenStudio - OpenStudio v1.11.2

Consumption - Buildings and Heating - C++
Published by evanweaver almost 9 years ago

OpenStudio - OpenStudio v1.11.1

Consumption - Buildings and Heating - C++
Published by evanweaver about 9 years ago

OpenStudio - OpenStudio v1.11.0

These release notes describe version 1.11.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – 10, OS X 10.9 – 10.10, and 64-bit Ubuntu 14.04.

Users should be aware that SketchUp 2016 may longer automatically enable the OpenStudio extension after installation. To use SketchUp 2016 with OpenStudio, launch SketchUp and navigate to the dialog under Preferences->Extensions to enable OpenStudio. After making this selection, OpenStudio will appear under Extensions in the menu bar.

OpenStudio 1.11.0 supports EnergyPlus Release 8.5.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 1.11.0.

OpenStudio 1.11.0 supports Radiance 5.0.a.8, which is bundled with the OpenStudio installer. It is no longer necessary to download and install Radiance separately. However, an installer is available at https://github.com/NREL/Radiance/releases/tag/5.0.a.8. Other builds of Radiance are not supported by OpenStudio 1.11.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2016 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp. SketchUp 2016 is available in 32 and 64-bit versions; the 32-bit version of OpenStudio on Windows will only work with the 32-bit version of SketchUp 2016, and the 64-bit version of OpenStudio will only work with the 64-bit version of SketchUp 2016.
    • If the OpenStudio Plug-in does not automatically load in SketchUp, open the Window->Preferences->Extensions window in SketchUp and enable the OpenStudio plug-in if it is listed.
  • Download and install OpenStudio.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

Overview

OpenStudio 1.11.0 has a number of new features and bug fixes. Some of the more noteworthy are as follows:
• OpenStudio now supports EnergyPlus version 8.5.0
• OpenStudio now includes Radiance version 5.0.a.8
• Added support for graphical dual duct system layout in the OpenStudio Application
• Added class PointLatLon for converting geographic coordinates to building coordinates
• Added version_modified element to BCL Measure XML
• Correct parsing of ISO 8601 formatted time strings
• Radiance measure now supports multiple (unlimited) glare sensors per space
• Construction inheritance is now displayed in the space tab

OpenStudio 1.11.0 includes several other minor features as well as many bug fixes. For a full list of changes included in OpenStudio 1.11.0 please see the complete changelog.

Issue Statistics Since Previous Release

  • 93 new issues were filed since the 1.10.0 release of OpenStudio (not including opened pull requests).
  • 72 issues were closed since the 1.10.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by evanweaver about 9 years ago

OpenStudio - OpenStudio v1.10.6

Consumption - Buildings and Heating - C++
Published by axelstudios about 9 years ago

OpenStudio - OpenStudio v1.10.5

Consumption - Buildings and Heating - C++
Published by evanweaver about 9 years ago

OpenStudio - OpenStudio v1.10.4

Consumption - Buildings and Heating - C++
Published by evanweaver about 9 years ago

OpenStudio - OpenStudio v1.10.3

Consumption - Buildings and Heating - C++
Published by evanweaver about 9 years ago

OpenStudio - OpenStudio v1.10.2

Consumption - Buildings and Heating - C++
Published by evanweaver about 9 years ago

OpenStudio - OpenStudio v1.10.0

These release notes describe version 1.10.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – 10, OS X 10.9 – 10.10, and 64-bit Ubuntu 14.04.

Users should be aware that SketchUp no longer automatically enables the OpenStudio extension. To use SketchUp 2016 with OpenStudio, launch SketchUp and navigate to Preferences->Extensions to enable OpenStudio. After making this selection, OpenStudio will appear under Extensions in the menu bar.

OpenStudio 1.10.0 supports EnergyPlus Release 8.4.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. However, an installer is available at https://github.com/NREL/EnergyPlus/releases/tag/v8.4.0. Other builds of EnergyPlus 8.4 are not supported by OpenStudio 1.10.0.

OpenStudio 1.10.0 supports Radiance 5.0.a.5, which is bundled with the OpenStudio installer. It is no longer necessary to download and install Radiance separately. However, an installer is available at https://github.com/NREL/Radiance/releases/tag/5.0.a.5. Other builds of Radiance are not supported by OpenStudio 1.10.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2016 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp. SketchUp 2016 is available in 32 and 64-bit versions; the 32-bit version of OpenStudio on Windows will only work with the 32-bit version of SketchUp 2016, and the 64-bit version of OpenStudio will only work with the 64-bit version of SketchUp 2016.
    • If the OpenStudio Plug-in does not automatically load in SketchUp, open the Window->Preferences->Extensions window in SketchUp and enable the OpenStudio plug-in if it is listed.
  • Download and install OpenStudio.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

Overview

OpenStudio 1.10.0 has a number of new features and bug fixes. Some of the more noteworthy are as follows:

  • Added ElectricLoadCenterDistribution, ElectricLoadCenterInverterLookUpTable, ElectricLoadCenterInverterSimple, GeneratorPhotovoltaic, PhotovoltaicPerformanceEquivalentOneDiode, and PhotovoltaicPerformanceSimple to Model API.
  • Updated plug-in to work with SketchUp 2016. SketchUp autosave will no longer save the osm. Surfaces referencing constructions with no layers are no longer shown as air walls in the plug-in.
  • Fixed code in Date and Time classes that resulted in memory access violation crashes in Ruby bindings.
  • Changed operation of ConstructionBase.getNetArea, see documentation for details.
  • Deprecated field 'Source Zone Infiltration Treatment' from object ZoneAirMassFlowConservation, adding E+ 8.4 fields 'Infiltration Balancing Method' and 'Infiltration Balancing Zones'.
  • The Radiance Daylighting Measure has the following additions:
    • Added support for electrochromic glazing (two-state)
    • Renderings are generated for each primary daylighting control point and glare sensor found in the model
    • Added ability to optionally generate "debug" images showing each window group octree
  • Made minor enhancements to standard OpenStudio simulation results.
  • Added water to water heat pump component models, including HeatPumpWaterToWaterEquationFitCooling and HeatPumpWaterToWaterEquationFitHeating.
  • Added capability to assign DesignSpecificationOutdoorAir object directly on VAV air terminals, including AirTerminalSingleDuctVAVReheat and AirTerminalSingleDuctVAVNoReheat. This is an EnergyPlus feature that allows for more precise outdoor air control, but was previously not available in OpenStudio.
  • Refined GridView elements in the OpenStudio Application to increase their performance.
  • Extended OSGridController and SpacesLoadsGridView to show loads inherited from SpaceTypes, and more generally, inherited subrows.

OpenStudio 1.10.0 includes several other minor features as well as many bug fixes. For a full list of changes included in OpenStudio 1.10.0 please see the complete changelog.

Issue Statistics Since Previous Release

  • 67 new issues were filed since the 1.9.0 release of OpenStudio (not including opened pull requests).
  • 53 issues were closed since the 1.9.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by evanweaver over 9 years ago

OpenStudio - OpenStudio v1.10.1

Consumption - Buildings and Heating - C++
Published by evanweaver over 9 years ago

OpenStudio - OpenStudio v1.9.5

Consumption - Buildings and Heating - C++
Published by evanweaver over 9 years ago

OpenStudio - OpenStudio v1.9.0

These release notes describe version 1.9.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – 10, OS X 10.9 – 10.10, and 64-bit Ubuntu 14.04.

OpenStudio 1.9.0 supports EnergyPlus Release 8.3.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. However, an installer is available at https://github.com/NREL/EnergyPlus/releases/tag/v8.3.0. Other builds of EnergyPlus 8.3 are not supported by OpenStudio 1.9.0.

OpenStudio 1.9.0 supports Radiance 5.0.a.5, which is bundled with the OpenStudio installer. It is no longer necessary to download and install Radiance separately. However, an installer is available at https://github.com/NREL/Radiance/releases/tag/5.0.a.5. Other builds of Radiance are not supported by OpenStudio 1.9.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2015 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp. SketchUp 2015 is available in 32 and 64-bit versions; the 32-bit version of OpenStudio on Windows will only work with the 32-bit version of SketchUp 2015, and the 64-bit version of OpenStudio will only work with the 64-bit version of SketchUp 2015.
  • Download and install OpenStudio.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

Overview

OpenStudio 1.9.0 adds a substantial number of new HVAC features. Among the new features are three entirely new categories of HVAC capability beyond the routine component additions. The first new category is a family of availability managers that allow for detailed control over the air system period of operation. With these new availability managers, it is possible to have detailed control over night cycling, night ventilation, optimum morning start, temperature-based on/off and more. The second new category of HVAC capability included in this release is another family of control related inputs known as plant operation schemes. With plant operation schemes, it is possible to control the sequencing of plant system supply components relative to one another while considering ambient conditions. Third, OpenStudio has added support for dual duct air based systems. These new features are available through the OpenStudio API and Measures; user interface controls will be added in a future release. All of these features are backwards compatible, meaning users now have access to detailed control inputs, but the established OpenStudio default control remains in place. Therefore, these new features can be utilized on an as-needed basis and existing models will continue to operate in the same way. Examples and tutorials of applying these new features will be available in the weeks following the release of OpenStudio 1.9.0.

There are significant additions at the HVAC component level, including a large number of new coil types, Zone HVAC, and plant components. Of particular interest are a number of new variable speed DX coils, new zone mixing inputs, a new Zone HVAC model that accommodates natural ventilation, idealized plant components that allow a user defined constant temperature source on the supply side, and a user defined load on the demand. The full list of new input object types is included below. All of these are available in the OpenStudio API and Measures, and many of them are available in the graphical interface through drag and drop.

• ZoneCrossMixing • ZoneMixing • SolarCollectorPerformanceFlatPlate • SolarCollectorFlatPlateWater • SolarCollectorIntegralCollectorStorage • SolarCollectorPerformanceIntegralCollectorStorage • SolarCollectorFlatPlatePhotovoltaicThermal • ZoneVentilationDesignFlowRate • FluidCoolerTwoSpeed • FluidCoolerSingleSpeed • PipeOutdoor • PipeIndoor • Duct• AvailabilityManagerHybridVentilation • CoilSystemCoolingWaterHeatExchangerAssisted • CoilSystemCoolingDXHeatExchangerAssisted • PlantEquipmentOperationOutdoorDewpoint • PlantEquipmentOperationOutdoorWetBulb • TemperingValve • ChillerAbsorption • ChillerAbsorptionIndirect • CoilCoolingDXTwoStageWithHumidityControlMode • AirTerminalDualDuctVAV • AvailabilityManagerOptimumStart • AvailabilityManagerDifferentialThermostat • ThermalStorageIceDetailed • GroundHeatExchangerHorizontalTrench • PlantEquipmentOperationOutdoorRelativeHumidity • AvailabilityManagerNightVentilation • PlantEquipmentOperationOutdoorDryBulbDifference • PlantEquipmentOperationOutdoorDewpointDifference • PlantEquipmentOperationOutdoorWetBulbDifference • PlantEquipmentOperationOutdoorDryBulb • HeaderedPumpsConstantSpeed • HeaderedPumpsVariableSpeed • WaterHeaterHeatPump • CoilPerformanceDXCooling • CoilWaterHeatingAirToWaterHeatPump • CoilHeatingWaterToAirHeatPumpVariableSpeedEquationFit • CoilHeatingDXVariableSpeed • CoilCoolingWaterToAirHeatPumpVariableSpeedEquationFit • SetpointManagerSingleZoneHumidityMaximum • ThermalStorageChilledWaterStratified • SetpointManagerColdest • EvaporativeFluidCoolerTwoSpeed • SetpointManagerMultiZoneCoolingAverage • SetpointManagerMultiZoneHeatingAverage • ZoneHVACDehumidifierDX • ZoneHVACEnergyRecoveryVentilatorController • ZoneHVACEnergyRecoveryVentilator • CoilCoolingDXVariableSpeed • CentralHeatPumpSystem • SetpointManagerMultiZoneHumidityMaximum • CoilHeatingDXMultiSpeed • SetpointManagerFollowSystemNodeTemperature • SetpointManagerSingleZoneOneStageCooling • SetpointManagerSingleZoneOneStageHeating • SetpointManagerMultiZoneMaximumHumidityAverage • SetpointManagerMultiZoneMinimumHumidityAverage • SetpointManagerReturnAirBypassFlow • SetpointManagerFollowGroundTemperature • ChillerHeaterPerformanceElectricEIR • PlantComponentTemperatureSource • ZoneHVACUnitVentilator • WaterHeaterStratified • ZoneHVACBaseboardRadiantConvectiveWater • ZoneHVACBaseboardRadiantConvectiveElectric • LoadProfilePlant

There are a number of enhancements in areas beyond HVAC capability particularly to the OpenStudio application and the Measure ecosystem:

  • The OpenStudio application has been enhanced with new grid views for the design day and facility interfaces
  • Users can now specify costs and ECMs on external models imported to PAT for export to EDAPT
  • A new standard reporting Measure has been added
  • Radiance functionality has been refactored as a Measure. As a result, the “select daylight simulation engine” radio buttons have been removed from the Run Tab. Users wishing to use Radiance for their daylight simulations must apply the “Radiance Daylighting Measure” from their measures library (under Electric Lighting -> Electric Lighting Controls -> Radiance Daylighting Measure) as an “Always Run Measure.” Support for shadecloth (e.g. Mechoshade) and daylight redirecting louvers (exemplified in this release with Lightlouver) have been added to the shade material types, along with the existing venetian blind option. Daylight metrics reporting has been improved, and a fully automated 3-phase simulation workflow that supports multiple window groups is part of this new measure. By implementing the Radiance daylighting functionality in a measure users can run Radiance-based daylighting simulations with PAT if run on the local system. The Radiance Measure is not currently supported with PAT on the cloud or with the OpenStudio-server/spreadsheet tools.
  • OpenStudio ships with select gems (https://github.com/NREL/OpenStudio/wiki/OpenStudio-Version-Compatibility-Matrix#packaged-gems)
  • Improvements have been made to EpwFile allow direct access to timeseries properties from the weather file
  • IFC import improvements were contributed by the BIMDataHub team at Penn State/CBEI
  • This release resolves a long-standing issue using OpenStudio with Honeybee: https://github.com/mostaphaRoudsari/Honeybee/issues/214.

OpenStudio 1.9.0 includes several other minor features as well as many bug fixes. For a full list of changes included in OpenStudio 1.9.0 please see the complete changelog.

Issue Statistics Since Previous Release

  • 119 new issues were filed since the 1.8.0 release of OpenStudio (not including opened pull requests).
  • 118 issues were closed since the 1.8.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by axelstudios over 9 years ago

OpenStudio - OpenStudio v1.9.4

Consumption - Buildings and Heating - C++
Published by evanweaver over 9 years ago

OpenStudio - OpenStudio v1.9.3

Consumption - Buildings and Heating - C++
Published by evanweaver over 9 years ago

OpenStudio - OpenStudio v1.9.2

Consumption - Buildings and Heating - C++
Published by evanweaver over 9 years ago

OpenStudio - OpenStudio v1.9.1

Consumption - Buildings and Heating - C++
Published by evanweaver over 9 years ago

OpenStudio - OpenStudio v1.8.5

Consumption - Buildings and Heating - C++
Published by evanweaver over 9 years ago

OpenStudio - OpenStudio v1.8.4

Consumption - Buildings and Heating - C++
Published by evanweaver over 9 years ago

OpenStudio - OpenStudio v1.8.3

Consumption - Buildings and Heating - C++
Published by evanweaver over 9 years ago

OpenStudio - OpenStudio v1.8.2

Consumption - Buildings and Heating - C++
Published by axelstudios almost 10 years ago

OpenStudio - OpenStudio v1.8.1

Consumption - Buildings and Heating - C++
Published by axelstudios almost 10 years ago

OpenStudio - OpenStudio v1.8.0

These release notes describe version 1.8.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – 8.1, OS X 10.9 – 10.10, and 64-bit Ubuntu 14.04.

OpenStudio 1.8.0 supports EnergyPlus Release 8.3.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. However, an installer is available at https://github.com/NREL/EnergyPlus/releases/tag/v8.3.0. Other builds of EnergyPlus 8.3 are not supported by OpenStudio 1.8.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2015 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp. SketchUp 2015 is available in 32 and 64-bit versions; the 32-bit version of OpenStudio on Windows will only work with the 32-bit version of SketchUp 2015, and the 64-bit version of OpenStudio will only work with the 64-bit version of SketchUp 2015.
  • Download and install OpenStudio.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

Optional Installation Steps

  • For Radiance integration, download and install Radiance.

Overview

The most significant new feature in OpenStudio 1.8.0 is the addition of many new HVAC objects to the OpenStudio Model. The new types available in 1.8.0 include HeaderedPumpsConstantSpeed, HeaderedPumpsVariableSpeed, TemperingValve, CoilPerformanceDXCooling, CoilCoolingDXTwoStageWithHumidityControlMode, CoilSystemCoolingWaterHeatExchangerAssisted, CoilSystemCoolingWaterHeatExchangerAssisted, GroundHeatExchangerHorizontalTrench, ThermalStorageIceDetailed, ChillerAbsorptionIndirect, ChillerAbsorption. These new types are available through the OpenStudio API for use in measures as well as in the OpenStudio Application. Advanced tutorials on how to use each of these new objects may be available in the future.

Additionally, the ability to import IFC into OpenStudio via BIMserver has been added by the CBEI group from Penn State University. A tutorial on how to use this new functionality is available at http://nrel.github.io/OpenStudio-user-documentation/tutorials/tutorial_ifcimport/.

OpenStudio 1.8.0 includes several other minor features as well as many bug fixes. For a full list of changes included in OpenStudio 1.8.0 please see the complete changelog.

Bug Analytics Since Previous Release

  • 108 new issues were filed since the 1.7.0 release of OpenStudio (not including opened pull requests).
  • 53 issues were closed since the 1.7.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by axelstudios almost 10 years ago

OpenStudio - OpenStudio v1.7.5

Consumption - Buildings and Heating - C++
Published by axelstudios almost 10 years ago

OpenStudio - OpenStudio v1.7.4

Consumption - Buildings and Heating - C++
Published by axelstudios almost 10 years ago

OpenStudio - OpenStudio v1.7.3

Consumption - Buildings and Heating - C++
Published by axelstudios almost 10 years ago

OpenStudio - OpenStudio v1.7.2

Consumption - Buildings and Heating - C++
Published by axelstudios about 10 years ago

OpenStudio - OpenStudio v1.7.1

Consumption - Buildings and Heating - C++
Published by axelstudios about 10 years ago

OpenStudio - OpenStudio v1.7.0

These release notes describe version 1.7.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:

  • Where to Find OpenStudio Documentation
  • Installation Notes
  • Overview

Where to Find OpenStudio Documentation

Installation Notes

OpenStudio is supported on Windows 7 – 8.1, OS X 10.9 – 10.10, and 64-bit Ubuntu 14.04.

OpenStudio 1.7.0 supports EnergyPlus Release 8.2.0 Update 1, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately, however an installer is available at https://github.com/NREL/EnergyPlus/releases/tag/v8.2.0-Update-1.2. Other builds of EnergyPlus 8.2 are not supported by OpenStudio 1.7.0.

Installation Steps

  • The OpenStudio SketchUp Plug-in requires SketchUp 2015 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp. SketchUp 2015 is available in 32 and 64-bit versions; the 32-bit version of OpenStudio on Windows will only work with the 32-bit version of SketchUp 2015, and the 64-bit version of OpenStudio will only work with the 64-bit version of SketchUp 2015.
  • Download and install OpenStudio.
  • Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.

Optional Installation Steps

  • For Radiance integration, download and install Radiance.

Overview

The biggest new feature in OpenStudio 1.7.0 is the addition of multi-edit capability to grid views in the OpenStudio Application. Implemented for the Thermal Zone and Space Type tabs, this new feature allows users to change properties of several objects at once. More grid views will be applied throughout the remainder of the OpenStudio Application in coming releases. A video tutorial for this new feature is available at https://youtu.be/LnOUfiMajD0.

OpenStudio now supports Radiance 3-phase simulation of dynamic window shading controls. Currently, shading devices are simulated only as venetian blinds, using pre-defined BSDFs hosted on the BCL. Blind operation is automated, with the blinds retracted by default, and covering the window when the illuminance on the shade-controlled window(s) exceeds 2,000 lux. Support for user-defined BSDFs and alternative shade control algorithms will be added in a future release. Documentation for this new feature is available on the OpenStudio website.

The OS:WindowFrameAndDivider object was added to allow import of detailed Window properties from the LBNL WINDOW program. Currently only spectral average data from WINDOW is supported for import into OpenStudio. Wall thickness around windows can be represented in daylighting models using the window reveal and sill dimensions specified in the OS:WindowFrameAndDivider. These dimensions are translated to both EnergyPlus and Radiance. Note: window frame geometry is not currently translated to Radiance, this will be added in a future release. Documentation for this new feature is available on the OpenStudio website.

OpenStudio 1.7.0 includes several other minor features as well as many bug fixes. For a full list of changes included in OpenStudio 1.7.0 please see the complete changelog.

Bug Analytics Since Previous Release

  • 168 new issues were filed since the 1.6.0 release of OpenStudio (not including opened pull requests).
  • 266 issues were closed since the 1.6.0 release of OpenStudio (not including closed pull requests).

Consumption - Buildings and Heating - C++
Published by axelstudios about 10 years ago

OpenStudio - OpenStudio v1.6.3

Consumption - Buildings and Heating - C++
Published by axelstudios about 10 years ago

OpenStudio - OpenStudio v1.6.2

Consumption - Buildings and Heating - C++
Published by axelstudios about 10 years ago

OpenStudio - OpenStudio v1.6.1

Consumption - Buildings and Heating - C++
Published by axelstudios about 10 years ago