Question-and-Answer Resource for the Building Energy Modeling Community
Get started with the Help page
Ask Your Question

OpenStudio 3.1.1 from OpenStudio Coalition website 11-26-20

asked 2020-11-26 14:48:18 -0600

rgleason's avatar

updated 2020-12-02 13:32:29 -0600

To upgrade (actually start over) from sketchup 8.0 and Openstudio I started by downloading files from and then tried to determine order of installation and what sketchup version to install.

Then I found the OpenStudio Coalition website with installation instructions.

  1. Download and install OpenStudio v1.1.0 which contains many support components (OpenStudio Application, EnergyPlus, Ruby API, C# API, CLI, Radiance, Application Resources)
  2. Download and install Trimble SketchUp 2019-2020 Pro @ $299/yr which is required by OpenStudio Sketchup Application.
  3. Download and install OpenStudio SketchUp Plug-in v1.1.0 RBZ package.
  4. Follow the Trimble Installing extensions manually in SketchUp Preferences to install the Plug-in.

Then you can install BCL or PAT if needed.

My questions are is OpenStudio Coalition the right website and process to use now? Is Sketch Pro really required? $299/year is pretty steep for my use. I tend to use do this occasionally, several months apart.

edit retag flag offensive close merge delete

2 Answers

Sort by ยป oldest newest most voted

answered 2020-12-02 14:06:30 -0600

updated 2022-09-23 09:44:31 -0600

As of April 2020, the OpenStudio Application (graphical user interface for making changes to OSM files, assigning measures, etc.) is managed by the OpenStudio Coalition. This is due to a US Department of Energy decision to transition the of ownership/maintenance of the application from NREL to private third parties. This affects OpenStudio Application v1.0.0 or later, which made updates that require the use of SketchUp Pro 2019 or later to use the OpenStudio plug-in for SketchUp. You can see this under the OpenStudio plug-in for SketchUp compatibility matrix created by the OpenStudio Coalition.

If paying for a SketchUp Pro license is cost-prohibitive, then you have two options.

  1. You can keep using the latest versions of the OpenStudio Application from the OpenStudio Coalition, but use the free FloorspaceJS tool to create geometry within the OpenStudio Application and not use SketchUp anymore. The downside of this is reduced flexibility in defining complex geometry that SketchUp provides.

  2. Use previous versions of the OpenStudio Application managed by NREL (v2.9.1 or earlier), which works with SketchUp Make (free version) from 2017 or earlier. There is a separate compatibility matrix for these older versions. The downside of this is being forced to use a "static" older version of the application that works with EnergyPlus v9.2, so you will miss out on updates to the application and the SketchUp plug-in made since then. EnergyPlus updates will also keep occurring, but you could manually update EnergyPlus input files generated from the OpenStudio Application to the latest version if you really wanted or needed to.

edit flag offensive delete link more


Very helpful. Thank you! Regarding #1 Additional instruction documents for FloorspaceJS Tool Regarding #2Compatibility matrix for these older versions. So for OpenStudio SDK v2.9.1 Compatibility Matrix v2.9.1, E+ 9.2.0, Radiance 5.0.a.12, Sketchup 2017, Ruby 2.2.4, SHA 3472e8b799, Released 2019-12-07, Gemfile Does SDK need compile? Need compiled version?

rgleason's avatar rgleason  ( 2020-12-04 12:08:31 -0600 )edit

You can make your geometry with OpenStudio 2.9.1 and then open and update the model version in the OpenStudio App if you don't want to pay for the sketchup license and use the openstudio 3+ version in sketchup.

mdahlhausen's avatar mdahlhausen  ( 2020-12-07 16:54:25 -0600 )edit

@mdahlhausen great point, this is also mentioned in Julien's answer along with a note that after updating the model version you could NOT go back to SketchUp Make 2017 to edit the geometry.

Aaron Boranian's avatar Aaron Boranian  ( 2020-12-08 13:27:50 -0600 )edit

answered 2020-12-03 03:36:27 -0600

Sketchup 2017 and 2018 use Ruby 2.2.x, which is what the OpenStudio suite of tools used for version 2.X.

The - now separated and managed by OpenStudio Coalition - OpenStudio Application and OpenStudio Sketchup Plugin rely on the the OpenStudio SDK (from NREL) at version 3.X, which uses Ruby 2.5.X and that's what Sketchup 2019 uses.

Ruby versions need to align for the plugin to work.

You could use OpenStudio 2.9.1 (which would use E+ v9.2.0 if you do simulate your model) to draw your geometry in Sketchup 2017 Make (free), then open your OSM in the OpenStudio Application 1.1.1 which uses OpenStudio SDK 3.1.0 and EnergyPlus v9.4.0. The problem is if you need to adjust your geometry once you have done that upgrade, since OpenStudio SDK maintains compatbility of OSM files only in one direction (older to newer, which is expected).

edit flag offensive delete link more



Very helpful too.. So use 1. OpenStudio 2.9.1 (use E+ v9.2.0) to draw your geometry in Sketchup 2017 Make (free). 2. Then open the OSM file in OpenStudio Application 1.1.1 which uses OpenStudio SDK 3.1.0 and EnergyPlus v9.4.0. Cannot go back to sketchup as compatibility of OM files is only one direction, upgrade.

rgleason's avatar rgleason  ( 2020-12-04 12:19:14 -0600 )edit

It does not give me the answer which version of Openstudio, which is available now on the Openstudion download site works with Sketchup 2017 ?

I also would like to add that the installation works on one computer but not on the one which has Rhino and Microsoft 365 installed . What could be the reason?

It is Openstudio which is not working, not Sketchup 2017

Isa's avatar Isa  ( 2021-01-21 09:37:27 -0600 )edit

@Isa if you're referring to your installation issues in this post, Julien's answer here is saying that SketchUp 2017 will only work with older versions (2.9.1, e.g.) of the OpenStudio Application managed by NREL. Newer versions of the OpenStudio Application managed by the OpenStudio Coalition will NOT work with SketchUp 2017.

Aaron Boranian's avatar Aaron Boranian  ( 2021-01-22 08:25:22 -0600 )edit

@rgleason Trimble has recently made available for free newer versions of SketchUp, Pro versions actually:

So, if you'd install for example SketchUp Pro 2020, you would need OpenStudio Application 1.1.0 (which includes Radiance 5.0.a.12. and EnergyPlus 9.4.0.) and the OpenStudio SketchUp Plug-in 1.2.0., according to the new compatibility matrix.

Mafalda Correia's avatar Mafalda Correia  ( 2021-07-23 06:52:09 -0600 )edit

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer


Question Tools

1 follower


Asked: 2020-11-26 14:05:24 -0600

Seen: 1,007 times

Last updated: Sep 23 '22