Revanalyticx user guide

01Overview

Revanalyticx is an add-in for Autodesk Revit that compares linked point clouds against the elements in your model and tells you, surface by surface, how far apart they are — then helps you record, classify, coordinate and report what it found. It lives in its own Revanalyticx 4.1 tab on the ribbon and never needs you to leave Revit or export anything first.

A typical session looks like this:

1. Link the scan (.rcp / .rcs) as you normally would, then colour it from the Point Clouds panel so you can read it.
2. Select the elements you care about and run Model vs Point Cloud. Lay a Gridded Inspection on any face that needs numbers rather than colours.
3. Inspect or Hover Probe anything that looks off, record it with Annotate, check Statistics for the pass rate, then Export PDF.

Revit — Revanalyticx 4.1 tab

02System requirements

03Installation

You will receive a signed installer, Revanalyticx4.1.exe, together with your activation key. The installer looks for every supported Revit release on the machine and registers the add-in for each one it finds.

Using the installer

1. Close Revit.
2. Run Revanalyticx4.1.exe. If Windows SmartScreen appears, choose More info › Run anyway.
3. Finish the wizard. It installs for your Windows user only — no administrator rights needed.
4. Start Revit. The first time, Revit asks whether to load the add-in — choose Always Load.
5. Look for the Revanalyticx 4.1 tab at the right-hand end of the ribbon.

Updating or removing

To update, simply run the newer installer over the existing one — your licence and settings are kept. To remove the add-in, use Windows Settings › Apps › Revanalyticx 4.1 for Revit › Uninstall; it removes itself from every Revit release it was installed into.

04First launch & licence

Revanalyticx needs an activation key before it will run. Until one is entered, pressing any analysis command opens the activation window instead — paste the key there and the command carries on.

1. Open any project and go to the Revanalyticx 4.1 tab.
2. On the Revanalyticx panel at the far right, click License.
3. Paste the key from your email and click Activate. The window shows how long the licence has left.

The licence is re-checked in the background from time to time. If you are offline the plugin keeps working through a grace period, so a site visit without Wi-Fi does not stop you.

Two more buttons live nearby and are easy to mix up:

05Point Clouds panel

These commands change how Revit draws the point clouds in the active view. Nothing here changes the data, and everything can be undone by pressing the button again or by Ctrl+Z.

06Model vs Point Cloud

This is the core check. It samples the surfaces of the elements you choose, measures every sample against the nearest scan data, and colours the model by how far apart they are.

1. Select the elements to check — walls, floors, columns, structural framing, ducts and pipes are all supported.
2. Click Analysis › Model vs Point Cloud.
3. Set the tolerance bands and their colours, the sampling density (how many points per surface) and the search distance (how far from the surface to look for scan points — 50 mm is a sensible start).
4. Click OK. The heat map is drawn over the elements in the active view.

Reading the result

• Colours follow the bands you set — a negative value means the scan sits inside the modelled surface, a positive one outside.
• No Data marks areas the scan never covered. It is shown as its own state rather than as a deviation, so a wall behind a pallet does not look like a failure.
• The heat map is a visualisation layer over the model. Drawing it or clearing it never alters an element.

The results are cached with the view. Inspect, Hover Probe, Statistics and Export PDF all read that cache, so nothing is measured twice and every number agrees with the colours on screen. Use Annotations › Clear to take the heat map off the view.

07Gridded Inspection & Annotate Grid Points

Where Model vs Point Cloud tells you whether a face is out, Gridded Inspection tells you where, with exact, regularly spaced QA/QC points that the site team can find again.

1. Run Model vs Point Cloud first — Gridded Inspection works on an analysed face.
2. Click Analysis › Gridded Inspection and select one planar face.
3. Align a local U/V grid in project length units (500 mm is typical for floors, 1 m for façades) and preview the surface-clipped intersections. Openings are skipped automatically.
4. Calculate. Every valid point gets XYZ, 3D, signed and normal deviation; points without scan coverage stay No Data. The complete point table exports to CSV.

Annotate Grid Points

