::: tip Prerequisites
To follow along with this tutorial, you will need to register with Speckle and install the required connectors. It takes less than 3 minutes!
For a comprehensive overview of these connectors, check our docs!
:::
Tutorial
This tutorial uses Rhino 7 and any supported version of Revit - check that you have the Speckle 2.0 connectors installed for these applications. Then, download the Rhino 7 file for this tutorial here. We'll walk through each section showing you how to assign Rhino BIM tags to regular geometry by using either our Speckle 2 toolbar, or typing the commands directly in the command line!
- Open the Rhino file. The model is organized into layers for each section of the model we will be sending.
- Pull up the Rhino Desktop UI by clicking the blue Speckle button on the toolbar, or by typing Speckle in the command line.
- Open a new Revit file, and open our Revit connector, which can be found in the Add-ins ribbon .
Send Context Geometry as Breps
Let's send our first stream! Since we won't be sending the context geometry as families, the next steps are just a warm up (with some fun layer filtering action):
- Create a new stream, name it
Context
and check that it is on Sender mode. If not, click the arrows on the top right corner to toggle between the two modes. - Click the blue Objects button and select Set/Edit Objects Filter from the dropdown.
- From the
Layer
filter tab, select Context::Buildings and Leadenhallish:Substructure and click Set Filter. - Click Send on the
Context
stream card. - In Revit Desktop UI, click the blue Add a stream button on the bottom. Add the
Context
stream by clicking the arrow next to the stream in the popup window. - Click Receive on the stream, and watch the geometry come in as generic models.
Overall, not a bad start - now let's do some serious sending!
Send Ground Floor Geometry with Walls, Floors, and a Facewall
For the ground level of our building, we're going to send geometry as a mix of walls, floors, facewalls, and generic models for elements (like ramp surfaces) that are not currently supported.
Let's try using the Automagic ⚡ method, which automatically decides which schemas to apply to your selected geometry based on object and layer names as well as geometry type. Let's test this out and see which geometries were successfully assigned a schema:
- Lock the context layers you sent from the previous section, and hide all layers except for Leadenhallish::Ground Floor for ease of selection.
- Select the yellow
BIM Elements
>Automatic
button on the Speckle toolbar, or type ApplySpeckleSchema in the command line - notice that the Automatic command option toggle is by default set to On. - Select all objects in Leadenhallish::Ground Floor and hit Enter to finish the command.
- Now click through the geometry and check which pieces have been assigned a Speckle schema by navigating to the Object > Properties > Attribute User Text panel.
You should see a <SpeckleSchema,Floor> key value pair in the attribute user text panel of any planar horizontal surfaces on the ground floor. However, the planar vertical surfaces were not assigned a schema, even though they should be walls: this is because the automagic method picked up the word Floor in the layer name and only tried to assign the Floor
schema to all the selected objects! Let's manually set a wall schema for our vertical surfaces:
- Select the vertical surfaces on the Leadenhallish::Ground Floor layer.
- Select the yellow
BIM Elements
>Wall
button on the Speckle toolbar, or type CreateWall in the command line, and hit Enter. - Check the Attribute User Text panel and you should see a <SpeckleSchema,Wall> entry now!
- Repeat steps 1-3 for the curving surface on the ground floor, this time selecting
BIM Elements
>FaceWall
or typing CreateFaceWall instead.
Create a new stream, name it Ground Floor
and send all geometry from the Leadenhallish::Ground Floor layer. In Revit, receive this stream and any objects that were assigned a schema will be converted as default Revit families.
Send the Core Brep as Walls and Floors
Next, we'll send try to send the core geometry as Wall
and Floor
surfaces.
- Lock the previous layer and unhide the Leadenhallish::Core layer.
- Select all geometry - notice that the core is modelled as a single brep.
- Try to apply schemas automatically with the ApplySpeckleSchema command or the
BIM Elements
>Automatic
button on the Speckle toolbar. - No schemas were assigned to the brep! We need to explode it first into surfaces: select the brep and type Explode in the command line.
- Now try applying schemas again. Voila, floors and walls were assigned!
- Create a
Core
stream and send the geometry to Revit
Send the Floor, Slabs and Truss to Complete the Model
To finish off our model, let's send the floor slabs and truss with the automagic method. We don't need to worry about missing schemas in the Leadenhallish::Floor Slabs layer since it only has horizontal surfaces, and the truss curves in Leadenhallish::Structure sublayers will be intelligently picked up as either Column
or Beam
objects!
- Lock the previous layer and unhide Leadenhallish::Structure and select Leadenhallish::Floor Slabs. Select all containing geometry.
- Apply schemas automatically with the ApplySpeckleSchema command or the
BIM Elements
>Automatic
button on the Speckle toolbar. - Cycle through some of the truss members to look at their assigned schema. Lines with < 45 degree deviation from vertical are assigned as columns, while all others are assigned as beams.
- Create a new
Floors and Truss
stream and send to Revit. Go to Revit and receive it - our Leadenhall lookalike building is now complete!
Remarks
Detailed information on the Rhino schema commands used in this tutorial can be found under the Rhino BIM
section in the Rhino User Guide. This feature is an early prototype, so we currently do not offer control over specific family types during schema assignment, except when sending adaptive components: ⚠ all geometry with schemas are assigned a default type upon conversion into Revit.
::: tip
To remove schemas applied during this tutorial and start over:
- Type RemoveSpeckleSchema in the command line, or use the
BIM Elements
>Remove
button on the Speckle toolbar - Select objects to remove schemas from
- Press Enter - Speckle AUT strings are now deleted from all selected objects!
:::
Conclusion
We hope you enjoyed this tutorial and found it useful!
Speckle is an Open Source project and we really ❤️ feedback so, if you have any questions, comments, critiques, or praises please let us know on our community forum.