All posts by Jay Merlan

Use Dynamo to Transfer Phase Data to Bound Revit Models

This workflow was created as a request from @PhilosophyBIM on Twitter

The issue arises when binding a linked model in Revit. If you’ve ever had the task of binding a linked model that contains crucial Phase data,  you’ve run into the issue where the Phase data is lost regardless of whether the phase exists in the destination model or not. I hope this helps eliminate some tedious work for some Revit users out there!

In a nutshell, this process temporarily stores the phase data (e.g., “Existing” and “New Construction”) in Project Parameters. Once those values are stored, a second graph sets the Revit Phase data based on those parameter values.

Note that this was tested on a simple project with only two phases. Please experiment on a detached model when trying out this workflow.

Download the Dyn’s:

Dynamo - Transfer Revit Phases to Bound Model (350 downloads)

The Workflow

1. In your source model (the model to be bound), create three project parameters.

Use Project Parameters to transfer Revit phase data to bound linked Revit models

These parameters are used to temporarily store the data from Revit’s built-in Phase parameters. The third parameter is an added bonus of storing Element ID’s for simplified quality control.

  1. SourcePhaseCreated
  2. SourcePhaseDemolished
  3. SourceElementId (this is used for QC if so desired)

Use your judgement on which categories to apply the parameters to, but for the sake of simplicity, I would recommend to apply these project parameters to all categories.

2. Create a 3D View that hides all annotations.

You’ll want to make sure that all model elements are visible, because the Dynamo graph collects elements to apply the Parameter values based on what is visible in the active view.

3. Run “Store Element Id and Phase Parameters.dyn”.

Set Parameter values for mapping Revit Phases from linked model after binding

This graph does the work of taking the Phase data from Revit’s built-in parameters and storing their names in the parameters that were created in step one.

While doing some testing, I noticed that Dynamo throws an error because there are certain model elements that cannot be assigned a project parameter. As far as I could tell, this didn’t cause an issue with mapping the Phases to the Parameter values, but please let me know if you find otherwise while using these graphs.

Note that if you would like to double check that the parameters were correctly populated, I recommend to build schedules with the Phases and Parameter values and either run a quick scroll to visually check or run some conditional formatting for larger models.

4. Link the source model into your destination model, bind it, and ungroup the bound elements.

After the model is bound,  note that the Project Parameters created in step one and the values populated from step two have been brought into your destination project.

We aren’t done yet, notice that the Project Parameter values do not match the Phase parameter values.

Parameters used to store Phase data from after linked model bind

5. Finally, run “Set Phase from Phase Parameters.dyn”.

Set Revit Phase after binding linked model from Parameter Value

This graph sets your elements to the proper Phases based on the parameter values populated in step three.

Take some time to look at this graph before you run it, especially if you have more complex phasing in your project. I’ve grouped each set of nodes so that in the instance that you have several Phases, it should be easy to figure out how to duplicate the groups and create a group for as many phases as your project contains.

Download the Dyn’s:

Dynamo - Transfer Revit Phases to Bound Model (350 downloads)

Hope this helps!

Please let me know if this graph does or doesn’t work for you. All feedback is appreciated!


Dynamo Graph to push Space data into COBie.Component.Space including elements above the ceiling (MEP)

Here is a graph that I’ve thrown together that pushes the Revit Space number  into the COBie parameter “COBie.Component.Space” for elements that are within the Space, including elements above the ceiling.

Note that in order for this to include the elements in the area above ceilings (i.e., mechanical and electrical equipment), your spaces must use the “Upper Limit” parameter on your spaces to include the elements that are within the ceilings above the Space. This hasn’t been fully tested, so if it doesn’t work for your project please let me know in the comments below.

Push Space number into COBie.Component.Space parameter of elements above ceiling


  1. Open the model which contains the elements you wish to populate the COBie parameter (e.g.,  MEP model).
  2. Create spaces and rename/renumber as needed (I recommend the Space Naming Utility).
  3. Launch Dynamo and open the graph linked at the bottom of this post.
  4. In the graph, choose which categories you would like to push the space data into. Modify the List.Join node if you need to add or remove categories from the list.
    COBie space parameter to model categories
  5. Set the graph to Automatic (for an easier workflow)
  6. Use the Select Model Element node to pick a space individually.
    Pick a space in Revit to push to COBie data.
  7. Continue selecting spaces as needed to populate element COBie space data.

