Revision Report Viz

Produce the visual half of a revision narrative in one click. Revision Report Viz opens a modeless window with two linked charts over the current document:

• A horizontal revision timeline keyed on Revision.SequenceNumber, with tooltips showing the parsed date, description, and how many sheets each revision touched.
• A per-sheet column chart of revised sheets only (by default), sorted by how many revisions each sheet accumulated.

One click on Export PNG saves a theme-consistent image named <project>_revisions_<yyyymmdd>.png - ready to paste into the issue narrative.

When to use this tool

• Issue-cycle narratives. You are preparing a DD, CD, or IFC issue and the Principal expects a "what changed and which sheets took the beating" summary.
• Principal debriefs. Someone asks "which revision hit the most sheets?" - the timeline tooltip answers in 10 seconds.
• Consultant-coordination snapshots. Run it before and after accepting a consultant model update to see exactly which sheets moved.

Prefer the raw text table (Excel-ready rows, per-cloud marks, comments)? Use Generate Revision Report instead - it lives in the same pulldown.

Why SequenceNumber instead of RevisionDate

Since Revit 2020, RevisionDate is a free-text field. Firms type "For Issue", "IFC Set", "04/12", ISO, US, or EU dates - anything. Any chart that trusts RevisionDate as a time axis silently renders wrong on projects with a single quirky date entry.

Revision Report Viz axes the timeline on SequenceNumber (an integer). A tolerant parser attempts to read RevisionDate for tooltip display only: ISO-8601, US slash, EU slash, and long-form month names all parse; anything else shows - rather than a silently wrong date.

What's read-only about this tool

Revision Report Viz is a reporting tool. It never opens a transaction, never writes a parameter, and never touches the model. Opening and closing the window cannot break anything. The viz is safe to run in a modeless loop during a coordination meeting while the Principal asks questions.

Empty states

• No revisions in the model yet. The window renders a centered "Create a revision in Revit's Revisions dialog to populate this report" message.
• Revisions exist, but no sheets are revised yet. The timeline renders normally; the per-sheet column chart shows "Place a revision cloud on a sheet to populate this chart."

Keyboard shortcuts

• Ctrl+E - Export PNG
• Escape - Close the window

Feature flag

Set the environment variable PYVOID_REVISION_REPORT_VIZ_ENABLED=0 to disable the pushbutton without unloading the extension. The script logs a DEBUG line and returns without opening the window.

Last updated: 2026-04-24