top of page

Using a data dictionary to enrich the IFC schema

Image: 126377601 © Alexandersikov |

The team behind the development of the WASTEie – an information exchange for construction waste – reveal how they used a data dictionary to help build their schema.

You may have heard about the free service provided by the buildingSMART International called buildingSMART Data Dictionary (bSDD). It is a comprehensive library of data dictionaries: classes, properties, relations, restrictions, units, etc. It offers a structured and standardised approach to data classification. Its API-first design enables seamless integration with software tools, making it an ideal platform for enriching the IFC schema.

The RECONMATIC team proposed to use bSDD to publish a set of properties that could enhance component and material reusability and recycling. As part of the discovery phase, we stumbled upon brilliant research by Arghavan Akbarieh, who accomplished her PhD at the University of Luxembourg and currently carries on her work at the Eindhoven University of Technology. Her deep research on decommissioning and reuse is captured in her dissertation Information Modelling For Circular Transformation Of Built Assets’ End-Of-Life.

BIMBox collaborated with Arghavan to translate the decommissioning and reuse (DOR) ontology into a practical set of properties that can be used by industry professionals using the bSDD. Find out more about DOR here.

When should I use the data dictionary?

If you are considering using the data dictionary, it is probably because you couldn’t find properties already defined in the IFC schema. If that’s the case, chances are that the properties you need have already been defined by someone else and are free to access through bSDD. Just check the list of organisations and their published data dictionaries here before you go to the next step.

If you still find yourself in a position where the properties you want to define are not there, you can propose your definitions.

Where do I start?

First of all, you will need to read a bit of documentation. We know it’s not exciting, but there is no way around it. Luckily, the bSDD team has a great resource on GitHub.

Once you open the documentation, it might seem over-whelming as it is rather technical. However, if you’re not a software developer but a mere mortal who wants to enrich IFC (or anything else), you’ll need two major components:

  • Register your organisation on bSDD by filling an online form here, and

  • Use JSON or Excel template to record your properties and classes.

Since we are not so versatile in using JSON, we opted for an Excel template. You can download the latest bSDD template from GitHub here.

Once you have the template, you’ll need to follow the rules defined here. The template also has valuable tips to assist the user. By using the template, you will be able to not only define your properties, classes and materials, but also link them to existing definitions found in bSDD. It is best practice to link property definitions to existing classes or other domain properties, including IFC, to save time and preserve consistency. The documentation is brilliant and relatively easy to follow, with accommodating graphics, tips and examples.

Where do I finish?

Once you have your definitions ready, it is time to test the upload. First, read the import tutorial. If you used the Excel template like us, you must convert it to JSON. To do so, follow this tutorial and converter provided by the bSDD team. Follow this link to access the Python converter. At this stage, it might get a bit technical; however, try following the steps described and if you stumble on some technical issues, ChatGPT can help.

If you got everything right and convert an Excel file into JSON, it is time to upload it onto the bSDD management site. If there are any issues in your JSON file, the prompts given upon the upload are great tips for correcting the file.

Finally, if you cleared all the warnings, you will see your data definitions on the bSDD site. The first upload is in preview mode in case you want to adjust your dictionary, but once you are ready, you can activate your content so you and others can use it in their preferred software.

Good luck!

By the way, it may seem that we have figured this out all by ourselves, yet this explainer would not have been possible without exemplary guidance and support from Artur Tomczak!

We invite you to subscribe to the RECONMATIC newsletter to receive directly in your inbox the latest updates on our activities.

Related Articles


Vitalij Tetervov and Chris Crookes are R&D manager and managing director respectively of BIMBox, part of the Reconmatic consortium working to establish practical methods to better identify and minimise C&D waste during the entire lifecycle of a building.

The article was published by the BIMPlus magazine here.



bottom of page