Grasshopper ➡ Revit

Level: intermediate

Author: Alan

Software used: Revit 2021, Grasshopper for Rhino 7

TIP

We recently did a major upgrade of this guide. If for whatever reason you were looking for the previous version, you can find it here

You can stream Grasshopper native geometry to Revit using Speckle! In this guide, we will send different types of geometry and built elements to Revit to understand how Speckle converts them into native Revit geometries. We will also create some BuiltElements using the SchemaBuilder node, which allows for the generation of native Revit elements such as walls, floors, topography, etc...

Getting started

Before getting started, check that you have a supported version of Rhino (6 or 7) and Revit (2019-21) and the Speckle 2.0 connectors installed for Grasshopper and Revit. Then download the Rhino and Grasshopper files or this tutorial here (opens new window)

TIP

Our Rhino and Grasshopper connectors are independent of each other, unlike in Speckle 1.0. This means you can choose which one is appropriate for you, or install both! 😁

We're also going to assume that you already have access to a Speckle 2.0 server, and you have correctly set up your account for that server in the Speckle Manager.

Sharing Revit project data

Let's start with the easy part: In order to create Revit elements using Speckle, we should ideally have some knowledge of the current information available in our Revit project.

Let's create a new project using the default Architectural Template. You can use your prefered units. A project will be created with 2 default levels (level 0 and level 1). It should also have some default families loaded in the project.

Now, go to the Add-ins tab, and press the Speckle for Revit icon. The Speckle Desktop UI should appear.

• Press the blue + button on the lower-right corner to add a stream to the file.
• Create a new stream by writing a name and clicking on the blue arrow icon. You should see the Stream card appear on the DesktopUI window.

  TIP

  In our case, we'll call our stream Interop - GH/Revit - Project Data

• Press the blue button at the center that reads 0 object and select the option Set/Edit Objects Filter.
• Go to the Project Info filter type, select the Project Info, Levels and Families and Types options and press Set Filter.
• Press the Send button in the Project Data stream.

That's it! We've effectively pushed our project information, including all existing levels and loaded families/types to Speckle. We'll use this information to correctly set family/type names for Revit elements.

This concludes our setup. We'll now switch to Grasshopper to receive it and use it to generate new Revit elements.

Using Revit project data

Now let's open up our fake Leadenhall building model in Rhino. You'll need to open both Rhino and Grasshopper files, as there are some grasshopper nodes that reference geometries from the Rhino file.

Go to a blank area of your Grasshopper canvas:

1. Create a Panel and a Receive node.
2. Paste the stream url we copied in the previous step into the panel.
3. Connect the panel to the Receive node input and press the Receive button.
4. Create an Expand Speckle Object node, and connect the receied data to it.

Once done, it should look like this:

Most of the outputs will also be Base objects, meaning you'll have to expand them to inspect their properties (more on this later when using family types).

Sending geometry to Revit

We'll start by sending in the surrounding buildings of our model, as well as the plot street lines and the plot terrain. For this, we'll first create a Speckle Object to organize our data.

TIP

Remember you must correctly specify the Access Type for each input to generate the right amount of Base objects.

Inputs set with List Access will be shown with an L icon beside them.

We'll also need to create a new stream in our server, called Interop - GH/Revit - Plot Data, and copy it's url.

Then, we can just plug in the geometries directly into their respective inputs. Connect it to a Send node pointing to the stream we just created and press Send.

In Revit, add the stream to your DesktopUI and press Receive. Here's a quick peek of the process:

About sending BREPs

Rhino BREP support still has some limitations we are working on improving, but other's are strictly imposed by the Revit API. In order to ensure unsupported geometric objects still get represented when importing to Revit, we provide a fallback value for every BREP in the form of a Mesh.

So, whenever a BREP conversion fails in Revit, the resulting object will still be generated in the model, only as a tesselated representation of the smooth BREP.

Controlling the DirectShape conversion

As you may have noticed, our surrounding buildings have been created in Revit as Generic Models. This is the default conversion behaviour when sending geometry elements that are not directly supported by Revit (such as meshes or breps).

In order to control this behaviour, we can use the Schema Builder node.

SchemaBuilder node pop-up

When first create the node, a pop-up window will appear allowing you to select the object type you want to create. These are organized into two main categories:

• Built elements: These are Speckle elements created to support common built elements (beam, wall, slab, level...) accross the entire Speckle ecosystem.
• Revit elements: These are specifically designed to support Revit specific entities and workflows.

• Drag a Create Schema Object node to your canvas.
• From the pop-up, select DirectShape and press ok. A new node and a dropdown should appear.
• Select Mass from the dropdown list.
• Connect the surrounding building geometries to the baseGeometries input. Graft the input to generate one direct shape per geometry.
• You'll also need to connect a panel with a desired name for each DirectShape.

Let's also send the terrain as a native RevitTopography object.

• Drag a Create Schema Object node to your canvas and select the RevitTopography type.
• Connect the terrain mesh to the revit topography displayMesh input.

It should end up looking like this:

Now swap those direct shapes for the original geometries and send them.

In Revit, once you get the notification that data was changed, press the receive button. You should now see the surrounding buildings appear as Massing objects.

TIP

If you don't see the surrounding buildings, ensure you have the Massing objects visibility active in the Massing / Site tab in Revit.

Generating Floors and Levels

Now that we have our plot and surrounding buildings set-up, let's proceed with the creation of the levels and floor slabs for each level.

Creating levels

• Drag a Create Schema Object node to your canvas and select the RevitLevel type.
• A revit level requires a name, elevation, and an indication to create a view for that level.
• Connect the lower floor names and lower floor heights to their respective inputs in the RevitLevel node.