Labels the points a Gridded Inspection has already measured — nothing is measured again. Click one point, click several, drag a selection window, or annotate every point in the current element, the selected elements, the active view or the whole inspection. Each label keeps the point's own ID and its stored surface deviation — optionally X, Y, Z and the coordinate — with a leader to the exact point and automatic offsets that avoid other labels. A density and tolerance filter keeps dense grids readable, and existing ID labels are extended rather than duplicated.

08Statistics

Histogram, cumulative compliance and QA/QC verdicts from the cached deviation results — both Model vs Point Cloud and Gridded Inspection samples — without measuring geometry again.

• Point- or area-weighted histograms, cumulative percentage and tolerance compliance.
• PASS / FAIL against your tolerance, per element and per grid.
• Select a bar to highlight where those values sit in the model.
• Place a printable Revit legend in the view for the drawing set.
• Export the detailed table and a summary to CSV.

09Inspect & Hover Probe

Two ways to read a number off the heat map. Both read the stored analysis and never re-measure, so what you read always matches what you see.

10Annotations panel

Annotations are how findings leave Revanalyticx and reach the people who fix things. They are stored in the model, so they survive saving and go to whoever reviews it next.

11Object Classify

Assigns BIM classification data across the model from a rule table you keep: Assembly Code (Uniformat), OmniClass number and title, a Mark numbered per category, Comments, workset, phase, and a project or shared parameter of your own.

• Shows exactly what would change before anything is written — including which writes land on a type and so reach every instance of it.
• Fills blanks without touching what is already there, unless you say otherwise.
• Exports the run as CSV. One Ctrl+Z undoes the lot.

12BIM: family type names

Two checks that read and, when you approve, rewrite the model's own naming. Neither ever deletes, merges or overwrites: names that already exist are reported as conflicts.

13Clash Detection

Finds where any two physical elements occupy the same space. The engine reads geometry rather than categories, so walls against walls, walls against casework, beams against ducts, pipes against pipes and the host model against a linked model all work the same way.

1. Click Coordination › Clash Detection.
2. Choose set A and set B — by category, by the current selection or by picking. Categories can be ticked from this model and from any loaded link.
3. Set a tolerance in the project's own units and decide whether elements that merely touch should count.
4. Run. Every clash gets a permanent id. Show takes you straight to it in a reusable 3D view with a fitted section box and both elements coloured.
5. Add a status and a comment, step through with Previous and Next, and re-run later to see what has been fixed.

The results export to Excel with element ids, unique ids, levels, worksets, model names and coordinates — enough for another team to find each clash without the model open.

14Export PDF & Options

Other exports live with their own tools: CSV from Gridded Inspection, Statistics, the Annotations window and Object Classify; a printable report from the Annotations window; Excel from Name Checker and Clash Detection.

15Keyboard shortcuts

Every command has a default shortcut. They are digit pairs because Revit's own shortcuts are almost all letters, so they do not collide. Install them once from Point Clouds › Settings; after that they are ordinary Revit shortcuts you can change in View › User Interface › Keyboard Shortcuts.

16Troubleshooting

The Revanalyticx 4.1 tab is missing

• Make sure Revit was closed while the installer ran; if not, close Revit and run the installer again.
• If Revit asked about loading the add-in at start-up and you chose Do Not Load, run the installer again and choose Always Load next time.
• Check that the Revit release you opened is one the plugin supports (2022 – 2026).
• If Revit showed a "could not load" dialog at start-up, note the message and send it to us with Help & Info › Feedback.

A command opens the activation window

• No key has been entered yet, or the licence has expired. Paste the key and the command continues.
• Check the expiry under Revanalyticx › License; About shows the current licence state as well.

Everything shows as No Data

• Increase the search distance — a poorly registered scan can sit 30–80 mm off the model.
• Make sure the cloud is linked into the active document and visible in the view (a cloud inside a linked RVT is not analysed).
• Check the scan actually covers those faces — line of sight matters.

Gridded Inspection will not start

• It needs one analysed planar face. Run Model vs Point Cloud on the element first, then pick a flat face.

Analysis is slow

• Lower the sampling density, or run on a selection rather than everything in the view.
• Hide clouds you are not checking with Show / Hide and use a section box in the view.

Sending us a log

Click Help & Info › Feedback. It opens a message to info@axisbuildbim.com in your own mail program with the product version, your Revit release and the licence state already filled in. Nothing is sent until you send it.