119eaa1e-467f-5fb1-a199-ab0ce31eb1e3:5wZ4XsXcAZy0HxzXD4598h

ConstructionSequence_Resources.zip

ConstructionSequence_Complete.zip

Introduction

Setting Up the Revit Project

Running the Custom Viewer in Unity

Next Steps

Creating a Construction Sequence Viewer

The metadata from BIM models provide powerful identifying data that can be used to create custom functionality. In this tutorial, we’ll use the data from a Revit model to create a slider that shows/hides objects based on their projected completion dates. 

Adding New Viewer Functionality

The metadata from BIM models provide powerful identifying data that can be used to create custom functionality. In this tutorial, we’ll use the data from a Revit model to create a slider that shows/hides objects based on their projected completion dates.

The Reflect Package installed via the Package Manager

The Unity custom package “CreatingConstructionSequenceViewer_Resources.unitypackage” 

A Revit installation with an activate Reflect plugin

For this sequence viewer to work, you need to prepare a Revit project by adding specific metadata to the Scene. A sample Revit model with the metadata already set up is provided in the resources files for this tutorial. 

1. Open a Revit project you wish to use. We used the sample project that is installed with Revit (Figure 01).

2. Go to the Manage Tab and select Project Parameters in the Settings section (Figure 02).

3. Create a new project parameter called “Completion Target” and fill out the rest of the options as shown. Take care to expand all the options under the categories and make sure everything is checked (Figure 03).

4. Now, the tedious part. Take your time and select all the elements in the Scene that should be part of a phase. Once all are selected, add a completion date in the properties panel in the format of month/day/year. Unity will be converting this text to a date when you run the scripts (Figure 04). 

5. Keep repeating this process until all the elements in the Scene have a target completion date. Tip: Hide the elements as you assign a completion date. This will make it easier to keep track of what still needs a date assigned. 

6. When all elements have a date assigned, unhide everything and export the model again to Reflect using the Export View option in the Unity tab (Figure 05).. 

Figure 01: Open your project in Revit

Figure 02: Open the Project Parameters

Figure 03: Creating a new Project Parameter

Figure 04: Adding the completion dates to the individual elements

Figure 05: Export the updated model from Revit to Unity Reflect

For this project, we’re going to use a custom viewer created by Brian Bare, solutions engineer at Unity. This viewer contains a slider and scripts that will search for the specified metadata, create a list of dates based on the imported dates, and then hide and show elements based on the dates assigned to them.

1. Install the Unity Reflect package via the Package Manager.

2. Download and import the “CreatingConstructionSequenceViewer_Resources” package from the Tutorial Materials tab.

3. Add the custom viewer to the Scene by dragging the Reflect Custom Viewer Sequencing Prefab from Assets > Custom Reflect Viewer > Prefabs to the Scene Hierarchy (Figure 06).

7. Expand this custom viewer Prefab and select Canvas > Completion Canvas (Figure 07). 

8. In the Inspector, add the metadata field you will be using to retrieve the dates to the Parameter slot. This is the parameter that was set up in Revit. In this tutorial, we used  Completion Target (Figure 08). 

9. Run the project and import the Revit model you exported. Select the construction sequence button (Figure 09).

10. A slider will appear. As you move the slider back and forth, it will iterate between the dates specified in the metadata and show/hide elements based on their status (Figure 10). 

Figure 06: Add the custom viewer to the Scene

Figure 07: Select the Completion Canvas element

Figure 08: Add the parameter that contains the completion dates

Figure 09: The new construction sequence button

Figure 10: The construction sequence slider

Open and study the scripts to gain an understanding of how the metadata is passed and how it’s used to populate the slider. The scripts can be found under Assets > Custom Reflect Viewer > Scripts.

Creating a Construction Sequence Viewer

1. Introduction

2. Setting Up the Revit Project

3. Running the Custom Viewer in Unity

4. Next Steps

Complete this tutorial