Real Time Data Visualization for Revit with Vyssuals.com

This article shows you how to use vyssuals.com for visualizing Revit model data.

Currently supported Revit versions: 2024, 2023, 2022

>>> All data stays locally on your computer, no data is sent anywhere.

Take a look at the usecases

Getting Started

Download the Revit connector from vyssuals.com

Download and install the Vyssuals Revit Connector from vyssuals.com. This is a lightwheight Add-in for Revit that manages the data synchronization between Revit and vyssuals.com

Once you have installed the connector, open Vyssuals like so:

  1. Start Revit
    1. Go to Add-ins tab
      1. Click 'Start' in the Vyssuals section

        The Connector Interface

        Auto Sync

        Enables automatic synchronization with vyssuals.com. Use with care, with great power comes great responsibility. Large models might take a long time to process, that's unfortunately just how the Revit API works.
        Auto Sync is turned off by default.

        Update Data

        This is your way to manually send data to vyssuals.com. It gives you more control over when you want to refresh the data.

        Update Name

        You can give your updates a name to identify them more easily later on.


        Show Rooms

        Shows rooms in 3D. Enable this to allow Vyssuals to use rooms.

        Show Areas

        Shows areas of the selected area scheme(s) in 3D. Enable this to allow Vyssuals to use areas.

        Show Vyssuals

        This just opens vyssuals.com in your web browser. It's just a shortcut, you can open vyssuals.com however you want.

        Disconnect

        This will close the Vyssuals Connector but all your data will remain available in the web app.


        Useful Keyboard Shortcuts

        Tipp: Isolate the elements you're interested in by using the 'HI' keyboard shortcut. This makes it easier to understand your charts.

        • IC: Isolate category of selected object
          • HI: Isolate selected object
            • HH: Hide selected object
              • HR: Show all hidden objects again

                Add A Chart

                Grouped by a text parameter
                Grouped by a number parameter
                Data Source

                Select a datasource. You can send data from as many Revit models as you like. You can also import CSV files.

                Chart Types

                There are 4 chart types at the moment.

                • Bar
                  • Doughnut
                    • Total
                      • Timeline
                        Update

                        Every Time the Auto Sync send new data or when you manually send data a new update will be available. You can leave it a "Use Latest", which will always show the most recent data, or you can choose a specific update if for example you want to compare updates against each other.

                        Show Values Of

                        Choose the name of the parameter you want to calculate value of.In a bar chart this will be the y-axis.

                        Group By

                        Choose the name of the parameter you want your data grouped by.In a bar chart this will be the x-axis. If you select a number parameter you can choose the start and end colours for a gradient that the data groups will be coloured by. If you select a text parameter, unique colours will be automatically assigned.

                        Subgroup 1

                        The parameter for breaking down groups created by 'Grouped By'.

                        Subgroup 2

                        One more level of subgrouping.

                        Color Selectors

                        At the moment you can only auto-assign colors. You get the chance to control the start and end color of the auto-applied color gradient though (if you are grouping by a number parameter).

                        Sync Colors To Revit

                        Click on a chart to make it automatically sync its colors to the corresponding Revit elements.

                        Click a chart to sync the colors to Revit