Support site for Simplebim® users
In This Topic
    Add Your Own Properties to the Model
    In This Topic

    When you add your own properties to the model you need to take the following 3 steps

    1. Define your properties. In addition to  the name each property must have a data type (text, number, length etc.) and optionally a mapping to the IFC model, i.e. how your property is written to IFC. Typically your own properties are written to a property set.
    2. Add your properties. Once your have defined your properties you can add them to object classes, like walls, doors and windows. Separating defining and adding is useful, because this way you can easily add the same properties to multiple object classes. You can for example define a 'Manufacturer Name' property and add the same property to doors, windows, furnishing elements etc. Please note that you can also add properties to object groups, such as systems and zones.
    3. Populate your properties. Empty properties are not of much use, so you need to populate your properties with values. For populating your properties your have the options of copying values from existing properties, deriving values from data you already have in the model or enriching with data from external data sources.

    You add new properties to the model using a template. Adding new properties from the user interface is not possible, but then again you will want to automate adding your own properties because you want to be able to add the same properties to many different models. For general information about templates please consult the Template Guide and the instructions for adding templates and applying templates. This document contains the most important information for each step, but you can find all the details in the relevant sections of the Template Guide or in other linked documentation.

    Step 1 – Define your properties

    Template Worksheet Resources
    Template Sections Add Identity Source - optional
    Add Identity (for IFC PropertySet)

    You can optionally start by defining an identity source. Defining an identity source helps you keep your properties organized inside Simplebim, but it is not used when exporting to IFC because the IFC model does not have the concept of identity sources.

    Properties always have a name and a key. The key is used inside Simplebim to uniquely identify a property in case there are multiple properties with the same name. The key must be unique and if you want to play it safe you can use the key format defined here, otherwise you can use any keys you want. PropertySets are not created separately, instead you assign a property to a property set and the necessary property sets are automatically created for you.

    You can define a Name and a Property Name, but usually it is a good idea to use the same value for both.

    The Name is shown in Simplebim and the Property Name is written to IFC. This is useful when you use property names that also exist elsewhere in the IFC model, such as 'Description'. In this case you could use e.g. 'Description (Acme)' as the name and 'Description' as the property name. This way you don't confuse the two properties when working inside Simplebim but still get the IFC export you need.

    Step 2 – Add your properties

    Template Worksheet Model
    Template Section Add Property to Object Class or Group

    When you add a property to an object class or group you simply give the name of the object class or group, the name of your property and the property type. It is a good idea to use the most appropriate property type for your properties because this enables more functionality inside Simplebim and the applications that use the IFC models you export from Simplebim. For example:

    Data Type Functionality
    Text Human readable
    Number Calculations
    Length Measure Rounding, unit symbols and unit conversions

     For making your templates shorter and easier to read and maintain you can use substitution lists.

    When you add a property to an Object Group the property is added to the Object Group itself, not to the objects contained by the group.

    Step 3 – Populate your properties

    I can't see my new properties!

    When you add a new property to the model, the property is initially empty, i.e. it does not have any values. By default Simplebim does not show empty properties and this may lead you to think that adding the property failed. No worries, you can show also empty properties in the Properties -palette. Simply click on the X icon on the right side of the filter box.

    For populating your new properties you have the following options in Simplebim