Find Objects
Find Objects (Find) · IfcHopper > Utilities
Finds objects in a model or below an object by IFC class, name, GlobalId and property values. Found objects can be deconstructed, modified and applied back with Apply Edits. Objects read from a file are loaded as the search reaches them (not their geometry).
Inputs
| Name | Type | Access | Description |
|---|---|---|---|
| Model (M) * | Generic Data | item | IfcHopper model, or a project, site, facility, part, storey, space or object to search below. |
| Classes (C) | Text | list | IFC classes, e.g. IfcWall, IfcDoor, or IfcBuiltElement for all built elements; an object matches one of them. Empty: any class. |
| Exact Class (EC) | Boolean | item | True: only the classes given, not their subclasses. Default: False. |
| Name (N) | Text | item | Name pattern with * and ? wildcards, ignoring case, e.g. wall. Empty: any name. |
| GlobalIds (Id) | Text | list | GlobalIds (22 characters) or GUIDs; an object matches one of them. Empty: any. |
| Properties (P) | Text | list | Property and quantity filters, all of which must match: Set.Property (it exists) or Set.Property op value with op =, !=, <, <=, >, >=, e.g. Pset_WallCommon.IsExternal = true or Qto_WallBaseQuantities.Length > 5 (lengths, areas and volumes in document units). Sets of the object's type count. |
* Required.
Outputs
| Name | Type | Access | Description |
|---|---|---|---|
| Objects (O) | Generic Data | list | Found objects, in tree order: spatial objects, elements, element parts and openings. |
| Elements (E) | IFC Element | list | The found objects that are elements (also parts and openings), previewed in their colours. |
| Parents (Pa) | Generic Data | list | Parent of each found object: its spatial object, the element it is a part of, or the element an opening voids. |
| Paths (Pt) | Text | list | Names of the objects above each found object, e.g. Project / Site / House / Ground floor. |
| Classes (C) | Text | list | IFC class of each found object. |