This page is a collection of troubleshooting advice that helps users deal with common issues.
OpenStudio SketchUp Plug-in Does Not Load
For the OpenStudio Application 1.0.0, ensure that your are working with SketchUp Pro 2019. Try opening the "Window->Preferences->Extensions" window in SketchUp, enable the OpenStudio SketchUp Plug-in if it is listed. If the OpenStudio SketchUp Plug-in is not listed you may have to manually install it (this is the case if you are using a different version of SketchUp than the OpenStudio Installer targets).
To install the OpenStudio SketchUp Plug-in manually on Windows please copy the files in:
where %YOURUSERNAME% is replaced by your user name and %VERSION% is the version of the software you are using.
To install the OpenStudio SketchUp Plug-in manually on macOS please copy the files in:
~/Library/Application Support/SketchUp %VERSION%/SketchUp/Plugins/
where %VERSION% is the version of the software you are using.
Model Will Not Open in OpenStudio SketchUp Plug-in
If you have an OpenStudio Model file (0SM file) that will not open, or opens incorrectly in the SketchUp Plug-in, then running the "OSM Diagnostic Script" can help identify the problem objects and create a new diagnostic copy of your file. This script creates a report identifying problem objects, and saves a new copy of your file leaving the original untouched. To run the script, go to the "Extensions->OpenStudio User Scripts->Reports" menu and choose "OSM Diagnostic Script".
SketchUp Crashes on Launch
The first thing to do is to remove SketchUp and install it again. To do this, run the SketchUp uninstaller. Also check that all OpenStudio Plug-ins are removed from the SketchUp plugin directories. On Windows these directories are:
- C:\Users\%YOURUSERNAME%\AppData\Roaming\SketchUp\SketchUp %VERSION%\SketchUp\Plugins
- C:\ProgramData\SketchUp\SketchUp %VERSION%\SketchUp\Plugins
- C:\Program Files\SketchUp\SketchUp %VERSION%\SketchUp\Plugins
On Mac these are:
- ~/Library/Application Support/SketchUp %VERSION%/SketchUp/Plugins/
- /Library/Application Support/SketchUp %VERSION%/SketchUp/Plugins
If SketchUp crashes without the OpenStudio SketchUp Plug-in installed then something else is wrong, contact the SketchUp support team for help. Check that your system meets the SketchUp Hardware and Software Requirements. If SketchUp launches, try installing OpenStudio Plugin again. If SketchUp crashes on launch again, remove the OpenStudio Plugin files from the SketchUp plugin directories again. Open SketchUp, go to "Window->Preferences->Extensions" and disable the OpenStudio SketchUp Plug-in. Re-install OpenStudio Plugin and relaunch SketchUp. Open the Ruby console by going to "Window->Ruby Console" and then go back to "Window->Preferences->Extensions" and enable the OpenStudio SketchUp Plug-in, you may see useful output in the Ruby console. If you have other extensions installed, try disabling them and enabling the OpenStudio SketchUp Plug-in.
If none of the steps above work and you are on Windows, it is likely that there is a dynamic library being loaded from another application that is interfering with the OpenStudio Application. If you just want to fix your problem, try copying the files libeay32.dll and ssleay32.dll from
C:\Program Files \SketchUp\SketchUp %VERSION%, this will fix the problem 80% of the time.
If you want to investigate in more depth, download Dependency Walker. Extract the files and launch depends.exe. Navigate to "File->Open" and then browse to choose the SketchUp.exe under
C:\Program Files \SketchUp\SketchUp %VERSION%. This will examine all of the libraries loaded by SketchUp but not the libraries loaded by the OpenStudio Plugin. Navigate to "Profile->Start Profiling" then press Ok in the dialog that pops up. This will launch SketchUp and attempt to load the OpenStudio Plugin. Scroll down in the list of loaded libraries and look for the OpenStudio dlls. Expand the paths under the OpenStudio dlls and look for libraries that are being loaded from other locations. Often, some other program will install a different version of one of the libraries (usually libeay32.dll or ssleay32.dll) that OpenStudio uses. This other library will be in the path ahead of OpenStudio and will be loaded instead, this results in a hard crash of SketchUp. Correcting your path or copying the dlls from the OpenStudio bin directory into the SketchUp install directory will cause the correct dlls to be loaded when SketchUp starts.
OpenStudio Application and SketchUp Plug-in Crash
Several users have reported an OpenStudio Application and OpenStudio SketchUp Plug-in crash occurring when saving or opening a file is related to the Dell Backup and Recovery software. It appears that this program is known to cause issues with Qt based applications (such as OpenStudio).
Graphics Problems in OpenStudio Application
Several users have reported graphics issues with the Geometry and Results Summary tabs within the OpenStudio Application. In many cases, adjusting power saving settings of the graphics cards has resolved these issues. For computers with NVIDA graphics cards, you can access these settings via the NVIDIA Control Panel under "3D Settings->Manage 3D Settings". In this panel, make sure that "Preferred graphics processor" is set to "High-performance NVIDIA processor".
Additionally, you may be able to find more information by running the OpenStudio Application from a command prompt and capturing the standard output in a file:
set OPENSTUDIO_APPLICATION_DEBUG=1 C:\openstudio-%VERSION%\bin\OpenStudioApp.exe > out.txt 2>&1
Orphan Objects and Unused Resources
At times OpenStudio objects that should have a parent, such as surfaces and internal load instances, may become detached from their parent. Possibly the parent is deleted but for some reason the child is not. These often are not visible in the GUI, and while it is possible to fix remove these orphans with a text editor it isn't ideal. To provide a better workflow for this we created a measure Remove Orphan Objects and Unused Resources that can be run either using the Apply Measure Now feature or at run time. If you see an EnergyPlus error about an object you don't think you have in your model, you may try running this to clean up the model. Additionally this measure also provides checkboxes that allow you to remove unused resources. While unused resources can be cleaned up in the GUI, the measure provides a robust and quick way to do this. Over time we will increase the functionality of the orphan cleanup as well as purging of unused resources.
Below is a screenshot of what the measure looks like in the Apply Measure Now window. By default the remove unused objects boxes are un-checked. You will always get the remove orphan functionality.
Below is a screenshot of the log after running the measure. The log will list each section being checked, so as the functionality is expanded you will know what object types are being checked for for orphan.
Energy Modeling Forum
Post your questions to the forum below for general and OpenStudio specific energy modeling information.
Submit a Bug
Please let us know if you find a bug in the OpenStudio software.