Openstudio

Latest version: v3.9.0

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

Scan your dependencies

Page 24 of 25

1.0.3

1.0.2

1.0.1

1.0.0

- Added experimental bindings.

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. [bug 36]
- Using SketchUp's undo operation on OpenStudio model elements may produce unexpected results. [bugs 438 and 797]
- SKP and OSM link is not maintained when files are relocated. 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. [bug 61]
- 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. [bug 24]
- Importing Constructions and Import Schedules from the OpenStudio SketchUp Plug-in are broken, but you can load an OSM file as library in the OpenStudio application and then selectively drag specific objects into your model. [bug 930]
- Using "Intersect" in the surface matching dialog can result in a crash or unexpected result. 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. [bugs 856 and 1220]
- "Project Loose Geometry" can crash SketchUp. It is a good idea to save prior to using this to avoid any loss of data. [bug 1221]
- If your OpenStudio model crashes SketchUp or has unexpected behavior please forward it to OpenStudioNREL.gov with a description of the problem. Please also include the directory that has the same name as the OSM file. You can attach it as a zip file. [bug 1231]

OpenStudio Application
- The Site / Utility Rates subtab the workflow are marked as "coming soon," and will be completed in an upcoming release of OpenStudio.
- To enable set point schedule drop zones on the Thermal Zones tab, you need to first turn on the thermostat.
- Using the mouse scroll wheel while hovering over graphics in the Results Summary tab will unintentially zoom them in and out. [bug 574]
- 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. [bug 722]
- 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. [bug 925]
- Not all of the schedules required to make a valid People object can be assigned in the application. [bug 664]
- The 3-phase daylighting simulation method is currently inoperable due to a fundamental change in the way the lighting calculation points are passed to Radiance, and will be updated in an upcoming release of OpenStudio. [bug 943]

OpenStudio ParametricAnalysisTool
- PAT won't prevent you from loading OSM files that are from a newer version of OpenStudio than you have installed, but the analysis won't run. [bug 1240]
- Daylighting control object variables can't be requested in the output variables tab. [bug 1290]
- The results tab may not be legible on a 1024x768 screen. [bug 1295]
- Adding a design alternative using measure groups will remove any design alternatives made from external files. You can however add a design alternative made from external files without losing design alternatives made from measure groups. [bug 1236]
- Always Run measures are applied to externally constructed design alternatives. This may result in unexpected results or errors.
- Measures specified within externally constructed design alternative models are not applied.

OpenStudio ResultsViewer
- Alias changes do not update in table view until the data are read in again. [bug 7]
- Data sets are expected to start on January 1 or later, and end on December 12 or earlier. Run periods cannot wrap around the end or beginning of the year. [bug 78]
- Table view column rearrangements are not preserved. [bug 34]

OpenStudio RunManager
- EnergyPlus ForwardTranslator errors do not appear in the RunManager GUI elements. [bug 897]

OpenStudio Platform, Including SWIG Bindings
- IdfObject::getQuantity and IdfObject::setQuantity functionality is almost, but not completely, 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. [bug 1005]

Known Issues Specific to OS X
- To Install OpenStudio 1.0 correctly on OS X you need to first uninstall earlier versions of OpenStudio. [bug 1303]
- At this time, we are unable to provide simple installation instructions for DAKOTA on OS X. We are working with the DAKOTA team to be able to provide this sometime in 2013. [bug 437]
- 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. [bug 375]

Bug Analytics Since Previous Release
- 89 new bugs were filed since the 0.9.0 release of OpenStudio.
- 51 bugs were closed since the 0.9.0 release of OpenStudio.

1.0.0pre1

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

**Note** that [PAT](https://github.com/NREL/OpenStudio-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](https://github.com/NREL/OpenStudio-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,](https://github.com/NREL/EnergyPlus/releases/tag/v9.2.0) 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/](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](https://www.openstudio.net/new-future-for-openstudio-application). Please send any questions, comments, or concerns to [OpenStudionrel.gov](mailto:OpenStudionrel.gov) 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.

0.4.0

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

Page 24 of 25

© 2025 Safety CLI Cybersecurity Inc. All Rights Reserved.