# Roof Commands

Below are all commands that operate on roofs.

## &#x20;Export roofs

Export roofs to HBJSON. Use this file to edit the roofs in Pollination Rhino plugin. You can then use the import roofs button to import the edited roofs back to Model Editor.

***

## &#x20;Find roof gaps

Identify gaps smaller than a specified gap distance.

<details>

<summary>Options</summary>

**Gap Distance**

The maximum distance between two roofs that is considered an unwanted adjacency gap. Differences between roofs that are higher than this distance are considered meaningful separations between roofs that should be preserved. Typical recommended values might be around 15 cm or 6''.

</details>

***

## &#x20;Find roof intersection

Find the intersection between two or more roof geometries in 3D space and draw a line (or polyline) in the scene where this intersection exists. Intersection lines will only be drawn on the first roof geometry of the selection and no result will be returned when the intersection of roof planes lies outside the boundary of the first face of the selection. So it may be necessary to adjust the order of the selection if the desired result is not obtained.

***

## &#x20;Import roofs

Import roofs from a HBJSON file. All orphaned shades in the HBJSON file are translated to roof elements.

<details>

<summary>Options</summary>

**Replace Current Roofs**

Select to have all of the roofs currently within the model replaced by the new roof geometries in the imported HBJSON file. If deselected, the roofs will simply be added to the current roof geometries in the model.

**Is Revit Sourced**

Select if the HBJSON file with roofs has been exported directly from the Revit model. If so, the roof geometry will be synchronized with the model's units and coordinate system if they have changed from the original Revit model.

</details>

***

## &#x20;Merge roofs

Merge coplanar roofs together that are on the same story and touching edges.

***

## &#x20;Preview roofs

Show the selected roofs in 3D. The 3D preview shows up in a new floating window.

***

## &#x20;Reassign roofs

Reassign the model's roof geometries to the stories to which they are most applicable. This is useful after splitting roof geometries with story boundaries such that different roof elements are now applicable to different stories.

<details>

<summary>Options</summary>

**Overlap Threshold**

A number between 0 and 100 for the percent of a room's area that must be covered by a given roof geometry for it to be considered covering that room. Using a non-zero value can prevent incorrect roof assignment in cases where roofs extend slightly past the room they are intended for.

</details>

***

## &#x20;Remove duplicate roofs

Remove all duplicate roof geometries across the model.

***

## &#x20;Roof to shade

Convert roofs to shade objects.

***

## &#x20;Show tilt

Show tilt of the roof temporarily.

***

## &#x20;Subtract roofs

Subtract one roof part from another one.

***


---

# 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.pollination.solutions/user-manual/model-editor/commands/by-use-case/category_2.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.
