OpenStudio v2.0.1

Add 2.0.0 IDD

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

• OpenStudio release documentation, including these release notes, tutorials, and other user documentation, is available at https://www.openstudio.net/.
• C++ API documentation is available at https://openstudio-sdk-documentation.s3.amazonaws.com/index.html.
• Measure development documentation is available at http://nrel.github.io/OpenStudio-user-documentation/reference/measure_writing_guide/.

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).

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

OpenStudio v1.13.4

Merge branch 'develop' of https://github.com/NREL/OpenStudio into dev…

OpenStudio v1.13.3

Merge pull request #2386 from NREL/update_standards_gem

Updates openstudio-standards to 0.1.8 to fix issue hit during PSD tra…

OpenStudio v1.13.2

Merge pull request #2386 from NREL/update_standards_gem

Updates openstudio-standards to 0.1.8 to fix issue hit during PSD tra…

OpenStudio v1.13.1

Merge pull request #2378 from NREL/update_standards_gem

Updates openstudio-standards to 0.1.7

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

• OpenStudio release documentation, including these release notes, tutorials, and other user documentation, is available at https://www.openstudio.net/.
• C++ API documentation is available at https://openstudio-sdk-documentation.s3.amazonaws.com/index.html.
• Measure development documentation is available at http://nrel.github.io/OpenStudio-user-documentation/reference/measure_writing_guide/.

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).

OpenStudio v1.12.6

Merge pull request #2355 from NREL/update_standards_gem

Updates openstudio-standards gem to 0.1.5, which supports baseline au…

OpenStudio v1.12.5

Update ENERGYPLUS_EXPECTED_HASH for Win32 and UNIX, throw error for R…