Creating floors

Now we'll create some native Revit floors, using the levels we previously created and the curves available on the Upper/Lower Floor Outlines nodes. We'll also need to select a floor type from one of the available floor types we received from Revit.

TIP

To select a specific floor type, first select an individual type with a list item node, and then use the Expand Speckle Object node to inspect it's properties.

1. Create two SchemaBuilder nodes with RevitFloor type.
2. Connect the selected family name and type.
3. Connect the respective levels and outlines (upper/lower) to each RevitFloor node.

Creating beams

In this case, since we do not have much information about the structural beams, as they are modelled as simple lines. This is the perfect scenario to use Speckle's BuiltElements.

These are simple representations of common BIM elements, that require a minimum amount of input. These elements will be appropriately converted to native elements on each target platform when possible.

In the case of a BuiltElements.Beam, the input required is only the axis line of that beam.

1. Drag a Create Schema Object node to your canvas and select the Beam type (not RevitBeam).
2. Connect all truss lines to the baseLine input. Since we don't really care about the data structure they're organized by, we can flatten the input.

Creating the walls

Core walls

Just like with floors, we can create walls using the Create Schema Object node. There are several ways to create a wall, but for the Core Walls, we're going to create them with the Wall by Face type. This takes a surface as a reference to create a wall in revit with the same shape.

1. Drag a Create Schema Object node to your canvas and select the Wall by Face type.
2. Locate the node called Core Walls and connect it to the surface input.
3. Select a category from the available wall types we received from Revit and connect it's family name and type.
4. The last thing we need is a level, but in this case, we already know there is a level called Level 0 on our project, which is at ground level. We can reference it using the Level by name schema.
5. Drag a Create Schema Object node to your canvas and select the Level by name.
6. Connect a panel with the text "Level 0" to it's only input, and connect the resulting level into the Wall by Face node.

Interior walls

We have a bunch of interior walls we haven't done anything with yet. Lets create them using a line and a height.

• Drag a Create Schema Object node to your canvas and select the Wall by curve and height type.

• Connect the nodes Wall Baseline per leveland Wall Height per level to the baseLine and height input respectively.

• Connect the filtered levels node to the level input.

  TIP

  Notice that, since not all levels have walls, the level's have been filtered to contain only the ones that are to be used.

• You can flatten the output of the node, as we won't be needing that data tree structure anymore.

Categorizing generic geometric objects

For anything that cannot be directly translated into Revit elements, you can still send them directly, as we saw in the first step. Just as we did with the surrounding buildings, we can categorize the Ground Floor Objects, Foundation and Ramps as DirectShape objects with their appropriate categories.

Organize the building structure

Until this moment, we've been creating several Revit elements we want to send. Before doing so, let's organize that data into a single Speckle Object to keep everything tidy.

We have several parts to send:

• Floors
• Core walls
• Interior walls
• Beams
• Objects at ground floor
• Substructure
• Ramps

1. Drag a new Create Speckle Object node.
2. Create inputs for each of the object types we just created.
3. Connect everything appropriately.

TIP

Always remember to set the access type of your inputs appropriately.

Sending the building structure

On the server's website, create a new stream to send the structure data to. Copy it's url. In Grasshopper, create a Send node and a panel with the url of the stream we created earlier to share the structure.

In Revit, add the newly created stream to the DesktopUI and press Receive. You can see the entire process in the animation bellow.

Create AdaptiveFamiliy instances

Adaptative families in Revit are a cool contraption. You can provide a set of points and they will adapt to the given positions.

WARNING

In order to correctly create Adaptive Family instances, the specified family must be loaded into the Revit project.

The amount of points provided must also coincide with the amount of points the Adaptive Family uses internally.

You'll find a very simple adaptive component called 4Pt-AdaptivePanel along with the rest of the files of this guide.

In the file, we already created some curved square panels to act as a fancy roof shading. In the grasshopper file, you'll find a node called Point groups for adaptive component, containing the 4 corners of this panels individually grouped.

Sending Adaptive Components to Revit using Speckle is quite easy:

• Drag a Create Schema Object node to your canvas and select the AdaptiveComponent type.
• Input the appropriate family and type (in our case, they are both the same: 4Pt-AdaptivePanel)
• Connect the grouped points to the basePoints input. The component would generate an AdaptiveComponent object for every group of points.
• Create a new stream on the server to hold this adaptive panels and create a Send node pointing to that stream.
• Send the AdaptiveComponents you just created.

In Revit, add the stream you just created using the Desktop UI and receive the data. Your panels should appear on the top floor of the building.

Using branches to swap design alternatives

This is a perfect moment to introduce the behaviour of branches in the Speckle Revit connector; and how you can leverage the feature to alternate between different design options.

1. Go to the stream's url in your web browser, and create a new branch called design-option-2.
2. Copy the url of the branch page (it should end in /branches/BRANCH_NAME)
3. On the grasshopper file, modify the points in any way, like modifying the seed input in the Random numbers node.
4. Change the stream url for the branch url we just copied and press send.

In Revit, you'll notice there's an update notification in the Roof Panels stream that specifies there have been changes in a different branch. You need to switch branches to receive the new data.

1. Click on the branch name on the Stream card.
2. Select the branch we just created.
3. Click the Receive button.

You should see the new panels update to reflect the new design option. To go back to the previous version, you can always go back to the main branch.

Using Speckle in the Family Editor

WARNING

🚧 This section is still under construction 🚧

Populating family instances in the model

WARNING

🚧 This section is still under construction 🚧

Known issues

Speckle 2.0 is currently under beta. You can find any known issues on our GitHub Repo Issues page (opens new window).