Support site for Simplebim users
Split Geometries

This tool makes it possible to apply the Location Tools functionality to models from a script or template. This tool can not be run from the simplebim user interface.

Configuration Options

Key

SPLIT_TYPE

Defines which objects are split

Value
ALL All objects (default)
MARKED Resolves and splits objects according to the Split attribute values.

LOCATIONS_ONLY

Resolves location only for all the objects. No splitting will occur.
Key

SPLIT_ASSEMBLIES

Defines how assemblies are split

Value
ON Splits assemblies based on the locations of the assemblies' children.
OFF Does not split assemblies. (default)
Key

ASSEMBLY_CHILD_LOCATION

Defines how locations are assigned when assemblies are split

Value
SINGLE Assigns assembly's location identifier to all the children.
MULTI Assigns location identifiers to the children based on their actual location.
Key

GUID_MAP_READ

Reads guid mappings from a specific file path. Mapping file is a text file of type .mpf.

Value The file path. The default is the path from which the current model was opened or imported.
Key

GUID_MAP_WRITE

Writes guid mapping to a specific file path. By default the guid mappings are stored to the same folder as the model.

Value The file path. The default is the path from which the current model was opened or imported.
Key

SMART_SPLIT

Smart split avoids leaving small pieces of split objects to the result, splitting walls, columns and beams along their axis or slabs horizontally.

Value
ON Smart split on (default)
OFF Smart split off.  Splitting uses basic geometric boolean operations between the location prisms and building elements
Key

SMART_SPLIT_ANGLE

The angle is used for defining, if the splitting is about to happen along the wall, column or beam axis or horizontally for slabs. The angle is given in radians. It is the smallest allowed angle between the object's axis and the split direction. Meaning that only the split directions which have bigger angle to the object's axis than defined are used. This is only applies, when the Smart Split is on.

Value The angle. Default is 0,965.
Key

MINIMUM_SPLIT_DIMENSION

Minimum dimension for split objects. If the resulting split object is smaller than the minimum, then no splitting will be applied. This only applies, when the Smart Split is on.

Value The value in millimeters. Default is 300mm.
Key

DEFAULT_NO_SPLIT

Building elements from a set of default object classes are not split. The default set of object classes include windows, doors, furniture, railings and stairs.

Value
ON Splitting is done with default split settings
OFF Objects are split according to the split type setting and the Split attribute values. No default split settings are used.
Key

DECIMATE

Decimation is the process of reducing the complexity of the geometry without adversely affecting the shape of the geometry.

Value
ON Geometry decimation is on. Normally this should be on. It makes the rendering of the resulting splitting much more effective. (default)
OFF Geometry decimation is off. This should be used only in debugging and testing.
Key

CALCQTO

Calculates the quantities after splitting based on the resulting geometry. Note that this runs the Calculate Basic Quantities tool.

Value
ON Calculates quantities after splitting (default)
OFF Does not calculate quantities after splitting
Key

REMOVE_ORIG_OBJ

Removes original building elements after the splitting. Original building elements are the building elements, which were split.

Value
ON Remove the original building elements
OFF Do not remove the original building elements
Key

REMOVE_LOC_PRISMS

Removes location prisms after resolving the locations. 

Value
ON Remove the location prisms
OFF Do not remove the location prisms. (default)
Key

SPLITSPECIALROWS

Controls the splitting of the following spatial containers: site, building, building storey.

Value
ON Splits spatial containers
OFF Does not split spatial containers. (default)
Key

RESET

Controls the resetting of the model after the locations have been resolved. Resetting is needed when multiple location types are applied to the model in sequence, for example if you first set the building storey locations you need to reset before you set the construction section locations to the same model.

Value
OFF No resetting (default)
SEQUENT_RUN Reset the model after resolving it. When only resolving the locations, the reset means that everything is classified as Not Decided Yet and the existing location prisms are removed. When resolving the locations and splitting, the reset means that the resulting objects are classified as Not Decided Yet and the original objects and the existing location prisms are removed.
SEQUENT_RUN_EXCLUDE_ERRORS Reset the model after resolving it. With this configuration value the reset means that everything is classified as Not Decided Yet and both the original objects, objects with errors and the existing location prisms are removed.

 

Assembly splitting logic