Health Panel
Model audits, warnings analysis, cleanup, and standards enforcement.
Health Panel
The Health Panel is the primary workspace for model quality assurance, standards enforcement, and proactive cleanup. It contains 15 tools organized into six groups: Audit Tools, Visualizers, Conform Tools, Cleanup Tools, Standards Tools, Utilities, and Parameters. Run these tools consistently throughout a project lifecycle -- not only before milestones -- to prevent technical debt from accumulating. Each tool is designed to be non-destructive by default, showing previews before committing changes.
mindmap
root((Health Panel))
Audit
ReViewer
Visualizers
Warning Visualizer (Legacy Redirect)
Health Visualizer
Conform
Conform Names
Workset Conform
Cleanup
Wipe Hub
Overkill
Find Duplicates
Proxy Analyzer
Standards
Rename Sheets/Views
Material Studio
Spell Check
Parameters
Parameter Jammer
Bulk Editor
Color SplasherModel Auditing
ReViewer -- Model Health Dashboard
Assess your model's health at a glance before milestones, submissions, or handoffs. ReViewer runs configurable audits across categories -- file size, warnings, view counts, family bloat, and naming standards -- then presents results in a filterable dashboard with severity scoring and fix-it actions. Use it as the starting point for any cleanup workflow: run ReViewer first to identify problems, then jump to the appropriate tool to resolve them.
Key features:
- Configurable audit categories with enable/disable toggles
- Severity-scored results with color-coded pass/warn/fail indicators
- One-click navigation from an issue to the responsible element
- Trend tracking across audit runs to measure improvement
- Export audit reports to CSV or JSON for BIM coordination
Getting Started
- Open ReViewer from the Health panel (or press
Ctrl+Shift+H). - Select which audit categories to run, or leave all enabled for a full scan.
- Click Run Audit and wait for the scan to complete.
- Review results grouped by category -- click any row to select the element in the model.
- Use the Fix button on supported issues to apply automatic corrections.
- Re-run the audit to verify fixes and track your score improvement.
UI Overview
| Area | Description |
|---|---|
| Category sidebar | Enable or disable audit checks by category |
| Results grid | Issues listed with severity, element, and description |
| Summary bar | Overall health score with pass/warn/fail breakdown |
| Export menu | Save results as CSV or JSON |
Tips
- Run ReViewer at each project milestone to build a trend history.
- Disable categories you do not control (for example, linked model warnings) to keep the score meaningful.
- Combine with Wipe Hub and Conform Names for a full cleanup pass.
Executive Report
Generate a unified executive report combining model compliance, health, ROI savings, and audit results. The report stitches together the ReViewer compliance score, element-count and top-issue health metrics, Pyvoid time and cost savings, and an audit summary grouped by severity and source. Click to generate the report, review the preview window, then export as HTML or CSV for sharing.
Sections included:
- Model Compliance: ReViewer score breakdown by category
- Model Health: element counts, health score, top issues
- Pyvoid ROI: time saved, cost saved, annual projections
- Audit Summary: issue counts by severity and source
Use it for monthly status reports to leadership, milestone health snapshots, and ROI justification for license renewal.
Warnings and Visualization
Warning Visualizer
Warning Visualizer is now a legacy launch surface. Clicking the button redirects to Warning Center, which is the supported user-facing workflow for warning visualization, resolution, and reporting. The underlying Warning Visualizer implementation still exists in the codebase and continues to provide charting and warning-analysis capabilities behind the unified warning stack.
Current behavior:
- The legacy button opens Warning Center instead of a standalone Warning Visualizer window.
Ctrl+Shift+2is assigned to Warning Center.- Warning Visualizer remains relevant as an implementation/library surface and historical tool reference.
Getting Started
- Open Warning Center from the Health panel or press
Ctrl+Shift+2. - Use its warning visualization and reporting surfaces to review warning distribution and severity.
- Treat Warning Visualizer references as legacy/internal documentation unless you are working on the underlying implementation.
UI Overview
| Area | Description |
|---|---|
| Launch path | Deprecated wrapper that redirects to Warning Center |
| Supported workflow | Warning Center warning visualization, resolution, and reporting |
| Implementation note | Warning Visualizer charting/runtime code remains in lib/pyvoid/tools/warning_visualizer/ |
Tips
- Use Warning Center before and after cleanup to measure progress.
- Keep this page as a legacy reference for the underlying warning visualization implementation.
Health Visualizer
Get a visual overview of what your model contains and where data quality problems hide. Health Visualizer scans the document and presents element distribution as interactive charts, with two analysis tiers: QuickScan (~500ms) for a category-family-type hierarchy overview, and DeepScan for detailed geometry metrics and issue detection across 40+ issue types.
Key features:
- Two-tier analysis: QuickScan for fast hierarchy view, DeepScan for geometry and data quality metrics
- Interactive sunburst and treemap charts showing element distribution by category
- Drill-down navigation from category to family to type
- Issue detection across 40+ categories including missing data, duplicate geometry, and orphaned elements
- Export reports to CSV, Excel, or JSON
Getting Started
- Open Health Visualizer from the Health panel.
- The QuickScan runs automatically, building a hierarchy of all model elements.
- Click chart segments to drill down from category to family to type.
- Click Deep Scan for detailed geometry and data quality analysis (takes longer on large models).
- Review flagged issues in the results panel and click to select affected elements.
UI Overview
| Area | Description |
|---|---|
| Tree view (left) | Element hierarchy with counts and percentages |
| Chart panel (right) | Sunburst or treemap visualization |
| Breadcrumb bar | Shows current drill-down path with click-to-navigate |
| Deep scan results | Issues listed by severity after running DeepScan |
Tips
- Use QuickScan for daily checks -- it runs in under a second.
- Reserve DeepScan for milestone reviews where thoroughness matters more than speed.
- The chart auto-switches from sunburst to treemap above 2,000 elements for readability.
Group Health Report
Audit group types by instance count, nesting depth, text-note usage, and unused status. Use it before milestone cleanup to spot high-risk group patterns and export a CSV summary for project review.
Cleanup and Purge
Wipe Hub -- Batch Purge
Reclaim model performance by removing unused views, filters, templates, links, imported CAD, and other dead weight. Wipe Hub scans for items with zero usage and presents them in a categorized preview where you confirm deletions before anything changes. Unlike Revit's built-in Purge Unused, Wipe Hub covers a wider range of categories and shows exactly why each item qualifies for deletion.
Key features:
- Purge categories: unused views, schedules, view templates, filters, imported CAD, unplaced rooms, linked models, and more
- Usage analysis showing reference counts for each item
- Preview-then-confirm workflow -- nothing is deleted without your approval
- Selective deletion: uncheck items you want to keep
- Summary report of what was removed and disk space reclaimed
Getting Started
- Open Wipe Hub from the Health panel (or press
Ctrl+Shift+U). - Select which categories to scan, or leave all enabled.
- Click Scan to analyze the model for unused items.
- Review the results -- each item shows its type, name, and reason for flagging.
- Uncheck any items you want to keep.
- Click Purge to delete the remaining items in a single transaction.
UI Overview
| Area | Description |
|---|---|
| Category checkboxes | Toggle which item types to include in the scan |
| Results list | Flagged items grouped by category with select/deselect |
| Summary footer | Total items found, selected for deletion, and estimated size savings |
Tips
- Run Wipe Hub after completing a project phase when temporary views and filters accumulate.
- Pair with ReViewer to verify your model health score improves after purging.
- Items deleted through Wipe Hub are covered by Ctrl+Z undo.
Meta Purge
Scan and remove waste from your Revit model. Meta Purge identifies unused views, elements, CAD artifacts, and duplicate geometry across 69 cleaner categories, giving you a single entry point for deep cleanup that goes well beyond Revit's built-in Purge Unused.
Quick facts:
- Coverage: 69 cleaner categories spanning views, elements, CAD artifacts, and duplicate geometry
- Shortcut:
Ctrl+Shift+U
Overkill -- Remove Overlapping Elements
Eliminate accidentally stacked detail lines, filled regions, and other duplicates that inflate your model. Overkill scans the active view for identical elements occupying the same location and lets you review matches before deleting.
Key features:
- Detects overlapping lines, regions, and detail components
- Preview of matched pairs before deletion
- Works on the active view scope
How to use:
- Open the view you want to clean.
- Run Overkill from the Health panel.
- Review flagged overlaps and confirm deletion.
Standards and Naming
Conform Names
Bring inconsistent element names into compliance with your office standards. Conform Names applies a configurable transformation pipeline -- abbreviation expansion, prefix and suffix rules, case normalization, regex find-and-replace, and duplicate resolution -- then previews every change before applying. Save configurations as presets to reuse across projects.
Key features:
- Eight transformation steps: trim, remove specials, abbreviate, prefix, suffix, case, regex, and dedup
- Supports views, sheets, text notes, families, materials, and more
- Live preview comparing old and new names side by side
- Preset management for sharing standards across projects
- Custom rule editor for firm-specific naming patterns
How to use:
- Open Conform Names from the Health panel (or press
Ctrl+Shift+N). - Select the element categories to conform.
- Configure transformation rules or load a saved preset.
- Review the preview grid showing current versus proposed names.
- Click Apply to rename all matched elements in one transaction.
Workset Conform
Assign elements to the correct worksets automatically based on configurable rules. Workset Conform evaluates a hierarchy of rules -- phase-based, category-based, linked model detection, and scope box spatial queries -- to classify elements and preview changes before applying.
Key features:
- Hierarchical rule evaluation with configurable priority
- Rule types: phase, category, link host, and scope box containment
- Preview mode showing proposed workset assignments with match reasons
- Bulk application in a single transaction
- YAML-based configuration for sharing rules across projects
How to use:
- Open Workset Conform from the Health panel.
- Review the default rules or load a project-specific configuration.
- Click Preview to see proposed assignments and match reasons.
- Adjust rules if needed and re-preview.
- Click Apply to reassign worksets.
Spell Check
Catch typos and non-standard terminology across your project's text content. Spell Check scans text notes and parameter values using multiple dictionaries -- base English, construction terminology, acronyms, and a user-extensible custom dictionary. Results are grouped by source with suggested corrections.
Key features:
- Multi-dictionary support with construction and BIM terminology built in
- Scans text notes, sheet names, view names, and parameter values
- Custom dictionary for firm-specific terms
- Configurable ignore rules for abbreviations and codes
How to use:
- Run Spell Check from the Health panel.
- Select which text sources to scan.
- Review flagged words with suggested corrections.
- Accept, ignore, or add words to your custom dictionary.
Rename Sheets / Views
Batch rename sheets and views using case transforms, find-and-replace, prefix/suffix operations, or regex patterns. Select your target elements, configure the transformation, and preview results before applying.
Key features:
- Case transforms: UPPER, lower, Title Case, Sentence case
- Find-and-replace with optional regex
- Prefix and suffix operations
- Preview before applying
How to use:
- Run Rename Sheets/Views from the Health panel.
- Select the sheets or views to rename.
- Choose a transformation mode and configure settings.
- Review the preview, then click Apply.
Material Studio
Manage and standardize materials across your project. Material Studio provides utilities for MasterFormat classification, name normalization, usage analysis, and semantic duplicate detection to keep your material library clean and standards-compliant.
Key features:
- MasterFormat code assignment with NLP-based suggestions
- Semantic duplicate detection using fuzzy matching
- Usage analysis showing which elements reference each material
- Material grouping by prefix for library organization
How to use:
- Open Material Studio from the Health panel.
- Browse the material list with usage counts and classification status.
- Use the classifier to assign or correct MasterFormat codes.
- Review suggested duplicates and merge as needed.
Element Analysis
Find Duplicates
Eliminate accidentally duplicated elements that inflate your model and cause geometry overlap. Scans the active view for identical elements stacked at the same location using Levenshtein distance matching, and lets you keep or delete each pair.
Key features:
- Detects duplicates across line styles, text types, dimension types, and materials
- Configurable similarity threshold for fuzzy matching
- Preview of matched pairs before deletion
How to use:
- Run Find Duplicates from the Health panel.
- Select which categories to scan.
- Review matched pairs and choose which to keep.
- Confirm deletion of the duplicates.
Proxy Analyzer
Detect proxy elements left behind by removed third-party add-ins or scan-to-BIM imports. Proxy Analyzer calculates a Document Readiness Score (DRS) based on proxy severity, element counts, and workset distribution, then visualizes results with interactive D3.js charts.
Key features:
- Proxy detection across all element categories
- Document Readiness Score with severity weighting
- D3.js visualization of proxy distribution
- Recommendations for cleanup actions
- Export to JSON or CSV
How to use:
- Run Proxy Analyzer from the Health panel.
- Wait for the scan to complete.
- Review the DRS score and proxy breakdown by category.
- Follow the generated recommendations to address proxy elements.
Color Splasher
Visually audit parameter data through color coding. Color Splasher assigns graphic overrides to elements in the active view based on any parameter value -- unlike Revit's built-in Color Fill, it works on any category and any parameter.
Key features:
- Applies color overrides by any parameter value on any category
- Automatic color assignment with legend generation
- Works in the active view without modifying templates
How to use:
- Run Color Splasher from the Health panel.
- Select a category and parameter to visualize.
- Review the color map and adjust if needed.
- Click Apply to color elements in the active view.
Parameters
Parameter Jammer
Manage the full lifecycle of project parameters from a single interface instead of navigating Revit's scattered dialogs. Parameter Jammer covers creation, editing, mapping, migration, auditing, and deletion for shared parameters, project parameters, global parameters, and family parameters, with GUID resolution and standards compliance checking throughout.
Key features:
- Unified browser for all parameter types (shared, project, global, family)
- Create parameters with automatic shared parameter file management
- Bulk edit parameter values across elements
- Map and migrate parameters between types or categories
- Audit for duplicates, orphans, and standards violations
- Safe deletion with dependency checking
Getting Started
- Open Parameter Jammer from the Health panel (or press
Ctrl+Shift+J). - Browse existing parameters in the main grid, grouped by type.
- To create a parameter, click Create and fill in the wizard fields.
- To audit, click Audit to scan for duplicates, orphans, and violations.
- Select parameters and use the toolbar for edit, map, migrate, or delete operations.
- Review previews before confirming any changes.
UI Overview
| Area | Description |
|---|---|
| Parameter grid | All parameters listed with type, group, data type, and category bindings |
| Toolbar | Create, edit, map, migrate, audit, and delete actions |
| Detail panel | Shows full metadata for the selected parameter |
| Audit results | Issues grouped by type with fix suggestions |
Tips
- Run an audit before creating parameters to avoid duplicates.
- Use the mapper to transfer parameter values when consolidating types.
- Export your parameter definitions to JSON as a backup before bulk operations.
Bulk Editor
Edit hundreds of parameter values at once without Dynamo or manual element selection. Bulk Editor presents elements in a filterable spreadsheet grid (AG Grid in WebView2) where you click cells to edit, then apply all changes in one transaction.
Key features:
- Spreadsheet-style editing powered by AG Grid
- Query elements by category, active view, or current selection
- Inline cell editing with type validation
- Chunked data loading (500 rows) for large datasets
- Thread-safe Revit API access via ExternalEvent
- Column sorting, filtering, and customization
Getting Started
- Open Bulk Editor from the Health panel.
- Select a category and scope (model-wide, active view, or current selection).
- Click Load to populate the grid with elements and their parameter values.
- Click any cell to edit its value -- changes are highlighted in yellow.
- Review all pending edits in the change summary.
- Click Apply to write all changes to the model in one transaction.
UI Overview
| Area | Description |
|---|---|
| Query bar | Category selector and scope toggle (model/view/selection) |
| Data grid | AG Grid with sortable, filterable columns for each parameter |
| Edit cells | Click to edit; changed cells highlight in yellow |
| Status bar | Element count, pending changes, and apply button |
Tips
- Use the selection scope to work on a targeted set of elements rather than the whole model.
- Sort by a column to group similar values and spot inconsistencies.
- Changes are applied in a single transaction -- use Ctrl+Z to undo the entire batch.
Related Articles
- The Complete Guide to Revit Warnings - every warning type explained with severity and remediation
- The BIM Governance Loop - how Health panel tools connect into a systematic governance process
- Your First Model Audit - 15-minute hands-on walkthrough using ReViewer
- The Deep Cleanup - pre-milestone cleanup workflow using Health panel tools
Last updated: 2026-04-16