> For the complete documentation index, see [llms.txt](https://help.qonic.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.qonic.com/documentation/qonic-application/measure-and-quality/clash-detection.md).

# Clash Detection

Use this tool to check for clashes between geometric objects in the model(s).

{% embed url="<https://qonic.wistia.com/medias/hg7a9n3n16/>" %}

{% hint style="info" %}
Clash Detection is part of the Coordination add-on: without this add-on, the tool is greyed out and shows a bolt icon. The sample project and your organization's first project include all add-ons. See [Plans & Add-ons](https://help.qonic.com/getting-started/plans-and-add-ons.md#add-ons). Clash Detection is not available in public sharing sessions or on mobile devices. Read-only members can use the tool too.
{% endhint %}

1. Under *Measure*, open *Quality* and click *Clash Detection*
2. Select a first set of objects to scan. The [Browse Panel](https://help.qonic.com/documentation/qonic-application/data-and-collaboration/browse-panel.md) can be used to set up a structured set of products. The selected objects will be highlighted in green. Objects you selected before opening the tool are used as the first set.
3. (optional) Select a second set of objects to scan. The selected objects will be highlighted in blue. You can only select a second set after you have selected the first set.

{% hint style="info" %}
If only 1 set is selected, this set will be clashed against itself, i.e. every product in the set will be checked against every other product in that set. In that case, the set must contain at least two objects.\
\
If 2 sets are selected, both sets will be clashed against each other, i.e. every product in set 1 will be checked against every product in set 2.
{% endhint %}

4. (optional) Enable the *Detect soft clashes* toggle and fill in the *Clash distance* (in the length unit of the project).\
   \
   Fill in a positive value to find all instances where two objects are closer to each other than the given distance, for example to check if the clearance between two objects is large enough.\
   \
   Fill in **0** to find all instances where two objects touch each other (i.e. the distance between the two objects is 0). The distance cannot be empty or negative.<br>
5. Click *Apply.* A message tells you that clash detection is running and that you will be notified as soon as it's complete. Smaller checks in the desktop app run in Qonic itself; for those, keep Qonic open until the result arrives.
6. Once the clash check has finished, you will be notified by a notification in the top-right corner of your screen. If clashes were found, you get one notification per clash type and pair of IFC classes, for example *Clash: Objects overlapping. (3) IfcWall-IfcDoor* for hard clashes (objects overlapping) or *Soft Clash: Objects closer than 0.05 m (2) IfcPipeSegment-IfcSlab* for soft clashes (objects closer to each other than the specified value). The number is the number of clashes in that notification, and each notification lists its clashes (#1, #2, ...). If nothing clashes, the notification says *No clash detected.*
7. Click one of the clash results. Click a notification to show all clashes of that group, or click a single clash to show it and zoom to it. While a clash is shown, you can only select the clashing products. Depending on the type of clash, a different visualization will be used:

   1. hard clashes: the two involved products will be colored in green and blue, and the overlapping volume will be displayed in red:\
      ![](https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FFu2TDbH3uzzYCW5HHwVb%2Fimage.png?alt=media\&token=0af12388-e2a5-4a4e-9028-2e0e64842ffe)
   2. soft clashes: the two involved products will be colored in green and blue, and the shortest distance between the two products will be indicated with a blue line that shows the distance value. The line is shown when you click a single soft clash:\
      ![](https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FIvGFYCeHS4COLbr7kw5Q%2Fimage.png?alt=media\&token=a7c6cd42-adc2-48de-92b8-ec6a75fbf68c)

   \
   **Note:** if one product clashes with multiple products of the same IFC class, these clash results will be grouped together in one single clash, in the assumption that these problems will likely need to be resolved simultaneously. Clashes between parts of an assembly or layered product are reported on the product itself.
8. (optional) Resolve the clashes, or turn them into issues: hover a clash and click the issues icon (*Raise Issue*), or click the issues icon with the number in the header of a clash notification (*Raise all Issues*) to create an issue for every clash in that notification. The [Issues Panel](https://help.qonic.com/documentation/qonic-application/data-and-collaboration/issues-panel.md) opens with the issue details filled in.
