Overview

HUBAROC (Human-Assisted Semi-Automatic Resolver of Clash in BIM) is a guided, human-assisted workflow to prepare the model, detect clashes and resolve them directly inside Revit.
This guide takes you through clash resolution step by step: from model setup to validated results.

Things to keep in mind before you start:

• One MEP service model – Open an individual Duct, Pipe or Cable Tray model with the coordination models linked.
• Finish setup first – Complete configuration, clearances, geometry simulation, MHAT and grouping first.
• Bring in your clashes – Import a Navisworks / CSV clash list, or detect clashes directly with KlashBIM.
• Move or Bend – Resolve clashes one at a time, or across a whole grouped system.
• Lock what must stay – Use Logical Pinning to stop selected services from moving.
• Check what changed – Review newly created clashes and fix connections with Error Logs and Auto Connect.

Key Buttons

• Login (Welcome window) – Sign in with your HUBAROC credentials. Step 04
• Create/Update Project Config (Hubaroc tab) – Builds a reusable JSON config (works in HUBAROC and BAMROC). Step 05
• Run HUBAROC (Hubaroc tab) – Opens the Clash Resolution Wizard, starting with the guidelines. Step 06
• Start Geometry Simulation (Wizard · Geometry Simulation) – Simulates project geometry using your alignment choice. Step 11
• Run Analysis (Wizard · MHAT) – Finds disconnected MEP elements before resolution. Step 12
• Add Group (Wizard · Grouping) – Collects the elements of one connected MEP system. Step 14
• Use Navisworks Report / Use KlashBIM Report (Wizard · Klash BIM) – Import an external clash list, or detect clashes in HUBAROC. Step 15
• Navigate (Clash Resolution HUD) – Jumps to the selected clash in the Revit model. Step 18
• Resolve (Clash Resolution HUD) – Applies the chosen Move or Bend strategy. Step 18
• Highlight System / Filter Selection / Clear Filter (Clash Resolution HUD) – Narrows the clash list to a system or element, or resets it. Step 19
• Clash Detection tab (Clash Resolution HUD) – Lists new clashes created while you resolve; Add or Reject each. Step 21
• Logical Pinning tab (Clash Resolution HUD) – Pin services from the base or linked file so they never move. Step 22
• Error Logs tab · Auto connect (Clash Resolution HUD) – Lists post-resolution connection errors and reconnects them. Step 23

Workflow at a Glance

Six phases, 23 steps: follow them in order for reliable clash resolution.

• 01 Prepare Revit – Steps 01–03: set up revit, visibility settings, section box
• 02 Configure – Steps 04–11: log in, create config, Run HUBAROC, load config, clearances, max bend angles, max movement, geometry simulation
• 03 Connectivity – Steps 12–14: run mhat, fix disconnections, group mep systems
• 04 Load Clashes – Steps 15–17: choose clash input, klashbim tests, klashbim results
• 05 Resolve – Steps 18–19: resolve clashes, filter by system
• 06 Validate & Fix – Steps 20–23: validate results, new clashes, logical pinning, connection errors

Step 01 – Set Up Revit Before HUBAROC

Phase 01 · Prepare Revit

1. Open your MEP service model – Open the individual Revit file you want to resolve: Duct, Pipe or Cable Tray.
2. Link coordination models – Link the Structure, Architecture and other MEP models into this file, and confirm they align before you continue.

▶ Watch the tutorial

Step 02 – Configure Visibility Settings

Phase 01 · Prepare Revit

1. Select the 11 MEP categories – In the Visibility/Graphic Overrides window, tick the 11 MEP categories used for clash resolution.
   Shortcut: VV
2. Add Structure & Architecture – Optional. To include them in clash resolution, also tick: Structural Framing, Structural Columns, Structural Beam Systems and Columns.

▶ Watch the tutorial

Step 03 – Use a Section Box

Phase 01 · Prepare Revit

1. Apply a section box – Tick Section Box in the 3D view’s Properties, then drag its edges around the area you want to resolve.
2. Isolate the clash area – Working on one area at a time helps isolate clashes before you run HUBAROC.

▶ Watch the tutorial

Step 04 – Log In to HUBAROC

Phase 02 · Configure

1. Launch HUBAROC – Open the HUBAROC software. The welcome window appears.
2. Log in – Click Login and sign in with your HUBAROC credentials.

