How to Use Revit Parameter Audit Tool in Dynamo Player

🎯 Dynamo Player Usage Guide

Step-by-Step Instructions for Revit Parameter Audit Tool

📋 Overview: This tool audits and cleans up Revit project parameters. Follow these steps exactly to use it safely in Dynamo Player.

1Open Dynamo Player

  • In Revit, go to Manage tab
  • Click Dynamo Player
  • Click Browse to folder icon
  • Navigate to where your .dyn script file is saved
  • Find "Data Checker V11 Final" and click Edit inputs icon

    • PHASE 1: SAFE ANALYSIS RUN

    2Configure Inputs (Analysis Mode)

    📁 1. Select Folder to Save CSV

    Click Browse... and select a FOLDER (not a file)

    Example: C:\Users\YourName\Desktop\Reports

    📝 2. Report File Name Prefix

    Type a descriptive name for easy identification

    Example: ProjectABC-Audit-2025-09-17

    💾 3. Export Report to CSV?

    Set to True (check the box)

    ⚠️ 4. DANGER: Auto-Delete Duplicate Parameters?

    Set to False (uncheck the box)

    CRITICAL: Must be False for analysis run!

    ⚠️ 5. DANGER: Auto-Delete EXTRA Parameters?

    Set to False (uncheck the box)

    CRITICAL: Must be False for analysis run!

    📋 6. Correct Categories (Comma-Separated)

    Paste your standard project categories list

    Pipes, Pipe Fittings, Pipe Accessories, Mechanical Equipment, Plumbing Fixtures, Ducts, Duct Fittings, Duct Accessories, Air Terminals, Electrical Equipment, Electrical Fixtures, Cable Trays, Conduits
    If you don't see this input, scroll down or expand the Dynamo Player window!

    📋 6. Correct Categories (Comma-Separated)

    Paste your standard project categories list

    Pipes, Pipe Fittings, Pipe Accessories, Mechanical Equipment, Plumbing Fixtures, Ducts, Duct Fittings, Duct Accessories, Air Terminals, Electrical Equipment, Electrical Fixtures, Cable Trays, Conduits
    If you don't see this input, scroll down or expand the Dynamo Player window!

    3Run Analysis

    This is SAFE - no changes will be made to your model

    Wait for completion: You'll see "Run Completed" message when finished

    4Review the Generated Report

  • Navigate to the folder you selected in Step 2
  • Open the file ending with "_Targeted_Audit.csv"
  • Key sections to review:

    • 🔍 Important Report Sections:

  • "ACTION: PARAMETERS TO BE DELETED" - Your deletion preview
  • "COMPLIANCE CHECK: MISSING PARAMETERS" - What should be added
  • "UNBOUND PARAMETERS" - Parameters not assigned to categories
  • "UNUSED PARAMETERS" - Parameters with no values
  • "INVENTORY" - Current parameter count summary
    • STOP HERE! Only proceed to Phase 2 if you agree with all proposed deletions in the report.

    PHASE 2: CLEANUP EXECUTION

    ⚠️ WARNING: This phase will permanently modify your Revit model. Only proceed if you're satisfied with the Phase 1 analysis.

    5Enable Cleanup Actions

    Go back to Dynamo Player and modify the danger toggles:

    Option A: Clean Up Duplicates Only

    Set "4. DANGER: Auto-Delete Duplicate Parameters?" to True

    Keep "5. DANGER: Auto-Delete EXTRA Parameters?" as False

    Option B: Clean Up Extra Parameters Only

    Keep "4. DANGER: Auto-Delete Duplicate Parameters?" as False

    Set "5. DANGER: Auto-Delete EXTRA Parameters?" to True

    Option C: Full Cleanup

    Set BOTH toggles to True

    This performs all cleanup actions in one run

    6Execute Cleanup

    FINAL WARNING: This will permanently modify your model!

    Monitor progress: Wait for "Run Completed" message

    7Verify Results

  • A new CSV report will be generated (overwrites the previous one)
  • Open the new report file
  • Check the "ACTION LOG" section at the top - this shows what was deleted
  • Verify the "INVENTORY" section shows the cleaned parameter counts
  • The "PARAMETERS TO BE DELETED" section should now be empty
    • ✅ Success! Your Revit model parameters have been cleaned up according to your specifications.
    💡 Pro Tips:
    • Always start with Phase 1 (analysis) before making changes
    • Keep a backup of your Revit model before running Phase 2
    • Review the CSV report carefully before proceeding to cleanup
    • If you make a mistake, close Revit without saving and reopen your backup