Creating Dataflows - Set Targets

Sakari Lehtinen
Sakari Lehtinen Expert (Gold)
  • Updated

Most of the tools and dataflows have a target. A target is a set of objects that the tool or dataflow processes.

The targets are defined with controls with a green background. Note that you can preview the selection by clicking the magnifying glass button.

simplebim_dataflows_target_preview.png
Previewing the Target selection.

There are several ways to choose the objects. Let's go through them with an example. The model has a Curtain Wall assembly object, which has Members and Plates as its parts (children).

simplebim_dataflows_target_all_containment.png

All

Selects all elements from the model. For assemblies, this selects both the assembly parent and its parts (children).

simplebim_dataflows_target_all.png
All the objects, also both the assembly parents and parts, are selected.

 

Topmost

Selects all elements that are either topmost assemblies or not part of any assembly.

simplebim_dataflows_target_topmost.png
All the objects, but no assembly children, are selected.

Parts

Selects all non-spatial elements that are either parts of assemblies (including assemblies that are part of another assembly) or are not part of any assembly.

simplebim_dataflows_target_parts.png
All the objects, but no assembly parents, are selected.

Object Class

Selects a single object class and all of its instances from the model.

simplebim_dataflows_target_object_class.png
All instances of an object class are selected.

Object Class List

Selects multiple object classes and all of their instances from the model. Check from the dropdown list the object classes you want to use.

simplebim_dataflows_target_object_classes.png
All instances of multiple object classes are selected.

Object Group

Selects either the group, groups, or all the object instances assigned to the groups. The behavior depends on the tool or dataflow you are using.

simplebim_dataflows_target_group.png
Only objects assigned to the group are selected. In this case, only external walls (not all the walls) 

The group or groups can be selected in a few different ways. The special options <any category> and <all groups> select all the groups from the model. If a category is defined, then all the groups from that category.

A common pattern in dataflows is that you first define groups with the Add or Modify Group tool and then use these groups in the following dataflow steps.

Choose Category

There are several predefined categories for groups in IFC and Simplebim. These can be related to IFC groups, zones, systems, other resources, and also to so-called type objects.

When you choose a category, you then have an option to either choose a group from that category or all groups with the special option <all groups>. The group selector dropdown will be filtered according to your category selection.

Choose Group

Type in the group name or select a group either from all the groups in the model or from a specific category. The special option <all groups> will select all the groups from the defined categories.

Object Selection

You can select the objects by dragging and dropping objects on top of the control, either from the 3D palette or other palettes like Properties, Objects, or the Containment palette. You can drag multiple times, even one object at the time, if you like. If you make a mistake, dropping on top of the minus, the objects will be removed from the selection.

The tool or dataflow will remember the objects based on their GUIDs (Global Unique Identifiers). 

simplebim_dataflows_target_selection.png
Select object by dragging from any of the palettes, for example, from 3D.

Custom

The selection syntax in Simplebim is close to the search syntax used, for example, in Microsoft Outlook. It consists of one or more tokens with values. The token-value pairs are separated from each other with a space. A token is separated from its value with a colon. If the value is a list, the items in the list are separated by a comma. If the value contains a space, comma, or colon, it must be wrapped in double quotes. All tokens and values are case insensitive, and whitespace before and after is ignored.

class-name:wall

class-name:wall,"curtain wall"

category-name:"IFC System" group-name:"Exhaust air"

Syntax Definition
special:all
s:all
All non-spatial elements. For assemblies selected both the assembly and its parts.
special:topmost
s:topmost
All non-spatial elements that are either topmost assemblies or not part of any assembly.
special:parts
s:parts
All non-spatial elements that are either parts of assemblies (including assemblies that are part of another assembly) or are not part of any assembly.
wall
auto:wall
a:wall
Automatically detect the type using the following resolution order
– Object class key
– Object class name
– Object group name (all group categories)
class-name:wall 
cn:wall
class-name:wall,"curtain wall"
All objects in one or more object classes matched by name
class-key:DC:WALL 
ck:DC:WALL 
All objects in one or more object classes matched by key
group-name:"exhaust air" 
gn:"exhaust air"
All objects in an object group matched by name
group-guid:<guid> 
gg:<guid>
All objects in an object group matched by globally unique ID
category-name:"IFC System" 
gcn:"IFC System"
All objects in all object groups in a group category matched by name. This syntax can also be use for selecting all object groups in a group category.
category-key:IFC:GROUPS:SYSTEM 
gck:IFC:GROUPS:SYSTEM 
All objects in all object groups in a group category matched by key. This syntax can also be use for selecting all object groups in a group category.

Related to

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.