Skip to main content

Model cleaning

Model cleaning
Show in Revit

Several Revit applications are running. Choose one:

This is a free plugin!
Remove objects of certain categories from the model with the ability to remove unused elements

Icon

mprCleaner_32x32 mprCleaner_16x16 mprCleaner_32x32_dark mprCleaner_16x16_dark

Related news and articles


Using

The plugin contains different cleaning options for the model, which differ in the way they can be used. The cleaning options are divided into separate tabs:

For each clearing option, multiple selection is available in the list. Selection is performed by holding down the Ctrl or Shift key and clicking with the left mouse button.

BASIC CLEANING

The tab settings window at the top contains a tool for setting up and using model cleaning configurations. To create a new configuration, click on plus and check the necessary items in the list. The current configuration can be renamed square edit outline or deleted delete outline.

1

The middle part of the window contains a list of actions that can be performed to clean the model. This list may vary depending on where the plugin is running (in the project or in the family editor), as well as on the content of the project. For example, in a file configured for collaboration, the option Remove all elements in workset "..." will be available, and the option Remove all empty worksets will be present starting with Revit version 2023. In the list, you must check the items that you want to apply to clean the model.

For a quicker orientation among the positions, you can use the search bar.

2

For a quick selection of the necessary items there are tools:

checkbox multiple marked circle outline – select all items in the list;
checkbox multiple blank circle outline – deselect all items in the list;
format list checks – switch (invert) the selection of items in the list.

Clear – starts cleaning on the selected items in the list.

Deletion on some items in the list is irrevocable.

VIEW TEMPLATES

The tab contains a list of view templates in the project.

It is possible to find out whether view templates are used in the project and to see which view they are applied to by clicking on the link Show. The data in all columns can be sorted by left-clicking on the column header.

3

At the bottom of the window are the tools:

Applied view templates – when cleaning starts, view templates that have been applied to views are either skipped or deleted along with the view template links.

4

Remove selected (...) – start clearing the selected templates.

VIEW FILTERS

The tab contains a list of all view filters, as well as information on which template and on which views they are used.

5

To start cleaning, select the filters and click the Remove selected (...) button.

VIEWS

The tab contains a list of views of the current document, except for Schedules. For each view, it displays information about the sheets on which the view is placed. You can delete all views except the active one. Also from this tab (and from the Schedules tab) you can open a view by double-clicking it.

13

To start cleaning, you should select the views and click the Remove selected (...) button.

SCHEDULES

The tab contains a list of Schedules that are in the project, as well as information on which sheets the Schedules are placed.

6

To start cleaning, select the Schedules and click the Remove selected (...) button.

PROJECT PARAMETERS

The tab contains a list of project parameters, and there is also an option to search the parameter in Schedules, families (types and instances placed in the model), Project Information and filters by pressing the Search button.

12

To start cleaning, select the parameters and click the Remove selected (...) button.

SHARED PARAMETER

To form a list of shared parameters, click on the Collect button.

The tab displays a list that also contains information about the parameters:

  • Parameter name;
  • Guid – unique identifier of the parameter;
  • Project parameters – whether the shared parameter has been added to the project parameters;
  • In current SPF by Guid – whether the parameter is used in the current SPF by Guid (where SPF – Shared Parameter File);
  • In current SPF by name – whether the parameter is used in the current SPF by name.

There is also an option to search the parameter in Schedules, families (types and instances placed in the model), Project Information and filters by pressing the Search button.

7

To start cleaning, select the parameters and click the Remove selected (...) button.

UNUSED SHARED PARAMETERS

To form a list of unused shared parameters it is necessary to click the Search button. Searching for unused shared parameters may take some time, because it will require opening all families (including nested families) in the project.

You can display a list of all shared parameters when searching for unused shared parameters using the Open a list of all found shared parameters in Notepad option.

In the tab you will see a list, which also contains information about the parameters:

  • Parameter name;
  • Guid – unique identifier of the parameter;
  • In current SPF by Guid – whether the parameter is used in the current SPF by Guid (where SPF – Shared Parameter File);
  • In current SPF by name – whether the parameter is used in the current SPF by name.

8

It is possible to open the list of unused shared parameters in the text editor "Notepad" using the Open in notepad button.

To start cleaning, select the parameters and click the Remove selected (...) button.

UNPLACED ROOMS

In the tab, there is a list of rooms that are not placed and are in the project.

Unplaced rooms are rooms that have been deleted from the view, but they are not deleted from the project and remain in its database. If necessary, these rooms can be placed again in another view keeping the room properties (name, finishing materials).

9

To start cleaning, select rooms and click the Remove selected (...) button, or remove all rooms using the Remove all (...) button.

UNPLACED SPACES

The tab has a list of spaces that are not placed and are in the project.

10

To start cleaning, select spaces and click the Remove selected (...) button, or remove all spaces with the Remove all (...) button.

UNPLACED areaS

The tab has a list of areas that are not placed and are in the project.

10

To start cleaning, select areas and click the Remove selected (...) button, or remove all areas with the Remove all (...) button.

LOOKUP TABLES

The tab is only available in the Family Editor. The tab contains a list of Lookup Tables imported into the family, as well as information about using the table.

14

To start cleaning, select the tables and click the Remove selected (...) button.

LINE PATTERNS

This tab is intended for finding and removing unused line patterns in the project.

16

When the Search button is clicked, the plugin searches for project elements that use the selected line pattern.

