0.10.1 Scenario Tree Filter

Available with the Following Subscriptions: All Subscriptions
Available for the Following Roles: All Roles

The Scenario Tree Filter feature allows users to customize what object types the Scenario Tree should list. Instead of browsing a static hierarchy, use Object Type and IFC properties as filters to "prune" the tree, displaying only the specific items relevant to the current task.

💡 Note: Filtering does not permanently remove objects or affect project’s sequencing; it simply hides nodes in the tree view to help navigate complex hierarchies more efficiently.

In this article, we cover:

• Object Filtering

• Level & Class Filtering

• Create Level and Class Filters via Property Assignment

• Managing the Filtered State

Object Filtering

The Object Type (1) is the primary filter for controlling which items remain visible in the tree.

• Selecting an object type (e.g., Massing, Zone, or Resources) hides all other nodes from the Scenario Tree.

• This enables working exclusively with specific object types while minimizing scrolling through the tree.

• Filtering out objects in the tree does not hide them in 3D. The 3D view and sequencing remain unaffected.

  

Level & Class Filtering

The Level and Class filters are specialized filters that become enabled only when at least one BIM Import is placed in the current scenario. These filters are dynamically generated based on the properties assigned to the BIM Elements.

💡Note: Unless specified during model creation, all BIM Elements properties set as "Undefined" by default; including Level and Class. cmBuilder allows for manually property assignment to make use of with Tree Filters. 

• The options available in both of these filters depend entirely on a BIM Model(s) properties' values.

  • Level Filter (2): If property values are defined as "Level 1," "Level 2," etc., these specific values appear as Level filter options list.

    

  • Class Filter (3): If properties such as "Slabs," "Walls," or "Columns" are defined, these specific values appear as Class filter options list.

    

Create Level and Class Filters via Property Assignment

Unless specified during model creation, all BIM Elements properties set as "Undefined" by default; including Level and Class. cmBuilder allows for manually assigning these values to make use of with Tree Filters. 

1. Select a BIM Element: Right-click a BIM Element in 3D or the Scenario Tree and select Edit BIM element.

   

2. Access Properties: Navigate to the Props tab (2) in the Side Sheet.

3. Define Values: Click the dropdown for Class or Level (3).

4. Type a new value (e.g., "Floor" or "Level 1") and select Create (4).

5. Alternatively, select an existing value from the list.

6. Filter Generation: Once a property is assigned to at least one element, the assigned value will automatically become available as a selectable option in the Tree Filter options list.

   

Managing the Filtered State

A dedicated area in the Scenario Tree displays the active filtering logic. These Filter chips adjust automatically. 

• Filter Chips: Applied filters appear as color-coded chips (1) at the top of the Scenario Tree. Chips are color coded as: Blue for Objects, Red for Levels, Purple for Classes.

  

• Automatic Categorization: When more than 6 filters are applied, the system automatically groups them by their respective categories. A summary chip will show the primary selection followed by a counter (e.g., Excavation +4) (2) to keep the interface scannable.

• Expand for Full View: Clicking the dropdown (3) on the filter bar expands the chip type category to reveal the full list of applied chips. Complete chip categories filters can un-applied by clicking the "X"  (4) on a chip category to restore specific node types to the Scenario Tree without resetting the entire tree structure.

• Selective Reset: Clicking the "X" on any individual chip instantly removes that specific filter and restores those nodes to the tree.