Under the Hood

This graph first gets all elements of the chosen categories and then gets the BoundingBox of a space.Get bounding box of space for COBie parameter in Revit

It then filters out the elements whose coordinates are not within the selected Space’s BoundingBox.Get elements within Space for COBie

Finally, the graph pushes the Space’s “Number” parameter value into the “COBie.Component.Space” parameter.

Set Revit Space number to COBie parameter

The unique challenge here was for MEP elements that are above the ceiling. To solve this, I use the Space’s “Upper Limit” parameter to include the ceiling space above the Space.Get Upper Limit parameter to include in bounding box for COBie space data

A new BoundingBox is created using the new MaxPoint from the “Upper Limit”.Include ceiling space in Space height for COBie


I haven’t tested this on complex spaces, so if this doesn’t work for your project, please let me know in the comments below.

This graph could be modified to iterate through all spaces, but I haven’t had a chance to do so. Please, if you end up modifying it to do so, please share the dyn in the comments below so that I can update this post and share with our readers.

Questions, comments, issues?

Space Number to COBie.Component.Space (282 downloads)

BIMxDB v0.0.2 Published – Store Revit Data in SQLite Database

To supplement the BIMxHTML Dynamo package, I published a second package called BIMxDB. This package will contain several custom nodes for exporting Revit data to different types of databases.

For now, my focus is SQLite and the current node that is in the package is Export.SQLite.ParameterData.TimeStamped. This custom node creates a table in the SQLite  database specified as an input.

