2.2.5 Model Diagnostic Tool

6 minutesread

The Model Diagnostic Tool will provide diagnostic information on the model before analysis starts. It will highlight issues which may interfere with successful analysis.

Model Diagnostic Tool

Model Diagnostic Tool to help audit the Revit Model

Find the Model Diagnostic Tool on the Welcome Screen (top left).  A window will open where you may Start the Tool.  Building Elements is currently the only option for this feature.  This does not affect your ability to analyze the model later (you may later use either Spatial Elements or Building Elements to analyze the model).

Model Diagnostic Tool

Click on ‘Start’ to launch the tool

Note: Options may appear differently in the drop-down list (support for Mass Models is currently in development).

Model Diagnostic Tool

Main window of the Model Diagnostic Tool

Allow the Viewer to load.  Depending on the complexity and size of the model, processing time will vary.  The default view will open (the Energy Model View).  This will display the Analytical Spaces and Surfaces. Items in the panel on the left may be expanded and Surface Types may be reviewed. If there are missing Surfaces, it will indicate a modeling issue (enclosure issues, element functions etc).

Model Diagnostic Tool

Energy Model View

Hovering over an item in the list will highlight its location in the Viewer. The Revit ID is also displayed for each item.

Model Diagnostic tool

Hover over an item or use the checkbox

Model Diagnostic Tool

Hover over Analytical Spaces to highlight in the Viewer

Rooms may also be checked in the Tool.  If Rooms have not been placed on a level, it is easy to review these in the Viewer.

Model Diagnostic Tool

Rooms highlight in the Viewer 

Model Diagnostic Tool

Level Planes may be viewed

Model Diagnostic Tool

3D Grid may be turned on/off as required

Room Bounding elements in the model may be reviewed.  The Viewer will help to reveal if any elements are not Room Bounding. This button is only available once you are in the Standard 3D View.  This will reveal if walls, floors or roofs are not room bounding.  It may be correct or intended that some elements are not room bounding and so the User should make decisions on whether these notifications need attention or are as expected.

Room Bounding Elements

Room Bounding elements may only be reviewed

Summarizing the workflow so far and moving onto testing for model issues:

1. Click on the Model Diagnostic Tool in the Splash Screen

2. Click on Start in the next dialog window

3. Wait for the Tool to load model elements

4. In the Energy View, Analytical Surfaces, Spaces and Rooms may be reviewed

5. Levels may be turned on if required to locate Level Planes

6. Click on the Standard View button to view model element categories

7. Click on Test to start the model analysis

8. Hover over Revit ID’s in the list to review elements

9. Check the box beside items in the list on the left-hand side to review warnings

Then click on the Standard 3D View button. Then click on the Test button to start analysis of model issues.

Room Bounding Elements

Use the Test button to start model analysis

Two categories will appear in the right-hand panel under Project Warnings:

1. Building Elements

2. Energy Model

Room Bounding Elements

Project Warnings appear after the Test button is used

A list will appear in the panel on the right-hand side under the headings Building Elements and Energy Model.  Issues will be listed here if properties are missing of if the application finds issues which may require attention.

Users may use these lists as a guide and some issues may not be critical.  A list of warnings is provided at the bottom and will reduce as issues are attended to (the Tool will need to be reloaded to update the references and remaining warnings).  Hovering over an item will display its location on the model.

Room Bounding Elements

Hover over an item in the list to view the element

Expand the list using the arrows to review any warnings.  Hover over an item’s Revit ID in the list to view the location of the problem element in the Viewer.

Warning symbols also appear in the list on the left-hand side to indicate issues.

Room Bounding Elements

Click on an item to view details

In the left-hand panel, items may be selected and will display in the viewer.  Information is also provided in the lower panel on thermal properties, Revit Family name, Family Type and Room Bounding status.

The list may be toggled between Categories and Hierarchy. This is only available in the Standard 3D View.  Categories display typical element types in the model.  Hierarchy displays a more technical list matching Revit’s tree list logic and object styles (OST) and is useful for finding specific elements.

Room Bounding Elements

List sorting options

Hovering over entries in the list will highlight and isolate that element in the Viewer.  Checking the box beside that element will display more details of properties and parameters relating to that element.

Revit ID numbers are also listed and may be searched by inputting a value on the left-hand panel ‘Building Elements’.  Project warnings on the right-hand panel also includes the Revit element ID.  This may be useful for finding the element in the model to resolve any issue.

Note: It is important that internal walls have an Internal function and external walls have an External function in Revit.  Walls with an External function are included in the Energy analysis.  Floors similarly should have correct functions (Ground Floors should have an External function).  Roof elements will always have an external function and this parameter is not editable in Revit.

Note: As issues are resolved – reload the Model Diagnostic Tool to update the changes (the list of issues will not adjust automatically while the model is modified, as it will need to be reloaded and the new status of the model analyzed).

Room Bounding Elements

As issues are fixed in the model, the warnings list will reduce


The model may be orbited in the Viewer by using the right mouse button. Shift + right mouse button allows panning in the Viewer.  The scroll wheel on your mouse may be used to zoom in/out.

Orbit = Drag right mouse button

Pan = Shift + Right mouse button

Zoom = Scroll wheel on mouse


6 minutesread

Related Knowledge Base Posts


    Type your search string. Minimum 4 characters are required.

    Scroll to Top