Running AI Analysis

AI analysis is where ClashWise turns a flat list of published clashes into a triaged worklist. You assign a clash matrix — your rulebook of element-class pairings mapped to priorities, statuses, and responsible contacts — and the AI applies it across the whole set. Every clash comes out stamped with a matched rule, a recommended priority, a recommended status, and a responsible contact.

The intelligence comes from your rules: the AI reads each clash's elements, matches them against your matrix, and applies what the matrix says. There are no fixed, built-in engineering rules — refining the matrix is how you tune the results.

Who can use it

Running analysis requires a signed-in account with a clash matrix assigned to the set. Creating and editing matrices requires an active Clash Management subscription (Pro, Business, trial, or open beta). AI analysis does not consume Wise actions — it has its own daily analysis-runs quota, shown on the USAGE QUOTAS card of your Profile page (see the Account, Plans & Billing section, Usage and AI Quotas).

Before you start: assign a matrix

In the set header on the Clash sets page (https://clashwise.ai/my/clash-sets):

The matrix dropdown ("Associated clash matrix to run analysis") selects which matrix the analysis applies.
If no matrix is assigned yet, a Generate matrix pill offers to build one from this set — the 3-step wizard is covered in the Clash Matrix section. The More (⋯) menu also has Generate matrix from this set….
If the previously assigned matrix was deleted, the dropdown warns "⚠ PREVIOUS MATRIX DELETED" — assign another before running.

Without a matrix, the Recommendations columns don't exist, recommended-field filters are hidden, and Apply defaults… is disabled ("Assign a matrix to this clash set first").

Running the analysis

Select the clash set and confirm the right matrix is chosen in the dropdown.
Click Run analysis. A confirmation appears: "Analysis started successfully."
Watch progress on the strip — "ANALYZING CLASHES {processed}/{total} · % · ETA" — and on the set's sidebar row, which shows an ANALYZING badge with the same progress and estimated time remaining.
To halt a run, click Stop analysis (the Run analysis button becomes Stop analysis while running; the sidebar shows STOPPING).

Analysis runs in the background — you can keep working while it processes.

What happens next

Each clash's Matched Rule links to the rule that classified it; recommended Priority, Status, and Responsible Contact fill in from that rule.
The icon before each clash title reports its analysis state: a green check ("Analyzed on {date} - Rule: {rule}"), a warning if no matching rule was found, or red if the clash is un-analyzed.
A ✨ icon on the Matched Rule means one or both element classifications were AI-inferred rather than read directly from the model.
The Insights button in the set header becomes available once analysis completes (until then its tooltip reads "Analysis not completed yet").

Apply defaults in bulk

After analysis, you can stamp the matrix's default status, priority, and contact onto many clashes at once: select rows (or apply a filter), then click Apply defaults… in the bulk bar. This is useful for accepting recommendations across a whole slice of the set in one action.

Manual edits and the analysis lock

When you hand-edit a clash's recommendation fields, the clash is marked as manually edited and a lock icon appears by its title: "Manually edited — excluded from future analysis. Click to unlock and re-include."

While locked, re-running analysis will not overwrite your manual values.
Click the lock to unlock the clash and let the next analysis update it again.

Stale analysis — when things change after a run

Analysis results are a snapshot. Two advisories tell you when they've gone stale:

The matrix changed — a ⟳ warning appears on the Matched Rule column when the matrix was edited after the analysis; a re-run is advised.
The set changed — when new clashes arrive after an analysis (for example after an update from the plug-in), the per-set progress guide shows "This set changed since the last analysis" with Open matrix → and ▶ Re-run analysis buttons.

Re-running analysis re-evaluates the set with the current matrix and data (manually locked clashes stay untouched).

Clearing an analysis

More (⋯) menu → Clear analysis… removes everything the analysis produced: recommended priorities, statuses and contacts, matched rules, summaries, and analysis dates. The confirmation is explicit: "This can't be undone. Edits you made by hand will be cleared too."

Use it when you want a genuinely clean slate — for example before re-analyzing with a fundamentally restructured matrix. If you just want updated results, a plain re-run is safer: it refreshes recommendations without destroying manual edits on locked clashes.

Tips

The per-set progress guide (the pill at the right of the review bar) walks you through the whole flow — ✨ Generate matrix → Open matrix → → ▶ Run analysis — and unlocks each step as its prerequisite is met.
Fix classification problems in the matrix, not clash-by-clash: one corrected rule can re-classify thousands of clashes on the next run.
Clashes flagged "No matching rule found" are your matrix's blind spots — open the matrix, add coverage for those element pairings, and re-run.

Limitations

Analysis cannot run on a saved filtered view — views inherit results from their parent set (their header shows "MATRIX INHERITED FROM PARENT"). Run analysis on the parent.
Recommendations exist only while a matrix is assigned; deleting the assigned matrix leaves the set warning "⚠ PREVIOUS MATRIX DELETED".
Clear analysis… cannot be undone and also removes hand-made edits.
Analysis results live in ClashWise until you push them back into Navisworks with the plug-in's Sync feature.