▶ Watch the tutorial

Step 05 – Create Your Project Config

Phase 02 · Configure

1. Open Project Configuration – On the Hubaroc tab, click Create/Update Project Config.
   Recommended route
2. Go through the 5 steps – Config File, Clearance, Geometry Simulation, MHAT and Grouping: the same screens as in Run HUBAROC.
3. Finish to save it – On the Grouping step, click Finish. The config is saved as a JSON file that works in both HUBAROC and BAMROC.

▶ Watch the tutorial

Step 06 – Run HUBAROC & Review Guidelines

Phase 02 · Configure

1. Run HUBAROC – Click Run HUBAROC and read the guidelines. They cover: Linked models, Reference ceiling, MEP boundaries, Connectivity and 0 mm clashes.
2. Confirm and continue – Check your project meets every requirement, tick the confirmation box and click Continue to Configuration.

▶ Watch the tutorial

Step 07 – Load Project Configuration

Phase 02 · Configure

1. Upload your project config – Upload the JSON config you created in step 05, or click Create New Configuration to set one up here.
   Then confirm each step that follows
2. Choose categories – Select or skip categories, such as Water Pipes and Sprinkler Pipes, based on whether they belong in the resolution.

▶ Watch the tutorial

Step 08 – Set Maintenance Clearances

Phase 02 · Configure

1. Enter the maintenance gaps – Enter the clearance you need for ducts, pipes, cable trays and mechanical equipment.
   All values in mm
2. HUBAROC keeps the gap – When it resolves a clash, HUBAROC keeps this gap between the elements that were clashing.

▶ Watch the tutorial

Step 09 – Set Maximum Bend Angles

Phase 02 · Configure

1. Enter the bend limits – Enter the maximum bend angle, in degrees, that HUBAROC may use for ducts, pipes and cable trays.
2. HUBAROC stays within them – When HUBAROC bends an element to clear a clash, it never uses an angle steeper than the limit you set.

▶ Watch the tutorial

Step 10 – Set Maximum Movement

Phase 02 · Configure

1. Limit how far services move – Enter the maximum distance, in mm, that HUBAROC may move a duct, pipe or cable tray.
2. Keep systems in their zone – HUBAROC never pushes a system further than this, so no service is moved out of its allotted zone.
3. Save your settings – Optionally tick Move air terminals with connected ducts, then click Save Settings and Continue to Simulation.

▶ Watch the tutorial

Step 11 – Simulate Project Geometry

Phase 02 · Configure

1. Choose the project alignment – Select Yes if the model follows a clear North–South alignment. Select No if it has special geometry or no standard alignment.
   Use a 3D view with Section Box on
2. Start the simulation – Click Start Geometry Simulation. HUBAROC uses your alignment choice to simulate the project geometry before resolving clashes.

▶ Watch the tutorial

Step 12 – Check Connectivity with MHAT

Phase 03 · Connectivity

1. Set the detection distance – Enter the proximity range, in mm, that MHAT uses to check relationships between nearby MEP elements.
2. Run the analysis – Click Run Analysis to find disconnected elements that could affect clash resolution and need fixing.

▶ Watch the tutorial

Step 13 – Review MHAT Disconnections

Phase 03 · Connectivity

1. Inspect each disconnection – Use Focus On Error or Open 2D View to review each detected disconnection and the element pair involved.
2. Choose how to connect – Use Auto Connect to physically reconnect the elements, or Accept the pair as a logical connection for HUBAROC’s resolution.
3. Save and close – Work through the list with Next, then click Save Changes and Close.

▶ Watch the tutorial

Step 14 – Group Related MEP Systems

Phase 03 · Connectivity

1. Create or use groups – Use the existing groups, or click Add Group to collect the elements that belong to one connected MEP system.
2. Resolve systems together – HUBAROC treats every element in a group together, so a resolution is applied consistently across the whole system.
3. Move on – In Run HUBAROC, click Next. In Project Configuration, click Finish to save your config.

▶ Watch the tutorial

Step 15 – Choose How to Add Clashes

Phase 04 · Load Clashes

Pick one option:

1. Upload an existing clash list – Click Use Navisworks Report to import a clash report made outside HUBAROC, or drag and drop a CSV file into this area.
2. Detect clashes with KlashBIM – Click Use KlashBIM Report to create clash tests and detect clashes directly in HUBAROC. The next two steps show how.