The table is named with the Model Category (input #1) and suffixed with a time stamp in Unix time format (e.g., Ducts_1503598277.39).

Revit data in SQL database
Example of SQLite database as exported from the BIMxDB node.

I see this type of workflow being useful when plotting line charts  of quantities over time or comparing changes between model versions. I will be using this on my next project, so stay tuned for a case study!

Sample Files

In the sample below, a simple graph demonstrates the usage of the node by taking a single model category’s elements and exporting all parameter data to SQLite.

Using Dynamo to track changes (197 downloads)

BIMxHTML v0.0.8 – More Custom Nodes to Generate Google Charts

It looks like there has been some interest in the BIMxHTML Dynamo package and its encouraged me to develop some custom nodes to simplify the display of Google Charts using pure Dynamo.

The Custom Nodes

Download the sample files below to get a good example of how to use these nodes. Essentially, they output an entire web page and as of today the intent is to use them in the iframes of a dashboard.

Data Set – Quantities of Family Types.dyf

Use this node to build a dictionary of family types of any given category. The output is actually a list of sublists which contain the [key, value] pairs as [family type, quantity]. For example:  [Diffuser24x24, 17].

This node is helpful to use for the input of any of the Google Chart nodes.

Create a data set for use as input to the BIMxHTML nodes.

Generate Web Page – Google Pie Chart.dyf

Creates the complete web page to display a responsive pie chart based on the Google Charts API. The intent for the HTML file is to reference it in an iframe for a dashboard (more on that to come).

Refer to the Google Charts documentation for options input.

Create the HTML for a Google Pie Chart.

Generate Web Page – Google Bar Chart.dyf

This node takes the same exact input as the Pie Chart node and outputs a bar graph.

Refer to the Google Charts documentation for options input.

Create the HTML for a Google Bar Chart.

Sample Files

Refer to the sample Dynamo graphs below to get a better idea of how to use these nodes. Dashboard-Mech.html is currently the best example because it displays a pie chart, a bar chart, and a table – all generated directly from Dynamo. (240 downloads)
A dashboard generated using Revit, Dynamo, Bootstrap, and Google Charts.
A dashboard generated using Revit, Dynamo, Bootstrap, and Google Charts.

BIMxHTML – A Dynamo Package to Generate Web Pages

All of the excitement revolving around generating dashboards using Power BI made me wonder: Can we leverage Dynamo to create web pages that display data directly from a Revit model? The goal would be to create a powerful, free alternative to generating web-based content using simple HTML code.

Needless to say, the gears have been turning and I have been experimenting. With that said, I have published my first Dynamo package, BIMxHTML, which will eventually have several nodes to display content on a web page using very basic HTML. I have been playing with Twitter Bootstrap and Google Charts so far.

Update: New nodes have been published to v0.0.8 which streamline the creation of Google Charts. Read up on the nodes here:

For now a single node is included in the BIMxHTML package: Generate Web Page.

Using Dynamo node to create a static HTML web page.

The inputs for Generate Web Page contain several default values for configuring the <head> of the web page. I have also included inputs to allow users to link to external CSS stylesheets and JavaScript files or embedded code for custom <style> or <script> tags. All without managing the template’s HTML directly.

I have a sample model and graph for you to see the node in action available for download below.

Use Dynamo to generate a static HTML web page.
Sample Dynamo graph using BIMxHTML nodes to create an HTML web page.

Sample Files Explained

There are a few sample graphs included in the download below. Please keep in mind that these are extremely early examples of the possibilities of using Dynamo to extract Revit data and output HTML for display in any modern browser. Currently, I have been experimenting with a combination of Twitter Bootstrap and Google Charts, but if you have any suggestions on other frameworks or analytics tools, please make a suggestion in the comments below.

Table Sample.dyn (TableTest.html)

Creates a list with parameter values as sublists.

  1. Using Python, the HTML code for a table is generated using each list item as a table row and each sublist item as a column value. Note: a custom node will be added to this package to handle this in the near future.
  2. Finally, the Generate Web Page node from the BIMxHTML package creates the entire web page’s code and then writes the code to an external HTML file.

Google Charts – Pie Chart.dyn (Air Terminals.html / Ducts.html)

Creates an HTML page containing a Google Charts pie chart displaying the quantity of family types per category.


A sample Bootstrap layout which uses iframes to display the pie charts generated from Google Charts – Pie Chart.dyn.

Use Dynamo and Revit to create a free alternative to Power BI
A dashboard generated using Dynamo, Revit, Twitter Bootstrap, and Google Charts.


Would these tools help you with your workflows? Do you have any suggestions on how I can improve on these? Would you like to help contribute? Please leave your questions and comments below. (321 downloads)

Hello Dynamo World!

In learning every new programming language, it is customary to start with a “Hello world!” application. Although visual, Dynamo is a scripting tool as well, so I thought this would be a great first step for folks who are new to Dynamo.

In this post, we demonstrate how to display “Hello world!”  in the Revit application in two ways:

  1. Displaying a TaskDialog in Revit using a combination of Dynamo and Python.
  2. Adding a TextNote to a view using only out-of-the-box (OOTB) nodes.

Hello World Using Dynamo and Python

Hello world Dynamo graph

The image above shows the completed graph (download below). Most of the work is done within the Python script which uses two inputs as variables.

Insert a Python Script node.

Once the node is placed in your graph, you will need to click the “+” button to add an additional input.

Python script node in Dynamo to show a task dialog in Revit.

After adding the second input, you should see IN[1] as shown below.

Python script in Dynamo to show a task dialog in Revit.

Add strings to your input.

For this example, I’ve shown two different nodes that you can use to output strings in Dynamo. The String node outputs a string from the value that you insert into the node (Hello). The Code Block node must include double quotes and a semicolon to output a string (“Hello world!”;).

In computer programming, a string data type is a set of characters. This can be in the form of a sentence or a file path, and can contain special characters and/or spaces. Strings are typically enclosed using double quotes.

Connect the nodes to the inputs as shown below.

Hello world Dynamo graph

Insert code to the Python Script node.

To open the code editor in Dynamo, double-click on the blank area of the node as highlighted below.

Edit a python script in Dynamo

Insert the code below to the code editor. Note that we are including the Autodesk.Revit.UI namespace in order to use the TaskDialog.Show() method from the Revit API.

I highly recommend that you type this code in rather than copy/pasting. It will help you start to understand Python’s syntax.

import clr
from Autodesk.Revit.UI import TaskDialog

windowTitle = IN[0]
windowMessage = IN[1]

messageDialog = TaskDialog
OUT = messageDialog.Show(windowTitle, windowMessage)

If your Dyn is set to run automatically (it is by default)  you should immediately see the dialog box pop up in Revit. If set to manual, click the Run button in the bottom left of Dynamo to run the script.

Here is a link to the Dynamo graph used in this example:
HelloWorld.dyn (247 downloads)

Hello World with OOTB Nodes

Dynamo BIM - Hello World in Revit

The image above is the completed graph (download below) and will create a TextNote in the Revit view of your choice.

1) TextNote.ByLocation
This node does all of the work. It will place a text element in the view that you choose. The node has several inputs, but for this example we will only use the first four inputs.

