Proximity tool
The Proximity tool connects objects based on their geometric proximity, in other words, how close they are to each other. You can connect objects within the same BIM model, however, the true power of the Proximity tool comes from connecting objects from different BIM models from different disciplines.
The big idea is that once the connection has been created it can be used for example in the Calculate Properties for Connected Objects tool to derive and copy data from one object to another. This enables you to enrich the model data in a new way. There are many interesting use cases for this functionality. See the Examples below.
Note that the Proximity tool is currently in the beta phase. Please give it a try and send us feedback. We tried to take as many as possible use cases into account, but this is such a powerful concept, that I’m sure you will find new ways to use and configure the tool. Note that in the beta version, only the objects with 3D geometry are supported. Support for the 2D objects will come later. Also the configuration parameters might still change in the final version. There can still be limitations or bugs in the tool. If you find them, please let us know!
Settings
The overall idea is that you define two groups and the Maximum Distance between the building elements in these two groups. Only the building elements closer than the Maximum Distance to each other are connected.
The Source 1 and Source 2 groups act as filters for the operation. Most of the time you are only looking for specific kinds of connections. You don’t want to connect everything to everything (although this is also possible).
The distance means the shortest distance between the surfaces of the building elements’ geometries.
![](https://support.simplebim.com/wp-content/uploads/proximity_tool_configuration.png)
Source 1
Building elements to which the Connection Property is added. Note that the building elements can be either single objects or even assemblies. Building Elements within Source 1 are not connected to each other (unless you add them to Source 2 too).
Source 2
Building elements that are connected to the Source 1 building elements, if they are closer than the Maximum Distance. Note that the building elements can be either single objects or even assemblies.
Find
In different use cases, you want to find the proximity objects in different ways.
Find Closest. Use this option when you only want to find only the closest one of all the building elements within the Maximum Distance.
Find All. Use this option when you want to find all the building elements within the Maximum Distance and connect all of them to the Source 1 object in question. If a Source 2 object is within proximity of multiple Source 1 objects, then it is connected to multiple Source 1 objects.
Find All Uniquely. Use this option when you want to find all the objects within the Maximum Distance, but you only want to connect them to one Source 1 object, the closest one of all that are within the Maximum Distance.
Proximity Type
There are use cases where you want to limit the proximity search in different ways. For example, you might want to connect only the building elements (from Source 2) that are above the building element (from Source 1).
Shortest. Use this option to find the building elements (from Source 2) in any direction from the Source 1 object.
Above. Use this option to find building elements (from Source 2) directly above the Source 1 building elements. If the Source 2 building element is within the Maximum Distance, but on the side or below the Source 1 building element, then it is not connected to the Source 1 building element.
Below. Use this option to find building elements (from Source 2) directly below the Source 1 building elements. If the Source 2 building element is within the Maximum Distance, but on the side or above the Source 1 building element, then it is not connected to the Source 1 building element.
On the Side. Use this option to find building elements (from Source 2) on the side of the Source 1 building elements, in other words not directly above or below. If the Source 2 building element is within the Maximum Distance, but directly above or below the Source 1 building element, then it is not connected to the Source 1 building element.
On the Side at the Same Level. Use this option to find building elements on the side of the Source 1 building elements, in other words not directly above or below. The additional constraint is that the Source 2 building element has to be at the same level as the Source 1 building element. If the Source 2 building element is within the Maximum Distance, but directly above or below, or on the side but higher or lower than the Source 1 building element, then it is not connected to the Source 1 building element.
Maximum Distance
Use this option to define the maximum allowed distance between the building elements. The building elements that are farther apart than the Maximum Distance are not connected.
Connection Property
Use this option to define the Connection Property Name. Just make sure you use unique names, if you want to run the tool multiple times on the same model (and don’t want to update or override the existing connections). The Connection Property can be used for example in the Calculate Properties for Connected Objects tool.
Override Connections
Use this option to choose whether you want to override (checked) or update (unchecked) the Connection Property, if it already exists in the model. There are use cases for both. Maybe you want to run the tool multiple times for the same Source 1 building elements but for different sets of Source 2 building elements using different logic or Maximum Distance. Then you want to update/add to the Connection Property. On the other hand, if you make a mistake, you can override the Connection Property with a rerun.
Create Connection for Completely Inside Objects
The tool calculates the distance between the closest surfaces of the objects. However, sometimes the Source 2 building elements can be completely inside the Source 1 building element and ‘deeper’ than the Maximum Distance. If you want to find and connect these objects, turn this option on.
Add Derived Properties
Use this option to assign the distance measure value to the Source 1 building elements. Note that this only works when the Find is set to Find Closest.
Property Set
Use this option to set the property set where the Distance Property is assigned.
Distance Property
Use this option to define the property’s name to where the distance measure value is assigned. It can be an existing property in the model, or if the property doesn’t exist, it will be created.
Automation
Proximity tool is almost always used together with another tool, like the Calculate Properties for Connected Objects tool. Remember that you can easily automate running both tool with a template or scripts. Simply configure your tools in the Simplebim UI, then copy the configurations to your template.
Examples
Find the number and type of electrical sockets for each room
Let’s say you want to make a bill of quantities for sockets based on the rooms they belong to. The room objects (spaces) are in the architectural model. The electrical sockets have been modeled by the electrical engineer to the electrical model. These two models and their objects don’t know anything about each other. So, what do you do? Proximity tool to the rescue! Merge the architectural model and the electrical model. Create a group for all the space objects (or rooms), and another group for all the sockets. Run the proximity tool. It will create a connection between the rooms and the sockets within each room. You can now use this connection to calculate the number of sockets to your space objects. Or copy the type information from the sockets to the rooms. Or copy the room name and number from the space objects to the sockets. You can export the data back to IFC and use it in some of your downstream applications. Or create an Excel export including the enriched and derived data. Problem solved. Pretty cool!
![](https://support.simplebim.com/wp-content/uploads/proximity_tool_example_2-2-1024x437.png)
Find doors for walls
Let’s say the internal walls in your model know their fire rating, but the doors don’t. Or you are not sure, if these two pieces of data are inline. You cannot have a lower-rated door in a higher-rated wall. That would not make sense. Even though the building elements are probably in the same model, they don’t always have a ready-made connection between them. Or even if they do, this might be hard to use for automated data enrichment or checking. So, what do you do? Proximity tool to the rescue! Create a group for all the internal walls and another group for all the doors. Run the proximity tool, which will create a connection between the walls and the doors within their proximity. Now you can use this connection to copy the fire rating data from the wall to the door. Or the other way around. Afterward, you have the fire rating data in all the relevant building elements. Or if both the walls and doors already had the fire rating data you can now cross-check, and mark the building elements with the different fire rating value as their counterpart. Problem solved. Pretty cool.
Find windows for precast elements
What if the precast wall factory wants to know what kind of windows there are in specific precast wall elements? Depending on the window type, they might for example need to create different kinds of attachments to the precast element. The windows are in the architectural model. The precast walls have been modeled by the structural engineer to the structural model. The objects and the data are in different BIM models. They don’t know anything about themselves. So, what do you do? Proximity tool to the rescue! Merge the architectural model (or its windows) and the structural model. Create a group for all the windows. Create another group for the precast wall assemblies. Now run the Proximity tool to connect the precast walls to the windows that are within their proximity. Finally, use this connection to copy the window type information to the precast elements. Export the model back to IFC or create a dataset out of the derived and enriched data. Problem solved. Pretty cool.
![](https://support.simplebim.com/wp-content/uploads/proximity_tool_example_1-1024x367.png)
Find spaces, that are served by an HVAC system
One interesting idea is to use the proximity tool for marking the rooms that are served by a specific HVAC system. Again the rooms (spaces) and the HVAC systems and their object are created into different models. They don’t know anything about each other. So, what do you do? Proximity tool to the rescue! Merge the architectural and HVAC models. Create a group of objects for the HVAC systems and another group for all the spaces. Run the Proximity tool to connect the rooms and HVAC objects. Use this connection in the Calculate Properties for Connected Objects to either mark the rooms as served, or even copy the system name from the HVAC objects to some property of the room. Problem solved. Pretty cool.
Match colors of sprinklers and ceilings
This use case I could not have come up by myself. In a high-end building the ceilings and the sprinkler heads need to have the same color. The ceilings are modeled by the architect to the architectural model and the sprinkler heads by the sprinkler designer to the sprinkler model. The data and the objects are in different models, so they don’t know anything about themselves, let alone their colors. So, what do you do? Proximity tool to the rescue! Merge the architectural and the sprinkler model. Create a group for all the ceilings and another group for all the sprinkler heads. Now run the Proximity tool to connect each sprinkler head to the closest ceiling. Finally, use this connection to copy the color information from the ceiling to the sprinkler head. Export the data back to IFC, or create an Excel table from the data and you are done. Problem solved. Pretty cool.
Calculate the area of windows and doors for rooms
What are the window and door areas in a room? This seems like a trivial question, but many times this information is not in the model. The rooms, windows, and doors might be in the same architectural model, but they still might not know anything about each other. So, what do you do? Proximity tool to the rescue! Create a group for all the rooms and another group for all the doors and windows. Now run the Proximity tool to connect the rooms to the relevant windows and doors. Use this connection to summarize the areas from the windows and doors and assign the end result to a property of the room object. Export the data back to IFC, or create an Excel table from the data and you are done. Problem solved. Pretty cool.
Check that the hot and cold water pipes are not too close to each other
One of the more traditional uses of proximity tool is to find for example if the hot and cold water pipes have required distance from each other. Yes, the proximity tool can also be used for this kind of more traditional clash detection task. Even though the objects in this case are in the same model, they don’t know the distances between them. Model author tools don’t create this information for you. So what do you do? Proximity tool to the rescue! Create a group for all the cold water pipes and another group for all the hot water pipes. Run the Proximity tool with the maximum distance that is the minimum distance the hot and cold pipes should have. The Proximity tool will create a connection between pipes that are too close to each other. You can now use this connection to mark the ‘too close’ pipes from the model. Highlight or colorize the problematic pipes from the model, or create BCF issues out of them. Problem solved. Pretty cool.
![](https://support.simplebim.com/wp-content/uploads/proximity_tool_example_3-1024x340.png)