Your First Model Audit
A 15-minute walkthrough of your first Pyvoid model audit - from opening ReViewer to fixing your first warning.
Related tools
Your First Model Audit
In 15 minutes you will run a full health audit on a live Revit model, understand what the results mean, and complete one safe cleanup operation. By the end you will have a before-and-after score comparison and a clear picture of what to address next. Nothing in your model changes until you explicitly confirm it.
Before You Start
- Pyvoid installed and the tab visible in the Revit ribbon
- A project open - any file works, but a workshared model produces richer results because it captures sync-related warnings and workset clutter
- Sync with central before starting so your local copy reflects the current model state
Step 1: Open ReViewer (3 min)
Open the Health panel in the Pyvoid tab and click ReViewer, or press Ctrl+Shift+H.
The ReViewer window opens with all audit categories enabled by default. Leave them all on for your first run - a full scan gives you the complete picture. Partial scans are useful later once you know which categories to focus on.
Click Run Audit.
The scan runs against your open model. Depending on model size, this takes 10 to 60 seconds. When it finishes you will see:
- A health score - a numeric value from 0 to 100 reflecting overall model integrity
- Category breakdown - individual scores for Warnings, Views, Sheets, Families, Worksets, and Links
- Pass / Warn / Fail indicators - color-coded per category: green for passing, amber for issues worth reviewing, red for problems that need attention
Nothing in your model has changed. ReViewer is read-only - it inspects and reports; it does not write.
Step 2: Read the Results (3 min)
Start with the red items. A Fail in any category indicates a condition that is actively degrading model performance or data integrity. Click the category row to expand it and see the individual findings.
Click any finding row to select the corresponding elements in Revit. This makes it easy to inspect a problematic element in context without hunting for it manually.
The severity scoring works as follows:
- 0-49 (Fail) - significant issues present; immediate attention recommended
- 50-74 (Warn) - degraded but functional; schedule cleanup within the current phase
- 75-100 (Pass) - within acceptable thresholds for a live project
A score in the 50-74 range on a project mid-construction is normal. A score below 50 in Warnings or Views typically indicates accumulated technical debt that is already affecting sync times and file size.
Spend a moment reading through each category. Note where the biggest gaps are. You are not fixing anything yet - this pass is purely diagnostic.
Step 3: Visualize the Warnings (3 min)
Open the Health panel again and click Warning Visualizer.
Warning Visualizer presents your model's Revit warnings as charts rather than a flat list. The default view breaks warnings down by type, showing counts for each category: element overlap, inconsistent units, missing references, and others.
Identify the category with the highest count. This is typically where the most cleanup leverage exists - fixing one root cause (a wall join setting, a room separation line placement) can resolve dozens of warnings at once.
The chart view also shows warning trends if you have run previous audits. On a first run you will see only the current snapshot, which is enough to prioritize.
Note the top category. You will use this information when planning deeper cleanup work after this walkthrough.
Step 4: Fix One Thing (5 min)
The lowest-risk first cleanup is unused views. Unused views do not affect design data, they carry no coordination risk, and they are easy to identify. They are also a common source of file size bloat - a model with 200 unused 3D views and sections from early design phases can be 30-50 MB larger than necessary.
Open the Health panel and click Wipe Hub.
In Wipe Hub, select the Views category from the left panel. Wipe Hub will scan the model and populate a list of views that meet the unused criteria: not placed on any sheet, not used as a dependent view, not referenced by a viewport or callout.
Review the list before doing anything else. Scroll through it. If you see a view name you recognize as currently in use - a coordination view someone is working in, for example - uncheck it. The preview list is your safety gate.
When you are satisfied with the selection, click Apply.
Wipe Hub deletes only the checked items. The operation is undoable via Revit's standard Ctrl+Z if you need to reverse it.
Step 5: Measure the Improvement (1 min)
Return to ReViewer and click Run Audit again.
Compare the new score to the one from Step 1. The Views category score should have improved. If you had a large number of unused views, the overall model score may have moved several points.
This is the governance loop: audit, identify, fix, measure. You have just completed one full iteration. The score improvement is a concrete, repeatable metric you can track across project phases.
What's Next
A single pass through Wipe Hub views is a start. For a thorough cleanup across all categories - warnings, families, links, worksets, and sheets - see the Deep Cleanup workflow.
To understand how to build this into a recurring practice and track model health over time, read The BIM Governance Loop. That article covers how to structure audits at project milestones, how to set acceptable thresholds per project phase, and how to use ReViewer scores as a handoff gate between design phases.
For deeper background on what Revit warnings mean and how they accumulate, see The Complete Guide to Revit Warnings.
Last updated: 2026-04-16