▶ Watch the tutorial

Step 16 – Set Up KlashBIM Clash Tests

Phase 04 · Load Clashes

1. Add a clash test – Click Add Test. The test appears in the table with its clash counts.
2. Select the files to check – In Clash Settings, choose the model files on each side that should be checked against each other.
3. Set categories and tolerance – Select the relevant categories for each set and enter the tolerance for clash detection.

▶ Watch the tutorial

Step 17 – Review KlashBIM Clash Results

Phase 04 · Load Clashes

1. Open the Results tab – Switch from Clash Settings to Results to see the clashes the test detected.
2. Check each clash – Review the status, severity and the two elements involved, and use Navigate to inspect each clash in the Revit model.
3. Use these clashes – Once you’re satisfied, click Use these clashes to load the validated list into HUBAROC for resolution.

▶ Watch the tutorial

How HUBAROC Resolves: Move or Bend

Both work on one clash or a whole selection, and both keep the maintenance gaps you set.

• Move – Relocates the clashing element or run clear of the obstruction, up to the Max Movement you set (Step 10). Best for runs with free space around them.
• Bend – Adds bends and offsets around the obstruction, within the Max Bend Angles you set (Step 09). Best for runs that must keep their route and ends.

One Selection, Two Results

In the Bending vs Movement video, the same 32 clashes on a grouped pipe bundle are resolved twice.

Step 18 – Resolve Clashes in HUBAROC

Phase 05 · Resolve

1. Select a clash – In the Clash Resolution HUD, pick a clash from the Active ClashList, or click Navigate to jump to it in the Revit model.
2. Choose Move or Bend – Pick the resolution strategy in the selector at the bottom of the HUD.
3. Click Resolve – Resolve clashes one at a time, or as grouped system elements.

▶ Watch the tutorial

Step 19 – Filter Clashes by System or Element

Phase 05 · Resolve

1. Highlight System – Click Highlight System to show only the clashes in the selected MEP system.
2. Filter Selection – Select an element in the model, then click Filter Selection to show only the clashes connected to it.
   Clear Filter shows the full list again

▶ Watch the tutorial

Step 20 – Validate Resolved Clash Results

Phase 06 · Validate & Fix

1. Check each clash’s status – After resolution, the Status column shows where every clash stands: Unresolved, Approved, Resolved, New Clash, Deleted and Manual.
2. Update a status – Click a clash’s status to change it from the drop-down list.
3. Navigate and verify – Click Navigate to revisit each clash and confirm the fix was applied correctly.

▶ Watch the tutorial

Step 21 – Review New Clashes During Resolution

Phase 06 · Validate & Fix

1. Open Clash Detection – This tab lists any new clashes created while you resolve the main clash list.
   Refresh Clashes updates the list
2. Add or reject each one – Click Add to put a valid new clash into the main list for Move or Bend, or Reject to dismiss it.

▶ Watch the tutorial

Step 22 – Control Resolution with Logical Pinning

Phase 06 · Validate & Fix

1. Pin services that must stay – In the Logical Pinning tab, use Pin from Base File or Pin from Linked File to pin services you don’t want moved.
2. Check what is pinned – Pinned elements are listed below. Highlight Pinned Elements shows them in the model; click x to unpin one.
3. HUBAROC works around them – Pinned services stay put. HUBAROC resolves clashes using other elements or approaches instead.

▶ Watch the tutorial

Step 23 – Fix Post-Resolution Connection Errors

Phase 06 · Validate & Fix

1. Open Error Logs – HUBAROC logs any disconnections or improper connections created while bending or moving elements. Click Refresh to update the list.
2. Inspect each error – Use Focus on error or Open 2D view to see the affected elements.
3. Reconnect and mark – Click Auto connect to make minor adjustments and reconnect the elements, then Mark resolved or Mark unresolved.

▶ Watch the tutorial

The Result: Clash Resolution Inside Revit

The same model before and after HUBAROC: the circled clashes are cleared without leaving Revit.

• Resolve directly in Revit – View, navigate and apply resolutions inside Revit, without switching back to Navisworks.
• Navisworks only for the clash file – Once the clash file is loaded, every resolution step happens in Revit. Navisworks isn’t needed to resolve.

Video Tutorials

Watch HUBAROC in action.

▶

▶