# OpenStudio SketchUp Plug-in

The OpenStudio SketchUp Plug-in is a tool that integrates with SketchUp to facilitate the creation, editing, and visualization of building geometry models for energy simulation. 

It allows you to define building elements, such as walls, windows, and shading devices, directly within SketchUp, linking them with energy modeling parameters for use in OpenStudio and EnergyPlus simulations. 

The plug-in provides a user-friendly interface, making it easier to define thermal zones, assign materials, and configure building systems, which streamlines the process of preparing models for energy analysis.

{% hint style="info" %}
The Plug-in’s repository is accessible on GitHub - <https://github.com/openstudiocoalition/openstudio-sketchup-plugin.>
{% endhint %}

{% hint style="warning" %}
The 3D feature to import into Speckel is in a testing phase, only available to [Enterprise Plans](broken://pages/MDvkjCUD7EVopR5p8HOS). Please contact <support@speckel.io> if you would like to access this feature early and your are on a [Practice Plan](broken://pages/tPKLo7AD4lTq5WnS6C8F).
{% endhint %}

## Setting Up Your SketchUp Model

{% embed url="<https://www.loom.com/share/8fe9690be4cc45cd8ab083790e518b03?sid=a5f7f4c5-04c3-489f-88bb-7f8fce840217?hide_owner=true&hide_share=true&hide_title=true&hideEmbedTopBar=true>" %}

Setting up a model using the OpenStudio SketchUp Plug-in involves several key steps. Here’s a step-by-step guide:

### Install the OpenStudio Plug-in:

Ensure you have SketchUp and OpenStudio installed. Install the OpenStudio SketchUp Plug-in from the OpenStudio Application installer. We recommend using v1.7.0, following the installation instructions [here](https://github.com/openstudiocoalition/openstudio-sketchup-plugin/releases).

### Start a New SketchUp Model:

Open SketchUp, and you will find the OpenStudio toolbar added. Click the “New OpenStudio Model” button to start a new energy modeling project.

### Create Building Geometry

Use SketchUp’s native tools to draw building geometry, including walls, floors, roofs, and windows. Group geometry into thermal zones as needed. Each zone represents a space with uniform temperature control.

### Assign Spaces and Zones

Use the “Create Spaces from Diagram” tool in the OpenStudio Plug-in to assign SketchUp groups as thermal zones. Ensure spaces are correctly assigned and named according to your energy model needs.

### Add Building Elements

Use the OpenStudio Plug-in tools to add windows, doors, shading devices, and other elements. Assign construction materials to these elements using the properties tab.

### Check and Validate the Model

Use the OpenStudio Plug-in’s diagnostic tools to check for errors, such as unassigned surfaces or gaps between spaces

### Export the Model

Save the SketchUp model, then export it as an OpenStudio file (.osm) for further analysis in the OpenStudio Application or EnergyPlus. To export a gbXML, navigate to Extensions->OpenStudio->Export->Export gbXML Model in the menu item.

### Open in Speckel

Create a new Design and import the gbXML file into Speckel. Once converted, hit 'Save' and navigate to Levels. Select 'Detect Levels' and 'Detect'. Hit Save.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.betterbuilding.io/support-and-training/other-support/tutorials/speckel-tutorial-archive/openstudio-sketchup-plug-in.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.