Consider element graphic overrides – when this option is enabled, the plugin additionally analyzes element graphic overrides in views.

To start the cleanup, select the line patterns and click the Remove selected (...) button.


After applying some clearing options, a window displaying the cleaning results will appear.

11

New
Fixed an error due to which the window with the plugin results could end up behind the Revit window
Improved
The interface was migrated to the current version of the ModPlus styling library
Improved
Added display of element IDs in the error handling window
Improved
Added the ability to copy element IDs to the clipboard in the error handling window
New
Added grouping of cleanup options in the "Basic cleaning" tab
New
Added "Line Patterns" tab
New
Reworked the cleanup option processing mechanism in the "Basic cleaning" tab
Fix
Fixed an error with deleting the active view
Fix
Fixed an error with deleting unused elements
Fix
Fixed an error with deleting view templates
Improved
On the "Views" tab, a note has been added if a dependent view is placed on a sheet
New
"Delete all unused view templates" option added to main cleanup
Fix
Fixed an error that prevented lookup tables from being deleted
Improved
Small improvements in the algorithm for finding unused shared parameters
Fix
Fixed a bug where sorting on some columns of some tables did not work
Fix
Fixed a Shared parameter collection error occurring when running the plugin in a family
New
Added search in all sections
New
Added "Project parameter" column in the "Shared parameters" section
New
Added "Unplaced areas" section
Improved
Added the ability to rename a configuration in the "Basic cleaning" section
Fix
Skipping specialized elements when deleting elements in the workset
Fix
Fixed an error occurring when trying to collect parameters from families with cyclic dependency
Fix
Unused lookup tables: fixed an issue where lookup tables were not taken into account if multiple tables were specified in a formula
Fix
Fixed the algorithm for determining the used lookup tables, taking into account that a table can be specified in quotes
Fix
Fixed the algorithm for determining the used lookup tables, taking into account that the size_lookup function can have different number of arguments
New
Added "Lookup Tables" tab that allows to find and remove unused lookup tables
New
Added option to display a list of all shared parameters when searching for unused shared parameters
Improved
Added search for parameters in nested families when searching for unused shared parameters
Fix
Fixed "The referenced object is not valid" error occurring in some cases when deleting all groups
Improved
Changed parameter export format when opening in Notepad on the "Unused Shared Parameters" tab
Improved
Added processing of selection filters on the “View filters” tab
New
Added a new tab "Views"
New
Added "Delete all unused views" option to the basic cleaning
New
Added "Delete all empty work sets" option to the basic cleaning
Improved
Added display of the number of selected options in the basic cleaning tab
Improved
In the “Views” and “Schedules” tabs, added the ability to double-click to open a view
Improved
Family instances are now also considered when searching for a parameter's usage
New
The option "Remove all Unreferenced views (Legends only)" has been added to the basic cleaning
New
he option "Remove all unused Level types" has been added to the basic cleaning
New
The option "Remove all unused Grid types" has been added to the basic cleaning
New
Added search in filters when searching for parameter usage
Fix
Fixed an error that didn't show an icon on the ribbon
Improved
Changed icons
Fix
Fixed an error that could delete views placed on sheets when selecting the "Delete all views without references" option
Fix
Fixed an bug that caused project parameters not to be deleted
New
Added "Project Parameters" tab
Improved
Added a check for using a parameter in the Project Information
Fix
Fixed fatal error when deleting configurations in the "Basic cleaning" tab
Improved
Optimized parameter lists when there are a large number of parameters
Improved
Added missing sorting in some lists
Improved
Returned the algorithm for finding unused Shared Parameters, which requires opening families
New
Rewritten the algorithm for finding unused shared parameters
New
In the list of shared project parameters added ability to find in which families or schedules parameter is used
Improved
Removed obtaining of project shared parameters when loading the plugin
Improved
Fixed closing of the plugin window when deleting view templates
Improved
Added column sorting in tabular data
Improved
Improvements have been made to the method of removing unused elements
New
Added a basic cleanup "Remove all Line Patterns"
New
In the "View templates" tab, you can now open the list of views that have a template assigned to them
New
Added basic cleaning configurations
New
Added basic cleanup "Remove all Sheets (except open) with Views on them"
New
Added basic cleanup "Ungroup all groups (without deleting)"
Fix
Fixed error at startup if incorrect path to shared parameters file is specified in settings
New
Added removing of unused groups
New
Added information about availability of shared parameters in current SPF
New
Added option to display unused common parameters in the notepad
Improved
Fewer items in the main cleanup when running in a family
Improved
Safe read and delete shared parameters (continue processing if error occurred)
New
Added ability to delete unplaced spaces
New
Added ability to delete unplaced rooms
New
In the "View Filters" section, added collection and displaying of filters not used in views or templates
New
Added an option to delete project shared parameters (without checking their usage)
Improved
Removed mandatory re-search after deleting unused shared parameters
Fix
Fixed an error which caused non-drawn elements in tables to be selected
Fix
Ignoring the "View does not belong to a project document" error
New
Added the ability to remove selected view filters
New
Added the ability to delete selected schedules
New
Added the ability to remove unused shared parameters
New
Changed the layout of the plugin window
FIX
The work of the plugin is divided into tabs
FIX
Added a tab for work with the view templates
FIX
Added the ability to remove the coordination models
FIX
Added deletion of uploaded links for the option "Delete all linked files"
FIX
Added saving of checked status of the wipe options