2) Views
A node that provides a drop down menu of all of the views in your project. Choose a floor plan view in your active model as you follow this example.

3) Point.ByCoordinates
This node outputs a Point based the x, y, z inputs. For this example, I’ve shown three different nodes that you can use to generate number values: 4) Number , 5) Code Block, and 6)Number Slider

7) String
The value in the String node goes into the “text” input for the content of the text note element in the Revit view.

8) String
The value in this String node goes into the “alignment input”

Here is a link to the Dynamo graph used in this example:
Hello World - Text (293 downloads)

Questions? Post your comments below!

Linked Mechanical IFC Model Into Revit; Can’t See Ductwork

Tonight (yes, I am working on a Friday night), I ran into a new issue that I thought the community might be interested in. I linked an IFC into Revit which was exported from AutoCAD MEP.

The issue is, I could not see any of the duct.

Autodesk posted a solution to the problem that unfortunately did not work for me. After a little experimenting, I discovered that if you switch to a reflected ceiling plan view, the duct work from the IFC was visible in my view.

Hope this helps somebody someday!

Faro Scans and Autodesk ReCap

Just a quick post to share that I had a first crack at using Autodesk ReCap 360 for importing laser scans from Faro to reference as-built conditions. So far, Recap is working well for importing FLS scans.

Faro laser scan in Autodesk ReCap
Here is an image of a massive utility tunnel that I’m currently working on. More to come!
Faro laser scan RealView in Autodesk ReCap
ReCap is also is able to reference the “Real View” photographs included in the Faro FLS files. Navigating in the fashion is similar to Street View in Google Maps. Very cool.

Managing View Templates with Revit links that are set to “By Linked View” per level

One of the biggest challenges of dealing with large Revit models is working with outside consultants’ linked Revit models. You may need to use a linked view to easily match said consultant’s floor plan views. In that case, you should use the By Linked View V/G setting of your RVT Link. The problem you will face is that you cannot control the linked view with a View Template unless you have a View Template for each level.

I’ve seen a number of projects that actually had a view template per level. Don’t do this! In my opinion, this is improper usage of templates because if you have to make a change to a template, you would actually have to do it several times (once per floor). Keep in mind that for large Revit projects, the less templates you have, the better.

So, how would you solve the issue of having linked models with their Visibility/Graphics set to “By Linked View” on multiple levels without managing a template per floor?

First of all, in your View Template settings, uncheck the V/G Overrides RVT Links.

You cannot use this setting if you have linked views that point to specific levels unless you have a view template for each linked level.

View template settings for levels that use By Linked View in Revit.

Second, create a view template that ONLY controls the V/G Overrides RVT Links.

Think about how you would like to apply the linked views in batch and set your linked view in that template. For this example, I needed to create a template per level.

I realize I seemingly contradicted myself by having a template per level, but keep in mind that these templates are never assigned to views themselves – we will use them to apply the RVT Links settings only. So in the rare event that you need to changed your By Linked View settings, you are still saving an enormous amount of time by using these templates to manage your “backgrounds”.

Using Revit View Templates to manage linked models with V/G set to By Linked View.

Managing view templates when you need to use a linked view from a linked Revit model


Lastly, apply the template properties to all views that need to display the linked view in your template.

Select the multiple views that you need to have the same linked background (most likely every view per level) and right click and select Apply Template Properties from the menu. Note that applying a template’s properties to a view does not assign the template to that view. It will only apply the properties that aren’t controlled by the assigned template.

Apply view template properties to all views in Revit.

Power-user tip: Change your Project Browser organization to group the views by Associate Level so that you can easily select all views for each level easily.

Revit tip to group all views by level to easily apply view template per view for linked views.