IFC clash detection with AI
With moddl you check the trades in your IFC model against each other, pipes against walls for instance, and see the location and elements involved in every clash. You ask in your own words, moddl measures on the geometry and after every change reports what’s new in the surroundings.
01Which clashes you can find
You describe what you want to know, and your AI picks the elements moddl needs to measure. For example:
Where do pipes run through the walls?
Are there clashes on the ground floor?
What touches the selected column?
What stands on the path from here to the outer wall?
moddl checks within one IFC model. Clashes between separate discipline models follow after the beta.
02How moddl measures clashes
First your AI looks for candidates with find_elements, using the hull, an axis-aligned box around each element. A box like that easily hits its neighbour’s box. Whether the elements really meet only shows once check_contacts measures the geometry. moddl then classes each pair as a clash, touch, gap or distance, and you see where every number comes from.
So when you ask about one place, your AI first fetches the candidates around it, and only that selection gets measured.
To find what lies along a path, your AI sends a ray through the model (cast_ray) and you get each element it crosses, with entry and exit. If it passes through one twice, you also see the gap in between that a box hides.
03What you learn about each clash
For each pair you see the two elements, the kind of contact and a measure, along with where it comes from. For a clash that’s its width, for a touch the contact area, for a distance its length.
You also get the coverage: how many pairs were measured and which elements weren’t, each with the reason. An element without geometry stays unmeasured, and so does an assembly without a body of its own, such as a roof made of beams. moddl then points to its parts for your AI to check one by one.
If moddl finds no clash, you still learn how many pairs were measured to get there.
04Accept harmless clashes
Some clashes are intended or harmless. Tell your AI which ones to let through and it marks them as accepted (accept_contacts). That mark is kept beside the model, your IFC file stays untouched, and neither undo nor going back to an earlier version removes it. Once either element changes, check_contacts reports the pair again, flagged as changed since you accepted it.
If a whole pairing of classes counts as harmless, a stair flight on its slab for instance, your AI can set it aside with skip_class_pairs. Those pairs are still tested, just counted separately.
05Reading the numbers
- The width of a clash is the thinnest part of the shared body. It won’t tell you how far one element must move to clear the other.
- An empty list with
n_checked0 only means nothing was within reach. It doesn’t yet tell you whether anything clashes. - A large selection is checked in rounds. If
completeis false, part of it hasn’t been tested yet and can’t count as clash-free. The answer comes with the call that tests the rest.
06Clashes after every change
When the geometry of elements changes or new ones are created, moddl measures the surroundings before and after and reports new clashes or touches, resolved clashes and lost touches. get_history also lets your AI compare with an earlier version and see what has got worse on the changed elements since then, including new clashes.
One storey or one pair of trades makes a good start, say pipes against walls on the ground floor. Load your IFC file into the viewer, connect your AI, for example Claude or ChatGPT, and ask where elements meet there.
Frequently asked questions
What are the requirements?
You need an AI assistant with MCP support, for example Claude or ChatGPT. ChatGPT can also be used on the free plan. You connect it with your own account, without an API key: Edit BIM with your own AI subscription.
How do I connect Claude or ChatGPT?
moddl walks you through the connection step by step in the viewer. You can also read the guides here: Connect Claude to moddl and Connect ChatGPT to moddl.
What does it cost?
During the beta phase, expected to run until June 30, 2027, moddl is free of charge. We will usually announce the end of the beta at least two weeks in advance. Your AI assistant is subject to your provider's terms.
Does the AI get access to my IFC file?
No. The AI receives only the answers to its requests and reports on the changes it has made. These answers may contain content from the model, such as element names and properties.
Can changes be undone?
Yes. Every change creates a new version, and every earlier version can be restored. The uploaded original file stays unchanged.
Which IFC versions are supported?
IFC4 and IFC4X3. Files in IFC2X3 format are converted automatically on upload.