Auto-Assign Containment: Building Storeys

The Auto-Assign Containment: Building Storeys tool assigns objects to the building storey in which their geometry is located. 

Note: This tool does not split objects that span multiple building storeys. If you want to split objects, then use the Split Objects tool.

This tool is useful when the BIM authoring tool does not assign objects to the correct building storey or doesn’t even properly support the concept of building storeys.

By default, this tool uses the building storeys that are already defined in the model. You can use add or override building storeys to add new building storeys or redefine the building storeys' elevations in the model.

Settings

Target

Defines objects that are assigned to building storeys. Note that you can run the tool multiple times with different settings for different kinds of objects. 

You can use the tool just to add empty building storeys to the model, or redefine the elevations of building storeys. In those cases target does not do anything, and you can leave it to the default setting.

Add Building Storeys

Add new building storeys to complement the existing ones in the model. This is optional. If you want to use the existing building storeys, leave this setting empty.

The building storey information is encoded as a string with the following format. You should replace everything within <> with your own values. Building storeys are separated with '|' character.

If you only have one site and building in your model, then you can use a simple format for the values: 

name=<name1>;level=<level1>|name=<name2>;level=<level2>

If you have multiple site and/or building objects in your model, you need to define explicitly to which site and/or building you want the building storeys to be added.

site=<site name>;building=<building name>;name=<name1>;level=<level1>|site=<site name>;building=<building name>;name=<name2>;level=<level2>

Or if you have only one site object, but multiple buildings, then you can use this:

building=<building name>;name=<name1>;level=<level1>|building=<building name>;name=<name2>;level=<level2>

For example, the following value would add the buildings storeys to the model as shown in the picture: 

name=My Building Storey 1;level=0|name=My Building Storey 2;level=3000

Note that with this format, you can only add building storeys to the model, not site or buildings.

Note: if you define building storeys with the same name as existing building storeys, then new ones with the same name are added. If you want to override the level information of the existing ones and/or add new ones, then use the Override Building Storeys setting instead.

Override Building Storeys

Use Override Building Storeys is you want to redefine the elevations of the existing buildings storeys. This is optional. If you want to use the existing building storeys as they are, leave this setting empty.

If a building storey with the same name already exists, the existing building storey object is preserved, and only the elevation = level is set as defined. The format for the value is the same as for Add Building Storeys.

For example the following value will change the elevaltions of the existings building storeys as shown in the picture.

name=Ground Floor;level=1000|name=1st Floor;level=4000

Check Building

Defines whether to check that the building element will be assigned under the same building as it was originally in the model tree. This is relevant only when there are multiple building objects in the model.

Assign Objects

Defines whether to assign objects to building storeys. Otherwise, the tool only adds building storeys or changes the elevations as defined above.

Use Lowest Point for Columns

Defines whether to use the lowest point for assigning columns. Otherwise, the geometric midpoint is used. This is useful, for example, with the structural model, where there can be column objects which extend through multiple building storeys.

This setting is used if the Assign Objects is on.

Use Lowest Point for Multi-storey Objects

Defines whether to use the lowest point for assigning multi-storey objects. Otherwise, the geometric midpoint is used. See the picture for the columns above.

This setting is used if the Assign Objects is on.

Use Highest Point for Slabs

Defines whether to use the highest geometric point for assigning slabs, and also if the Tolerance for Slabs is used as defined below. Otherwise, the geometric midpoint is used.

This setting is used if the Assign Objects is on.

Tolerance for Slabs

Defines how much lower the slab's highest point can be below the building storey's lowest point, when Use Highest Point for Slabs is on.

This setting is used if the Use Highest Point for Slabs and Assign Objects is on.

Add Missing Sites and Buildings

Defines whether to create the standard site-building structure if missing. Sometimes your model is missing the basic model tree structure. This setting enables you to define the default Site and Building to the model tree.