> For the complete documentation index, see [llms.txt](https://docs.betterbuilding.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.betterbuilding.io/support-and-training/other-support/tutorials/speckel-tutorial-archive/openstudio-sketchup-plug-in.md).

# 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.&#x20;

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.&#x20;

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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
