Openstudio

Latest version: v3.9.0

Safety actively analyzes 723625 Python packages for vulnerabilities to keep your Python projects secure.

Scan your dependencies

Page 18 of 25

1.7.1

1.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
- 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/measures/measure_writing_guide/.

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](http://www.sketchup.com/) (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](https://www.openstudio.net/downloads).
- 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](http://nrel.github.io/OpenStudio-user-documentation/getting_started/getting_started/).

Optional Installation Steps
- For Radiance integration, download and install [Radiance](http://nrel.github.io/OpenStudio-user-documentation/getting_started/getting_started/).

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](https://github.com/NREL/OpenStudio/blob/v1.7.0/CHANGELOG.md).

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

1.6.3

1.6.2

1.6.1

1.6.0

- No changes.
- Java bindings are not packaged with OpenStudio. To use them see our
[developer page](https://openstudio.nrel.gov/developers) for
guidance on building OpenStudio.

OpenStudio RunManager
- The RunManager application has been deprecated in favor of the
OpenStudio and ParametricAnalysisTool applications. The RunManager
library will remain available.

Bug Fixes
- The OpenStudio SketchUp plug-in handled orphan objects
inconsistently, now these are simply not drawn. [issue
[1224](https://github.com/NREL/OpenStudio/issues/1224)]
- SaveAs in SketchUp plugin corrupts measures in model. [issue
[754](https://github.com/NREL/OpenStudio/issues/754)]
- Cloud functionality fails on reporting measures. [issue
[824](https://github.com/NREL/OpenStudio/issues/824)]
- BCL measure may look like they are broken even though they work.
[issue [1254](https://github.com/NREL/OpenStudio/issues/1254)]
- Copy measure does not work. [issue
[1274](https://github.com/NREL/OpenStudio/issues/1274)]
- Cannot use Material Roof Vegetation in Construction. [issue
[1317](https://github.com/NREL/OpenStudio/issues/1317)]
- PIU fans do not night cycle properly. [issue
[1343](https://github.com/NREL/OpenStudio/issues/1343)]
- OA Controller will not schedule off. [issue
[1344](https://github.com/NREL/OpenStudio/issues/1344)]

Known Issues

The following are issues known at the time of publication of these
release notes. Please contact openstudionrel.gov if you require
further assistance.

Known Issues Common to All Platforms

OpenStudio SketchUp Plug-In
- If you use copy multiple on group-level OpenStudio objects, you will
get one extra copy. The extra group is created by the first
copy-and-paste operation and is not removed when the copy multiple
occurs. To address this, after you perform a copy multiple procedure
on groups or spaces, press delete. The objects you need to delete
should already be selected. If you are copying loose surfaces such
as windows, there are no problems, as SketchUp will merge equivalent
surfaces. [issue
[28](https://github.com/NREL/OpenStudio/issues/28)]
- Using SketchUp’s undo operation on OpenStudio model elements may
produce unexpected results. [issues
[54](https://github.com/NREL/OpenStudio/issues/54) and
[150](https://github.com/NREL/OpenStudio/issues/150)]
- SKP and OSM link is not maintained when files are relocated.
However, you can manually re-establish that link. When opening a
SketchUp file, launch SketchUp and then open the SketchUp file. If
that doesn’t work you can also directly load the OSM file, bypassing
the SKP file. [issue
[409](https://github.com/NREL/OpenStudio/issues/409)]
- It is possible for the OpenStudio plug-in to conflict with other
SketchUp plug-ins. If you suspect this is a problem, try testing
with other plug-ins disabled, or contact openstudionrel.gov for
assistance. [issue
[26](https://github.com/NREL/OpenStudio/issues/26)]
- Using “Intersect” in the surface matching dialog can result in a
crash or unexpected results. This is more common with models that
were imported from other CAD formats at some point in the workflow.
It is a good idea to save prior to using this to avoid any loss of
data. This is related to an underlying SketchUp bug. [issue
[168](https://github.com/NREL/OpenStudio/issues/168)]
- “Project Loose Geometry” can crash SketchUp. It is a good idea to
save prior to using this to avoid any loss of data. [issue
[484](https://github.com/NREL/OpenStudio/issues/484)]
- Adjacent stacked spaces in same zones may result in incorrect area
and likely loads as well. [issue
[561](https://github.com/NREL/OpenStudio/issues/561)]
- Using AutoSave in SketchUp can overwrite changes made in OS app if
the file is open in both locations. [issue
[899](https://github.com/NREL/OpenStudio/issues/899)]

If your OpenStudio model causes a crash of SketchUp or has unexpected
behavior, please forward it to openstudionrel.gov with a detailed
description of the problem along with the steps that produced the issue.
Please also include the directory that has the same name as the OSM
file. You can attach it as a zip file.

OpenStudio Application
- EnergyPlus 8.2 no longer provides simulation output to standard
output during simulation. [issue [1359](https://github.com/NREL/OpenStudio/issues/1359)]
- Similar thermostats assigned in the SketchUp Plug-in are shared
across thermal zones in the OpenStudio application. Changing or
turning off one will do the same to others. [issue
[123](https://github.com/NREL/OpenStudio/issues/123)]
- The view does not always refresh correctly when you delete a
material from a construction. If you still see a material after
clicking the “x”, switch away from and back to the object to refresh
the view. [issue
[196](https://github.com/NREL/OpenStudio/issues/196)]
- OS App Schedule Editor allows entering values outside of type
limits. [issue
[531](https://github.com/NREL/OpenStudio/issues/531)]
- All drop zones under Water Use Equipment Definitions doesn't enforce
schedule types. [issue
[532](https://github.com/NREL/OpenStudio/issues/532)]
- Some HVAC components in OpenStudio are missing from the HVAC Library
(e.g. Fan:OnOff). [issue
[599](https://github.com/NREL/OpenStudio/issues/599)]
- Several objects in OpenStudio appear to accept erroneous input
values, but seems like it is just displaying the erroneous value and
not storing it. [issue
[656](https://github.com/NREL/OpenStudio/issues/656)]
- Attempting to autosize a WaterHeater will result in an error. [issue
[669](https://github.com/NREL/OpenStudio/issues/669)]
- Entering an invalid date on the Utility Bills subtab crashes
OpenStudio. [issue
[739](https://github.com/NREL/OpenStudio/issues/739)]
- To enable set point schedule drop zones on the Thermal Zones tab,
you need to first turn on the thermostat.
- The Site / Utility Rates subtab in the workflow is marked as “coming
soon,” and will be completed in an upcoming release of OpenStudio.
- The default reporting measures used for the results tab show results
in IP units, and do not react to changes in the user’s unit
preferences. That will be addressed in future versions of
OpenStudio. The measure can be altered to show SI units instead.
- It is not possible to choose or define a refrigeration case (or
walkin) re-stocking schedule in the “Grid” view or the “Layout”
view; the drop down list is blank. [issue
[966](https://github.com/NREL/OpenStudio/issues/966)]
- Report web views may load slower than they use to with the update to
Qt5. [issue
[1211](https://github.com/NREL/OpenStudio/issues/1211)]
- With larger models, GridView’s performance may slow. Performance
improvements are currently being implemented and will be available
soon in a minor release.

OpenStudio ParametricAnalysisTool
- NOTE: when using cloud service, please make sure to stop the cloud
using the cloud button in PAT when your simulation session is done,
and after you have downloaded all of the detailed results you want.
You are also strongly encouraged to go to the AWS Management Console
to confirm that all instances are terminated. If they are not
terminated, you will need to manually terminate them from the
console. Refer to the [OpenStudio
documentation](running-on-the-cloud) for details about running
simulations on the cloud.
- EnergyPlus 8.2 no longer provides simulation output to standard
output during simulation. [issue [1359](https://github.com/NREL/OpenStudio/issues/1359)]
- Daylighting control object variables can’t be requested in the
output variables tab. [issue
[355](https://github.com/NREL/OpenStudio/issues/355)]
- Adding a design alternative using measure groups will remove any
design alternatives made from external files. However, you can add a
design alternative made from external files without losing design
alternatives made from measure groups. [issue
[369](https://github.com/NREL/OpenStudio/issues/369)]
- Always Run measures are applied to externally constructed design
alternatives. This may result in unexpected results or errors.
[issue [369](https://github.com/NREL/OpenStudio/issues/369)]
- Windows users may experience problems when starting cloud resources
through PAT due to a bug in net-ssh,
https://github.com/net-ssh/net-ssh/issues/180.  If the user has
the pageant.exe program running, killing that program through the
task manager may resolve the issue.

OpenStudio ResultsViewer
- Alias changes do not update in table view until the data are read in
again. [issue [25](https://github.com/NREL/OpenStudio/issues/25)]
- Re-arranged column order doesn't stick on next launch. [issue
[30](https://github.com/NREL/OpenStudio/issues/30)]

OpenStudio RunManager
- EnergyPlus ForwardTranslator errors do not appear in the RunManager
GUI elements. [issue
[181](https://github.com/NREL/OpenStudio/issues/181)]

OpenStudio Platform, Including SWIG Bindings
- IdfObject::getQuantity and IdfObject::setQuantity functionality is
not comprehensive. The quantity getters and setters for fields whose
units are “BasedOnField AX” are not expected to work at the
IdfObject level, but are to be handled only for OS: prefixed objects
by the specific interfaces of classes derived from ModelObject.
- The default naming scheme of WorkspaceObject (base class for
ModelObject, etc.) sometimes results in undesired name clashes when
transferring objects between models, including in the EnergyPlus
translators. Therefore, some objects may be unexpectedly renamed or
copied.
- OpenStudio::Model::ComponentVector objects may be inaccessible from
the Ruby bindings. [issue
[239](https://github.com/NREL/OpenStudio/issues/239)]
- If schedule type limits fields are not set properly, OS will not
give error but also will not hook up affected schedules. [issue
[967](https://github.com/NREL/OpenStudio/issues/967)]
- There is no default construction for adiabatic surfaces. [issue
[974](https://github.com/NREL/OpenStudio/issues/974)]
- Cloning a building disconnects spaces from thermal zones. [issue
[980](https://github.com/NREL/OpenStudio/issues/980)]
- The simulation fails if ground preprocessor boundary conditions are
used. [issue
[1127](https://github.com/NREL/OpenStudio/issues/1127)]

Known Issues Specific to OS X
- The SketchUp Plug-in toolbar tooltips do not work correctly on OS X
if you have made your toolbars horizontal. The tooltips never show
on OS X in the status bar. The button state may also be incorrect.
This is a bug in SketchUp versus the plug-in. [issue
[45](https://github.com/NREL/OpenStudio/issues/45)]

Issue Statistics Since Previous Release
- 66 new issues were filed since the 1.5.0 release of OpenStudio (not
including opened pull requests).
- 56 issues were closed since the 1.5.0 release of OpenStudio (not
including closed pull requests).

Page 18 of 25

© 2025 Safety CLI Cybersecurity Inc. All Rights Reserved.