TheModus - TheModus Model Extender

Table of Contents

• Cadac for Revit - TheModus Model Extender
  • Introduction
  • Getting started
  • Setting up Themodus Model Extender
    • General
    • Base tables
    • Classification Definitions
    • Language and path settings
      • Set language:
      • Set directories:
    • Setup classification definitions
      • Base tables
      • Classification Definitions
      • Classification rules
    • Setup navigation Trees
    • Setup Exchange definitions
    • Exclude categories
  • Initialize
  • Classification of BIM models
    • Classification form
      • The Ribbon
      • The "Model" panel
      • The "Classification" panel
    • Select and view
      • Select objects in the active view and open the classification screen
      • Select items in the tree structure and use this selection in the active view
      • Zoom in on the selection
      • Excluded objects
      • Transparency
    • Scope BIM Information
    • Localise Assets
    • Classify manually
    • Classify automatically
    • Synchronize Base tables
  • Share
    • Export
    • Import
  • Additional information
    • Revit parameters
    • Revit linked files
    • Revit model groups
    • Revit room calculation point
    • Revit System parameters
    • Revit Shared Parameters
    • DWG Export
  • Q&A
  • Various Youtube movies
    • Information sharing demonstrations:
    • Demonstrations regarding classification of BIM information:

Cadac for Revit - TheModus Model Extender

Introduction

A BIM model provides a large amount of information for the design, production and operation of a building. To make this large amount of information useful for the different disciplines in the different phases, it is necessary to classify this information. In addition, it is important to provide the correct disciplines with the correct information. And only the information they need at that point in the process.

Cadac TheModus Model Extender supports BIM modellers and building managers in classifying the information in the BIM model easily and efficiently, in order to be able to easily share this information with the partners.

With Cadac TheModus Model Extender:

• Can you manually classify floors, spaces and objects;
• Can you automatically classify floors, spaces and objects;
• Assign information from floors and spaces to objects;
• Display classified information structured and graphically;
• Share specific information;
• Import information into your BIM model;
• Manage definitions for classifying and sharing information.

Thanks to Cadac TheModus Model Extender:

• Only use relevant information in your processes;
• Do you use structured information in your processes;
• Limit re-collection of information as much as possible.

Cadac TheModus Model Extender can be used for all disciplines.

Up to Table of Contents

Getting started

Before we get started with TheModus Model Extender, a number of preparations are required.

TheModus Model Extender is an add-in for Autodesk Revit. It is therefore necessary that Autodesk Revit is initially installed on your system.

Then you can install TheModus Model Extender. Once installed, you can get started right away.

You need a license to use TheModus Model Extender. Information about this can be found under "Cadac TheModus configuration".

TheModus Model Extender uses definitions for classifying BIM information and sharing this information.

These definitions are:

• Classification definitions containing the links between the base tables and the Revit parameters;
• Base tables with all classification data;
• Tree definitions for an organized display of all BIM information;
• Definitions for correctly sharing all BIM information.

Our advice is that a BIM Manager is responsible for setting up and managing all definitions. Creating new definitions can take several hours, but can be used immediately by the entire organization. It is recommended that you always use a small Revit project to develop and test these new definitions, so that you can check the results.

Developing new definitions is best done in the following order:

• Set the correct paths to where the definitions are located;
• Create the classification definition;
• Create the tree definition;
• Set up classification rules;
• Create the exchange definitions.

Up to Table of Contents

Setting up Themodus Model Extender

TheModus Model Extender provides user-friendly functionality for creating and managing classification definitions and exchange definitions. However, there are a number of aspects that are important when organizing these definitions.

This article will help you understand specific aspects about provisioning definitions.

General

First a summary of some general remarks:

• When building a definition, the user enters Revit parameter names as values in a database. A value is only saved after leaving the field. The user must ensure that any parameter is exactly adopted according to the Revit Parameter name. These are case sensitive.
• TheModus Model Extender automatically creates Revit parameters. These are Shared Parameters. It is imperative that all users within one project or one organization use the same Shared Parameter file. The user must therefore also have sufficient read and write access to this Shared Parameter file. If no Shared Parameter file is available, TheModus Model Extender will create one itself, which in case of multiple users this can lead to unwanted effects such as:
  • The same parameters arise twice in one project;
  • Parameters are not filled correctly.
• All parameters created by TheModus Model Extender are "read-only".
• Already available instance project parameters of a project can be included in the classification standard and tree definition. These parameters will remain "readable".

Base tables

A Base table contains the classification data stored in the XML file format. A Base table must have a flat structure, similar to a standard table. For example, a Base table has one or more column headings (tags) with the correct values. It is advised that a Base table has at least 2 column headings, namely the heading "Code" and the heading "Name". The "Code" serves as a key field for synchronizing contents of Base tables. The "Name" contains a logical description. As soon as the users hoovers over certain nodes in this tree structure, the fields "Code" and "Name" are displayed.

Is it allowed to change the contents of a base table?

Yes, that's allowed. The synchronization function makes it possible to update entire projects if the contents of a Base table has changed. However, the condition is that the "Code" is unique and matches.

Is it allowed to change the header in a base table?

Yes, that's allowed. However we strongly advise you not to do this. In fact, all the definitions have to be checked and projects need to be reinitialized. Old parameters must then be cleaned. If such a situation applies, we recommend creating a new version of the entire classification definition and applying it to new projects. Keep using the existing definition for old projects.

Classification Definitions

TheModus Model Extender considers 3 areas of a building. Floors, Spaces and Assets. For every area it is possible to provide classifications. These classifications are based on Base tables or free text fields. The correct area must me checked for every classification. Once checked, the correct classification will be shown in the tree structure based on the selected element type. 

How do the areas relate to Revit components:

• Floors:
  Floors represent the building stories. In Revit this is called a "Level". It is possible in Revit to place multiple levels, which all occur in one floor. In Revit a level can be marked as a "Building Story", which means that this level represents the actual floor. The collection of levels that represent a floor can all be classified as one floor, but a maximum of one level may be marked as a building story! It is possible to classify floors on the basis of several base tables.
• Spaces:
  Spaces represent the functional rooms. In Revit both components "Rooms" and "Spaces" are supported. If both are available in the model, TheModus Model Extender will ask which of the 2 should be used. It is advised to use the "Spaces" if available. "Spaces" contain more information. It is possible to classify "Spaces" based on multiple base tables.
• Assets:
  Assets represent the building blocks. In Revit these are actually all model components. It is possible to classify assets based on multiple Base tables. TheModus Model Extender has a function "Locate Assets" which automatically adds all "Space" and "Floor" information to the "Assets" as much as possible (within the limits of Revit). If this is not desired, it is possible to manually use the class information from the Base tables of the "Floors" of "Spaces" in the "Assets". In that case, behind the mapping of this Base table or free field, all areas must be marked for which the Base table may be displayed.

The following sections provides support in setting up and setting up TheModus Model Extender.

Language and path settings

TheModus Model Extender uses standards and definitions. These are stored on the system. After the installation of TheModus Model Extender, folders are created in the user profile by default. You are allowed to change these folders.

You can also set the desired language.

TheModus Model Extender is available in Dutch, German and English.

Set language:

Follow the steps below to set the language:

• Open the [ TheModus Model Extender ] RibbonTab 
• Click [ Settings ] in the [ Configuration ] panel and click [ Global Settings ]
• Click the 'Language' drop-down list
• Select the desired language:
  • Nederlands                       
  • English
  • Deutsch
    The language is immediately set and saved.
• Click [ OK ] to close the "Global Settings"

Remark:

Language settings only apply to the software. All contents of classification tables or BIM information are not applicable.

Set directories:

Follow the steps below to set the directories to the configuration files:

• Open the  [TheModus Model Extender ] RibbonTab 
• Click [ Settings ] in the [ Configuration ] panel and click [ Global Settings ]
• Click [ ... ] to select a new folder
• Navigate to the desired folder and select this folder
• Click [ Select folder ]
  The first time the folder is selected, you will be asked if this folder applies to all configuration file.
  Click:
  • [ Yes ] to set it for all configuration files.
  • [ No ] to set the other folders specifically.
• Repeat the above steps for all other folders
• Click [ OK ]
  The settings have been saved!

Remarks:

• TheModus Model Extender provides default folders for the definitions. If a folder is marked red, then this folder does not exist, or no tables are available.
• The user must have read and write permissions on the selected folders!

Setup classification definitions

TheModus Model Extender uses classification templates to classify elements in a BIM model.

A classification template has 2 goals:

• It establishes the relationships between the Base tables or free fields to the Revit parameters
• It contains the rules on the basis of which automated classification can take place

Creating a classification template consists of 3 important steps:

• First, Base tables must be available
• Then the relationships can be established between the Base tables or the free fields and the Revit parameters
• Finally, rules can be defined for automated classification.

Base tables

TheModus Model Extender uses Base tables in its classification templates. Base tables are lists containing classification codes. These can be codes for classifying Assets, Spaces or Floors. We advise to build a Base table with at least 2 columns. The first column for storing a unique code. The second column then displays the description for this code. It is allowed to add more columns.

A user can build a Base table. When installing TheModus Model Extender, not only various base tables are included in the above folder, but also an example of a base table structure. This Example can be used as a basis for creating new Base tables. It is of course always possible to make a copy of an existing Base table, and to modify it.

A Base table can be changed afterwards. The changes will not be visible until Autodesk Revit is restarted.

• If new records have been added, they are immediately available after restarting Autodesk Revit.
• If records have been changed, the model may need to be synchronized.

Classification Definitions

In the classification definition, the mapping is made between the Base tables and the Revit parameters. The rules for automatic classification are also built up here.

Follow the steps below to set up or change a classification definition:

• Open the [ TheModus Model Extender ] RibbonTab 
• Click [ Settings ] in the [ Configuration ] panel and click [ Classification Standards ]
• Activate the [ Mapping ] tab
  • To open an existing template:
    • Click (Open an existing classification standard) in the "Classification Template" panel;
    • Select the desired classification template from the list;
    • Click [ OK ]
      The selected template opens.
  • To create a new classification template:
    • Click (Create a new classification standard) in the "Classification Template" panel;
    • At "Name" enter the name of the new classification template;
    • At "Parameter Prefix" enter any prefix for the Revit parameter to be created.
      This prefix is only added automatically when connecting root tables!
    • Add mappings
    • Click (Save current classification standard) to save the classification template.
  • To duplicate an existing classification template:
    • Click (Open an existing classification standard) in the "Classification Template" panel;
    • Select the desired classification template from the list
    • Click [ OK ]
      The selected template opens.
    • Click (Save classification standard using a different name) in the "Classification Template" panel;
    • At "Name" enter the name of the classification template.
      Duplicate names are not allowed!
    • Click [ OK ]
    • At "Parameter Prefix" enter any prefix for the Revit parameter to be created. Adjust the prefix of the already mapped parameters if necessary!
    • Change the mappings if desired.
    • Click (Save current classification standard) to save the new classification template.
      Attention! Probably the tree definitions also need to be changed?
  • Add mappings based on Base tables:
    • Click (Connect Base Table and add parameters to template) in the “Base Tables” panel;
    • Select the desired Base table from the list.
      It is allowed to select multiple Base tables;
    • Click [ OK ]
      A mapping to a Revit parameter is automatically created for all columns from the selected Base table(s). This Revit parameter is created using the prefix, the name of the Base table and the name of the column. You can change the name of a parameter. However, it is not recommended to do this in already initialized projects!
    • Behind each mapping choose whether the mapping is intended for Assets, Floors or Spaces;
    • Click (Save current classification standard) in the “Classification Template” panel to save the settings.
  • Add mappings based on free input fields:
    • Click (Add new mapping row) in the “Mapping” panel
    • In the "Revit parameter" column enter the name of the Revit parameter;
    • Behind the mapping choose whether the mapping is intended for Assets, Floors or Spaces;
    • Click (Save current classification standard) in the “Classification Template” panel to save the settings.
  • Remove mappings:
    • In the most left column, select the line to be deleted (the field turns blue). Multiple lines can be selected (<CTRL>+Click)
    • Click (Delete selected row from grid) in the “Mapping” panel
    • Click (Save current classification standard) in the “Classification Template” panel to save the settings.
  • Change mappings:
    • Select the Revit parameter to be modified
    • Enter the new parameter name
    • Activate another cell to finalize the change
    • Click (Save current classification standard) in the “Classification Template” panel to save the settings.

For more information about mapping see the chapter "Extra-information"

Classification rules

Project can be classified automatically. This requires rules. These rules support:

• Filtering the objects to be classified;
• Entering a parameter value based on a fixed value;
• Entering a parameter value based on a code from the Base table. All related parameters are automatically filled based on the values associated with this code;
• Filling in a parameter value based on a value from another parameter;

Follow the steps below to set up or change the rules for automatic classification:

• Open the [ TheModus Model Extender ] Ribbontab 
• Click [ Settings ] in the [ Configuration ] panel and click [ Classification Standards ]
• Activate the "Rules" tab (a classification standard must be active)
• To add a new rule:
  • Click (Add new mapping row) in the “Mapping” panel
  • Behind 'Criterium', specify a criteria such as Family Name (~Family)
  • Select the operator from the drop-down list
  • Specify the validation value, for example the name of the Revit family
  • Click [+] to add a criterion. You can also make an "AND" statement by entering a new criterion, operator and value and clicking [+] again
  • Enter the name of the Revit parameter in the column "Revit parameter"
  • Specify the value to enter, or add a parameter from which the value is retrieved. Place this parameter in square brackets
• Click (Save current classification standard) in the “Classification Template” panel to save the settings.
• Close the form.

Remarks:

• All visible Revit parameters are supported. Revit however uses several internal parameters. These parameters require additional mapping. See 'Extra Information' for more information.
• It is possible to add a special rule which can exclude or add all assets in one operation. This line looks like this to exclude everything:
  • Column criterion = empty
  • Column Revit parameter = CDC_Exclude
  • Column value = 1
• The [ - ] button removes a criterion from the table
• The [ Delete ]button removes the entire line from the table.
• If classification must be added based on rules, then the "Code" field from the Base table must always be used for this. Only then all associated fields from the Base table are used and added to the assets

Setup navigation Trees

An overview is needed to classify objects. Which objects do you classify to which classes? TheModus Model Extender can show all objects in a structure that can be selected and set up by the user. This structure is built in a tree structure.

Follow the steps below to set up or change tree structures:

• Open the [ TheModus Model Extender ] RibbonTab 
• Click [ Settings ] in the [ Configuration ] panel and click [ Tree definitions ]
  When the "Tree definition" window is empty, open an existing tree definition;
• Open an existing tree definition:
  • Click  (Open tree definition) in the "Definition" panel;
  • Select the desired tree definition template
  • Click [ OK ]
    The tree definition is opened.
• Create a new tree definition:
  • Click (Create a new tree definition) in the "Tree" panel
  • Change the text "New tree" to the desired name of the tree structure in the "Name" field
    At least 1 'Node' must be set.
  • Click (Save tree definition) in the "Definition" panel and continue building the tree.
• Sort the created tree definitions:
  • Select the tree definition to be moved
  • Click the arrow (Up) or (Down) to move the tree definition
  • Click (Save tree definition) in the "Definition" panel.
• Delete a created tree definition:
  • Select the tree definition to be deleted
  • Click (Delete tree definition) in the "Tree" panel
  • Click (Save tree definition) in the "Definition" panel.
• Build the tree with nodes (branches):
  • Select the tree definition where the node should be added
  • In the "Nodes" panel select the node to be added. The nodes available here are determined by the layout in the classification template!
  • Click (Add a node to the tree) in the "Tree Nodes" panel;
  • Repeat above 2 steps to add other nodes.
    Make sure the tree definition always ends with an Asset, Floor or Space! This determines the type of objects that are presented in the tree!
  • Click  (Save tree definition) in the "Definition" panel.
• Add nodes with detailed information (for example a code with description):
  • Select the tree definition to which the detail node should be added
  • In the "Nodes" panel select the node to be added.
    If the node is recognized as a node to which a detail can be added, the  button becomes active.
  • Click (Add a detailed node (node + subnode) to the tree) in the "Tree nodes" panel to add the node along with the detail to the tree definition.
    If there is more than one choice, a dialog with all possible choices is displayed.
    Select the desired detail and click [ OK ]
  • Click (Save tree definition) in the "Definition" panel.
• Sort nodes:
  • Select the tree definition whose node is to be modified
  • Select the node to be sorted. In case of combined nodes, always select the highest node
  • Click the (Up) or (Down) arrow to move the node
  • Click (Save tree definition) in the "Definition" panel.
• Remove nodes:
  • Select the tree definition from which to remove a node
  • Select the node to be deleted
  • Click (Delete node from the tree) in the "Tree nodes" panel.
    Make sure the tree definition always ends with an Asset, Floor or Space.
  • Click (Save tree definition) in the "Definition" panel.

Remarks:

• A file is automatically created for tree definitions as soon as a new classification template is created;
• A tree definition can only be created if a classification template is available;
• Only parameters available in the classification template can be used for a tree definition.

Setup Exchange definitions

TheModus Model Extender provides functionality to exchange BIM information. For example, TheModus Model Extender can export and import information. The exchange takes place on the basis of .xml files. The structure of how it is exchanged is fixed in a definition.

When installing TheModus Model Extender, some exchange definitions are supplied by default. These definitions include:

• Exchange with Planon software based on the Survey Definition
• Exchange with Planon software based on the Cobie lt Definition
• Various example exchange definitions based on TheModus working methods.

TheModus Model Extender provides functionality to build your own definitions.

Follow the steps below to set up or change exchange definitions:

• Open the [ TheModus Model Extender ] RibbonTab
• Click [ Settings ] in the [ Configuration ] panel and click [ Exchange Definitions ]
• Select an existing definition from the list
• Click [ Open ]
  The form opens.
• To open another definition:
  • Click  (Open existing Cobie or XML export definition) in the "Definition" panel
  • Select an existing definition from the list
  • Click [ Open ]
    The form will be opened.
• To create a new definition.
  This requires a source file in XML format, which contains the structure in outline. An exchange definition is created based on this source:
  • Click (New exchange definition) in the “Exchange definitions”panel.
  • Select a structure file (.xml) (From the 'Samples' folder).
  • Click [ Open ]
    Attention! The name of the definition is automatically inherited from the name of the structure file!
    If a different name is desired:
    • Click (Save definition under a new name) in the “Exchange Definitions” panel
    • Enter the desired name
    • Click [ OK ]
      The definition is saved
• To add nodes to the definition.
  One or more collections are available in the structure file. The next step is to indicate per collection where the information should be retrieved. We call this the "Node type". In the "Node type" drop-down list select the desired node. See "Node Types" below for an explanation of the node types. Repeat this step for each collection. Specify the export and import parameters in the tables. The top table is intended to provide attributes for the collection. In the bottom table all export data is defined:
  • In the "Attribute Name" or "Exchange Name" field specify the name of the tag as it will be displayed in the export file.
  • In the "Revit export parameter" field specify the exact name of the Revit parameter from which the export value is retrieved. There are several options:
    • Specify the Revit parameter in square brackets [ ]
    • For some Revit information no parameter is available such as "Family Name" and "Type Name".
      See: Extra-information for using this information.
    • Refer to a collection of parameters to get the correct amount.
      See "Parameter mapping for quantities" below
    • Calculate the value using formulas.
      See "calculate export values" below
  • In the "Revit import parameter" field specify the exact name of the Revit parameter to which an import result is written. Only Revit parameters, which have no influence on the model, can be added here. In general, these are only text parameters that are accessible. Quantities, System parameters or Names are not accessible
  • "Overwrite if empty"
    • If not checked, import will keep the value as present in the model if no value is entered in the import file.
    • If checked, the value will be emptied in the model during import if no value has been entered in the import file. An empty value in the import file is considered “to be deleted”
  • Check "Key" if the parameter is a unique identification number. This only is necessary when you also want to import exported information again, after changing the data. Preferably, this is only checked at the GUID of the Revit element;
  • In the "Max. length" field enter the number of characters that must be exported. At value “0” the full length is exported.

Remark:

The changes are made inside a 'table'. Therefor changes will only be 'saved' by activating another field and clicking the (Save) button.

Grouping

If you want to group Asset collections, a parameter must be available in the Revit model that makes each collection unique. If desired, specify this Revit parameter behind "Group by". Each group can be exported to a separate file. This function only works if all properties are exported in an "xAsset" collection!

Filtering

If desired, a filter parameter can be specified for an Asset collection. Click [ … ] behind 'Filter parameter' to start the filter builder:

• In the "Parameter" field, enter the name of the Revit parameter;
• Select the desired operator from the "Operator" drop-down list;
• In the "Value" field, specify the value to filter on. No value needs to be entered for “Empty” or “Not Empty”
• Click [ OK ]
• Click the 'trash can' icon to remove the filter;
• Click (Save) in the "Exchange definitions" panel.

Node types

TheModus Model Extender will search for information in various places in the model for exporting information. To make this possible, it is necessary to clearly indicate for each data collection where the information can be found. Below is a summary of the different node types that must be linked to the data collection:

• xProject: information is looked up in the project information of the Revit model
• xFloor: information is looked up in the levels of the Revit model
• xSpace: information is looked up in the rooms or spaces of the Revit model
• xAssetType: information is looked up in the type data of all model components of the Revit model
• xAsset: information is looked up in the instance data of all model components of the Revit model
• xAssetSpaceAssignment: searches for space or room information among the model components
• xAssemblyAssignment: a search is made for detail information on the model components of the model
• xUnknown: Default when creating a new classification. This must be set in one of the above
• Collection: if there is a collection

For analyzing information to connect with Planon software, 3 special node types have been defined:

• xSurvey: information is looked up in the instance data of all model components of the Revit model
• xSurveyUnit: information is looked up in the project information of the Revit model
• xSurveyProperty: information is looked up in the project information of the Revit model

Parameter mapping for quantities

Quantities are often difficult to calculate in Revit due to the wide availability of parameter variants. TheModus Model Extender therefor has functionality for analyzing the correct parameter. The principle is based on the search for the first available parameter from a series of parameters that can have the desired value during the export. As soon as the available parameter is found, the value is read from it. Then the analysis stops. The user determines which parameters to search for, and in which order

An example:

A value must be retrieved for the length of an object. Possible parameters in the model are "Length", "Cut Length", "CDC_Length". Based on this order, TheModus Model Extender first searches the "Length" parameter. If not available, the "Cut Length" will be searched. If also not available "CDC_Length" wil be used. The user can then determine whether no value should be exported, or whether "0" should be stored in the list.

The parameter mapping also has a very special technique, namely the search for the correct parameter, based on an available unit in a Base table. For example, for a wall you have to search for the surface, while a door is delivered in pieces. The wall must then be coded with the unit "M2" linked to it and the door coded on the basis of "ST"

Follow the steps below to set up or change exchange definitions:

• Open the [ TheModus Model Extender ] RibbonTab 
• Click [ Settings ] in the [ Configuration ] panel and click [ Exchange definitions ]
• Select an existing definition from the list
• Click [ Open ]
  The form opens
• To add an existing mapping parameter to the definition:
  • Select the field in the "Revit export parameter" column where the mapping parameter is desired;
  • Click  (Parameter units mapping) in the "Mapping" panel
  • Activate the "Parameter" tab
  • Select the desired parameter (highest level)
  • Click [ OK ]
    The parameter is added to the definition.
• To add a new mapping parameter to the list of mappings:
  • Select the field in the column "Revit export parameter" where the mapping parameter is desired;
  • Click (Parameter units mapping)  in the "Mapping" panel
  • Activate the "Parameter" tab
    
  • Click (Add new map parameter) in the "Map parameter" panel;
  • Enter the name of the mapping parameter at the bottom of the screen.
    Note: The parameter must start with "Map_";
    • Confirm by clicking the newly created mapping parameter in the list
  • Proceed to add model parameters:
    • Select the (newly created) mapping parameter to which the Revit parameter should be added;
    • Click (Add model parameter to map parameter) in the "Model Parameter" panel;
    • Enter the name of the mapping parameter at the bottom of the screen;
      • Confirm by selecting the newly created mapping parameter in the list;
    • Repeat the above steps if you want to add more parameters to the list;
    • Use the  (Up) and (Down) buttons to arrange the order of the parameters.
  • Delete a parameter by selecting it and clicking (Delete parameter from mapping) in the "Model Parameter" panel
  • Click [ OK ]

If a value must always be exported, even if there is no value, end the list with "0"

For mapping to units, use the number "1" to specify the correct value.

Also use the above techniques for mapping to specific units. See examples below:

Example of a standard mapping to a length.

In this example, if no value is found for the length, the value 0 is always exported.

• Map_Length
  • Cut Length
  • CDC_Length
  • Length
  • "0"

Example of a mapping to a unit. "MyUnitField" is equal to the Revit parameter in which the unit is stored. All Map_parameters must of course be included, as described above.

• MAP_QTY, MyUnitField
  • Map_M1
    • Map_Width
    • Map_Perimeter
    • Map_Length
  • Map_M2
    • Map_Area
  • Map_M3
    • Folder_Volume

Calculate export results

TheModus Model Extender supports applying formulas for:

• Calculating the values for export.
• Export parameters based on conditions.
• Being able to apply vlaues to include Model independent data.
• To include export results as an attribute.
• Split or merge export results.

Formulas always start with "=".

Below is a summary of all possible formulas.

Calculations

The following applies for making calculations:

• Use "+" to add;
• Use "-" for subtraction;
• Use "*" to multiply;
• Use "/" to divide;
• A formula does not work according to mathematical principles, but from left to right;
• Put parameters or mapping parameters between square brackets: [parameter]
• When a unit must be added after a number, use the 'Pipe' character "|" followed by the unit;
• Use =FORMAT(Parameter;number) to specify the number of decimal places, where 'Parameter' is the Revit parameter and 'number' represents the number of decimal places.
• Examples:
  • To calculate an area: =[Map_Length]*[Map_Height]|m2
  • To add some length values together: =[Map_Length]+[Map_Length]+[Map_Height]+[Map_Height]

Conditional

A condition can be set to when which value may be exported. Use =IF(ISEMPTY[Parameter];<true>;<false>) to analyze whether the [Parameter] field is empty where:

• [Parameter] is the parameter which is checked to see if it is empty;
• <true> the value is specified if the criterion is met. This can be a parameter or text;
• <false> the value is specified if the criterion is not met. This can be a parameter or text.

Export model independent data

When independent data must be included in the export result model, the user will have to specify this during the export. With the ASK function, an additional form is generated at the start of the export, containing parameters that are called on by the ASK function.

Use the "=ASK([Free question field] option)" function to export model independent data where:

• [Free question field] is the name of the parameter to be filled;
• Options can be added:
  • * for required fields
  • | default value, if a default value applies
• Examples:
  • =ASK([Enter a value]) prompts for a value in the "Enter a value" parameter immediately after startup. The field is not required;
  • =ASK([Enter a value]*) prompts for a value in the "Enter a value" parameter immediately after startup. The field is required;
  • =ASK([Enter a value]|2) prompts for a value in the "Enter a value" parameter immediately after startup. The default value 2 is already available.

Export information as an attribute

Some applications require information to be displayed as an attribute.

Use ATTRIB("attributename1":[Parameter1];"attributename2":[Parameter2];... ) to export a parameter in attribute form where:

• "attributename1" is the name of the attribute;
• [Parameter1] is the name of the parameter;
• Behind ";" the next attribute can be placed;
  Example:
  • =ATTRIB("project number":[Project Number];"project name":[Project Name]) returns the following in the export:
    • If [export as attribute] is checked during the export;
      <TAG project number="1234" project name="The project" />
    • If [export as attribute] is unchecked during the export;
      <TAG>
      <project number>1234</project number>
      <project name>The project</project name>
      </TAG>

Split or merge information

The following applies to splitting or merging information:

• Use "&" to concatenate the values of 2 fields
• Use quotes ("") to pass text values
• Use SPLIT(<Parameter>;<splitsymbol>;<block number>) to return only part of the value of a parameter where:
  • <Parameter> refers to the Revit parameter placed in square brackets;
  • <split symbol> the symbol is enclosed in quotes ("") on the basis of which the split action is performed;
  • <block number> is the part to be displayed.
• examples:
  • a concatenation of the project number and project name:
    =[Project Number] & " - " & [Project Name] returns 1234 - The Project;
  • to return only the year of a date:
    =SPLIT([Date];"-";3) returns 2016 for a date 05-06-2016;

Combinations of formulas

Combinations are possible with some formulas.

An example a combination of ASK, ATTRIB and SPLIT:

=ATTRIB("day":SPLIT(ASK(Date);"-";1); "month":SPLIT(ASK(Date);"-";2); "year":SPLIT(ASK(Date); "-";3))
Ask for a date, split the date into day, month and year and then return it as an attribute.

Units

TheModus Model Extender has a standard set of units for consistent export of quantities.

The units can be set for lengths, areas and volumes. The following types are supported:

• Default (the default Revit unit is used)
• Millimeters
• Centimeters
• Meters
• Square Millimeters
• Square Centimeters
• Square meters
• Cubic Millimeters
• Cubic Centimeters
• Cubic meters

During the export, TheModus Model Extender calculates the correct units based on the units indicated in the Base tables.

Follow the steps below to set up or change exchange definitions:

• Open the [ TheModus Model Extender ] RibbonTab 
• Click [ Settings ] in the [ Configuration ] panel and click [ Exchange Definitions ]
• Select an existing definition from the list;
• Click [ Open ]
  The form opens;
• Select a field in the "Revit export parameter" column where the mapping parameter is desired;
• Click (Parameter units mapping) in the "Mapping" panel
• Activate the "Units" tab
  
• Click:
  •  to add a new unit. Set the fields;
  •  to delete a unit;
• Click [ OK ] to save the unit definition;
• Close the form

Exclude categories

This article has been added to the installation and configuration. It describes the ability to permanently exclude specific Revit categories in TheModus Model Extender. Examples are Sheets, Views, Legend Components etc. These categories are generally not desirable in BIM classification workflows.

Follow the steps below to exclude categories:

• Open the [ TheModus Model Extender ] Ribbontab 
• Click [ Settings ] in the [ Configuration ] panel and click [ Excluded categories ]
• Select all categories to exclude from the list.
• Click [ OK ]

Up to Table of Contents

Initialize

Every project must be initialized. The initialization establishes the relationships between the classification tables and the Revit model.

Follow the steps below to initialize the project:

• Open the [ TheModus Model Extender ] RibbonTab 
• Click [ Initialize ] in the [ Configuration ] panel
• Select the desired classification standard;
• Click [ OK ]

Remarks:

• The selected classification standard and location are stored in a Project Information parameter!
• If a project has both Rooms and Spaces, You will be asked which one should be used. Preferably use Spaces, as Spaces contain more information.
• If a model contains Groups, TheModus Model Extender will ask how to deal with these Groups. By default, the solution will not modify information in Groups. If this is desired, the group must be removed.
• In case of errors,, always use the function [ Reload model ] first.
  (Under [ Settings ]  in the [ Configuration ] panel)

Tip:
After initialization, it is desirable to perform a 'quick start'. Based on the rules, the model can already be partially or completely classified!

Up to Table of Contents

Classification of BIM models

The main functionality of TheModus Model Extender is the classification of BIM models. Classifying BIM models enrich Assets, Floors and Spaces with coding, so that this information is recognizable in other processes or applications.

All articles in this chapter are described on the simple 'Best Practice' below which consists of:

• Initialize the Project;
• Classify the Floors;
• Classify the Spaces;
• Define the Project;
• Locate all Assets;
• Classify the Assets.

The following paragraphs explain the classification form and how to use it.

Classification form

For classifying BIM data, TheModus Model Extender provides a user-friendly form called "Connect".

This article explains this form.

The form consists of a Ribbon and 2 panels.

The Ribbon

The Ribbon is divided into 4 sections:

• Scope
• Excluded items
• Connect
• View

These sections include the following features:

• The "Scope" panel contains all the functions to define the project:
  • (Include selected items in FM) adds elements to the project demarcation;
  • (Exclude selected items) excludes elements from the project demarcation.
• The "Excluded Items" panel indicates whether or not excluded items are shown:
  • (Show/don't show excluded assets in tree) if checked, all excluded elements in the tree are shown;
  • (Show/don't show excluded assets in view) if checked, all excluded elements are shown in the view.
• The "Connect" panel contains all the functions for classifying objects:
  • (Classify selected items) connect Assets, Floors or Spaces to the selected classes in the active Base table. This becomes active when an object is selected;
  • (Disconnect) disconnects Assets, Floors or Spaces and the connected class. It becomes active when a connected object is selected;
  • (Add facility management information, related to floors and spaces, to assets) locates the assets and transfers the data from the Spaces and Floors to the Assets;
  • (Autoupdate tree) if checked, the tree is automatically refreshed after an action has taken place.
• The "View" panel contains functions for visualizing the object:
  • (Zoom in view to the selected elements) zooms in on the selected elements in the tree. Attention! the elements must be available in the view!
  • (Close the dialogue, but leave the currently selected items selected in the view) closes the form and keeps the selection elements as created in the tree;
  • (Transparancy) makes all elements in the active view transparent, making the selection easier to see.

The "Model" panel

In this panel all objects are displayed in a structure based on the chosen tree definition. The classification depends on the selected classification definition and the associated tree structure. The tree can be changed at the top. Below that, elements can be searched for in the model by entering search criteria and clicking the search icon.

Select elements in the BIM model by clicking on the item. Multiple selections can be made by clicking on a node, or even in combination with the <Ctrl> key or <Shift> key.

The "Classification" panel

In this panel the Base tables are shown. The Base tables contain all codings. One or more tables can be linked for each Asset, Floor or Space. These tables are in the drop-down list at the top of the field. Depending on the selection of an element, the drop-down list is refreshed with the allowed tables. Which tables are active depends on the checked object type in the classification standard. These can be Assets, but also Spaces and/or Floors.

A value is selected by clicking on the appropriate value.

Use the search field to quickly find a value.

If free text fields are used, a text box will be shown instead of the table. A free text value can be entered here. This field can be used in combination with (already available) Revit Instance Project parameters

Important!

TheModus Model Extender does not support linked files. When the form is opened, linked files are hidden.

Select and view

TheModus Model Extender interacts with the active (3D) view of the Revit project. This means that selections in the tree structure are also visible in the 3D model.

TheModus Model Extender supports making selections in the tree structure, but also directly in the model.

Select objects in the active view and open the classification screen

Follow the steps below to make selections in the Revit model, and to actively use this selection in the "Connect" form:

• Make the selections in the Revit model based on standard Revit techniques.
• Click (Classify BIM Elements) in the [ TheModus Model Extender ] panel in the [ Modify | ... ] RibbonTab
  The tree structure immediately shows the selection of all selected parts.

Note: TheModus Model Extender remembers the last structure opened. If the selection is not allowed in the structure, it will not be displayed.

Select items in the tree structure and use this selection in the active view

Follow the steps below to make selections in the tree structure and then use them in the active view.

• Select one or more Assets in the tree structure.
  The selection is highlighted in the active view.
• Click (Close the dialogue, but leave the currently selected items selected in the view) in the "View" panel.
  The temporary view settings are restored, the "Connect" form is closed, the selection remains active in the Revit model.

Zoom in on the selection

Follow the steps below to zoom in on a selection:

• Select one or more Assets in the tree structure.
  The selection is highlighted in the active view.
• Click (Zoom in view to the selected elements)  in the "View" panel.
  The selection is zoomed into in the active view.

Excluded objects

Excluded objects can be shown or hidden in both the tree structure and the active view.

• Uncheck in the "Excluded items" panel to hide these items in the tree;
• Check in the panel "Excluded items" to show these items in the tree;
• Uncheck in the "Excluded items" panel to hide these items in the active view;
• Check in the "Excluded items" panel to show these items in the active view.

Transparency

Make the elements in the active view transparent. This provides a better overview for more complex models.

• Uncheck in the panel "View" to show the view in normal view;
• Check in the panel "View" to make the elements in the view transparent.

Scope BIM Information

Depending on the process, it may be desirable to delimit elements in the BIM model to a limited collection. To make this possible, non-relevant elements can be excluded.

Follow the steps below to exclude elements from the collection in the active view:

• Select one or more elements;
• Click (Exclude selected items from tree) in the [ TheModus Model Extender ] panel in the [ Modify | ... ] RibbonTab
  The parameter 'CDC_Exclude' is set to 1

Follow the steps below to add elements to the collection in the active view:

• Select one or more elements;
• Click (Include selected elements in tree) in the [ TheModus Model Extender ] panel in the [ Modify | ... ] RibbonTab
  The parameter 'CDC_Exclude' is set to 0

Follow the steps below to exclude elements from the collection in the classification form:

• Click (Connect) in the [ Classification ] panel in the [ TheModus Model Extender ] RibbonTab 
• In the 'Model' panel, in the included folder, select the objects to exclude;
• Click (Exclude selected items) in the [ Scope ] panel
  The elements are crossed out and moved to the 'excluded' folder in the tree
• Close the "Connect" form.
  The parameter 'CDC_Exclude' is set to 1.

Follow the steps below to add elements to the collection in the classification form:

• Click (Connect) in the [ Classification ] panel in the [ TheModus Model Extender ] RibbonTab;
• In the 'Model' panel, in the excluded folder, select the objects to include;
• Click (Include selected items in FM) in the [ Scope ] panel;
  The elements are no longer crossed out and moved to the 'included' folder in the tree 
• Close the form
  The parameter 'CDC_Exclude' is set to 0.

Tips:

• By default, all elements are added to the collection. Using a rule, all elements can be excluded in one operation.
• Rules can be used to add or exclude specific sets of elements in one operation.
• The Revit parameter "CDC_Exclude" can be added as a node in the tree structure. This creates a simple workflow for structured project delineation;
• The Revit parameter "CDC_Exclude" is added by default as a "read-only" parameter to the shared parameter file. If the user is also allowed to mutate this parameter directly in Revit, then this parameter must be manually added as "editable" by a BIM Manager.

Localise Assets

TheModus Model Extender provides functionality for transferring information from Spaces and Floors to the Assets of the Space or Floor where the Asset is located in the building model.

Follow the steps below to locate the Assets:

• Click (Connect) in the [ Classification ] panel in the [ TheModus Model Extender ] RibbonTab
• Click (Add facility management information, related to floors and spaces, to assets) in the [ Connect ] panel

Copying all data from Floors and spaces is a static process. If changes are made to the model, it may be necessary to run the procedure again. All Assets are then relocated. Always save the model first!

Remarks:

• To locate assets, the "Room Calculation Point" must be checked in the Revit family!
• If Floors or Spaces have been modified, the procedure must be rerun. In the "Connect" screen, a warning is shown in red if changes have been made:

Classify manually

Classification is the connection of Floors, Spaces or Assets to one or more classification characteristics.

Follow the steps below to manually classify floors, spaces or assets:

• Click (Connect) in the [ Classification ] panel in the [ TheModus Model Extender ] RibbonTab
• In the 'Model' panel, select the desired tree;
• Find and select the desired elements;
• In the 'Classification' panel, select the desired Base table;
• Search and select the desired code;
• Click (Classify selected items) in the [ Connect ] panel
  The classification is now stored in memory.
• Repeat the above steps for other elements
  When closing the form, all information is written into the Revit model.

Classify automatically

Classification is the connection of Floors, Spaces or Assets to one or more classification characteristics.

Follow the steps below to automatically classify Floors, Spacess or Assets:

• Click  (Quick Start) in the [ Classification ] panel in the [ TheModus Model Extender ] RibbonTab
• Select one or more lines;
• Click (Apply selected rules on model items)
• Click [ OK ]
• Close the form.

Synchronize Base tables

During the classification, all information is added to the Revit parameters. One of these parameters represents the classification code. Other parameters can be the name, a group name or a unit.

The classification data can be found in the Base table. If changes are made, they must also be synchronized with the model.

TheModus Model Extender provides functionality to update already classified projects, if there is a modified Base table. This is called "Synchronize".

Synchronization is also used if another Base table (for example another language) with the same classification codes is used in the project. Synchronize then adjusts all values except the code in one operation.

Follow the steps below to synchronize the project:

• Click (Synchronize) in the [ Classification ] panel in the [ TheModus Model Extender ] Ribbontab
• Select the Base table template which should be synchronized.
  Attention! The Base tables are synchronized based on the unique code "Code".
• Click [ OK ]
  The model is being updated.

Up to Table of Contents

Share

TheModus Model Extender provides functionality to exchange BIM information, for example with other applications. There is no direct link with other applications. Exchange takes place on the basis of transfer of an .xml file. For example, information can be exported from the BIM model, and information can be imported into the BIM model.

TheModus Model Extender uses the most obvious structures for exchange. Besides simple structures that are included by default, such as the 'Planon export definition' as well as the 'TheModus export definition', TheModus Model Extender also uses the internationally supported 'Cobie Lite'.

The following articles help you export and import BIM information.

Export

TheModus Model Extender provides functionality for exporting BIM information. This export is based on an exchange definition.

Follow the steps below to export the project:

• Click (Export BIM Model) in the [ Echange ] panel in the [ TheModus Model Extender ] RibbonTab
• At "Select definition" select the correct export definition from the list of available exchange definitions. The exchange definition contains the structure for the export result.
  • If the definition needs to be modified, click [ ... ] behind "Select definition".
    The 'Exchange definition' form opens.
• At "Export file name", enter the name of the export file.
• Click [ ... ] behind "Export file name" to specify specific options for the export file.
  Set the following options:
  • In the "File name" field, click to build the file name based on family parameters.
    • Select the desired parameters in the tree structure. Use the <Ctrl> key to select multiple parameters.
    • Free text can also be added.
    • In "Free Text" enter the desired value and click [+].
    • Select the specified value.
    • Click [ OK ] to save the name definition.
      The fields can be moved with the mouse.
    • Fields can also be deleted.
      Select a field and click .
  • Click [ ... ] behind "Path to export" to specify a specific path where the export result should be saved. This path is stored in the corresponding export definition. This path is different from the default configured path.
  • Check "Value as Tag attribute" if all values should be added as an attribute to the xml tags.
  • Check "Export file per collection" if a separate export file must be created for each collection. In this case, the export definition must contain a grouping parameter.
  • Click [ OK ] to close this form;
• Check "Export DWG" if DWG drawings should be exported. The DGW settings become active.
  Then choose:
  • At "Select plot definition" select the desired plot definition;
  • At "Select plot set" select the desired plot set;
• Click:
  • [ Export ] to start the procedure
    or
  • [ Cancel ] to cancel the procedure.

Depending on the export definition, question fields may be formulated. In that case, a new screen will be shown immediately after starting the export, containing the question fields. Fill in the questions and click [ OK ] to start the export.

When the export is completed, a summary is displayed, specifying the number of exported Assets, Spaces or Floors.

If nothing has been exported, an error may have occurred. This usually is an error in the definition, or when some information does not exist.

• Click [ Report ] to open the error report. This report helps track down the reason why something wasn't exported.
• Click [ Close ] to close the summary.
• Click [ Open Export folder ] to open the folder where the export files and report are stored.

Remark:

• Excluded parts are never exported.

Import

TheModus Model Extender provides functionality for importing BIM information.

The following parts of the import process are supported:

• Floors (Levels) which are marked as "Building Story"
• Rooms / Spaces (Spaces)
• Model components (Assets)

Follow the steps below to import information into the project:

• Click (Import xml file) in the [ Exchange] panel in the [ TheModus Model Extender ] RibbonTab
• At "Select definition" select the import definition.
  • If desired, click [ ... ] to modify an exchange definition;
• Find and select the desired import file;
  • Click [ ... ] to browse for the import file (*.xml)
  • Select the import file
  • Click [ Open ]
• Click [ OK ]
  The procedure starts.

When the import is completed, a summary is displayed, specifying the number of imported Assets, Spaces or Floors.

• Click [ Report ] to open the error report. This report helps track down the reason why something wasn't imported.
• Click [ Close ] to close the summary.
• Click [ Open Import folder ] to open the folder where the import files and report are stored.

Remarks:

• Some parameters cannot be imported. These are parameters such as the category name, the family name, the type name, quantities and some standard built-in Revit parameters!
• TheModus Model Extender analyzes whether the information to be imported is instance or type information. In case of type information, the user is asked whether:
  • The type information may be overwritten
  • The information must be added separately as instance information. A separate parameter is then created.
  • The value should be skipped
  • Or in case of different types of information in the same family, create new types.

Up to Table of Contents

Additional information

TheModus Model Extender uses all the functionalities of Autodesk Revit as a basis. Therefor, there are a number of aspects that are important when using Autodesk Revit and setting it up for TheModus. We list these aspects.

Revit parameters

TheModus Model Extender uses Revit Project Parameters to store associated information. These are instance parameters, which means that all these parameters are specific to the active building model.

The user does not need to create these parameters. The TheModus Model Extender creates these parameters itself.

The solution uses 2 types of parameters:

• System Parameters. These parameters are added to the project without user intervention.
  These parameters are:
  • CDC_Exclude. This parameter is used to include/exclude Assets from the BIM model.
  • PREFIX_SpaceNumber. This parameter is used to store the room numbers.
  • PREFIX_SpaceName. This parameter is used to store the room names.
  • CDC_ClassificationTemplate. This parameter is used to store the associated classification template.
• Custom parameters. These parameters are added from the classification definition. The user thus affects the name and purpose of these parameters.

Remark:

Autodesk Revit does not support date/time parameters. For this reason, TheModus Model Extender always uses text fields for date and time. In order for the PLANON workflow to run smoothly, it is necessary for the user to enter a date in accordance with the following format: "yyyy-mm-dd".

Revit linked files

Many Revit workflows use linked files. For example, aspect models are usually created containing a linked BIM model.

An example is a structural model which uses the architectural model as a base. Or a MEP model which uses a structural model as well as an architectural model as linked files.

TheModus Model Extender does not support linked models. After all, linked models only serve an informational purpose.

Only the main models can be classified with TheModus Model Extender. It is therefor necessary that each aspect model is classified separately!

If more models are classified, whose BIM information is read into a third-party application, it is advisable to use the same project name and project number for all aspect models.

The parameters project name and project number are available in the Project Information List of the Revit Model.

Revit model groups

Many Revit workflows use Model Groups. Model Groups consist of a collection of Assets.

TheModus Model Extender does not support Model Groups.

TheModus Model Extender provides functionality to extract all placed Model Groups. The user will have to accept this if he wants to classify the information in these Groups. If the user does not want to extract all Groups, but only part of the Groups, this will have to be done manually in the Project first.

Revit room calculation point

Custom Revit families contain a "Room Calculation Point".

Revit uses this "Room Calculation Point" to analyze which Assets belong in which Room.

This "Room Calculation Point" is also used by the TheModus Model Extender.

TheModus Model Extender provides functionality to transfer all classified information from a Space to an Asset.

All information from the Rooms and Floors can only be transferred if the "Room Calculation Point" is enabled.

Revit System parameters

Basically, all parameters can be easily transferred to the classification templates. However, for some parameters this is not possible. These are so-called "built-in" parameters. The overview below shows so-called system names with which these built-in parameters can still be used with TheModus Model Extender.

Revit Shared Parameters

TheModus Model Extender uses the so-called Revit Shared Parameter File. This file contains all family parameters, which can be shared with your colleagues or team members. It is necessary that the Model Extender can read and write to this file. If this is not possible, the Model Extender will create its own Shared Parameter file. This is then specific to the active project, and will not be shared with your team members!

It is also possible that the Shared Parameter file is not linked to the Revit.ini. If this is the case, you must link them.

To do this, follow the steps below:

• Search for the Revit.ini file.
  Usually this is in the folder: %appdata%\Autodesk\Revit\<Revit version>\revit.ini.
• Open this file with a text editor, for example (Notepad)
  • Add the following line under the [Directories]  node:
    ExternalParameters=<PathName Shared Parameter File>\<Name Shared Parameter File>
  • Save the file
• Repeat the above steps for all Revit versions!

DWG Export

When data is exported, it may be desirable to also export the associated drawings. To enable this export, a plot set and a plot definition must be created in Revit.

An export definition is required for exporting DWG's. This must be created in the Autodesk Revit application. Follow the steps below:

• Activate the "File" RibbonTab
• Click "Export >"
• Click "CAD formats >"
• Click "DWG"
• In "Select Export Setup" click [ ... ] (Modify Export Setup)
  The "Modify DWG/DXF Export Setup" form opens.
  
• In "Select Export Setup" click (New export setup) to create a new export definition setup
• Enter the Export Setup Name
• Click [ OK ]
• Set all desired export styles such as:
  • Layers
  • Lines
  • Patterns
  • Text & Fonts
  • Colors
  • Solids
  • Units & Coordinates
  • General
• Click [ OK ] to save the settings and close the wizard.
• Click [ Save Set & Close ] to close the wizard

Remark:

To export room and environment data it is necessary to check "Export rooms, spaces

and areas as polylines" in the "General" tab.

Create a DWG export set

For exporting DWG drawings it is necessary to create an export set which contains all desired drawings.

Follow the steps below to create a DWG export set:

• Activate the "File" RibbonTab
• Click "Export >"
• Click "CAD formats >"
• Click "DWG"
• In "Select Views and Sheets To Export", click (New set) to create a new export set.
• Enter the Export Set name
• Click [ OK ]
• In the 'Include' column, tick all desired views and sheets in the table
• Click [ Save Set & Close ] to save the export set

Tip:

Use the selection options behind "Show in List" to limit the number of available views and sheets in the list.

Up to Table of Contents

Q&A

What can I do if I experience problems?

See an overview below of the most well-known questions or possible malfunctions listed and actions formulated that you can perform.

Revit gives errors on the model as soon as I start the TheModus Model Extender.

If Autodesk Revit returns errors on the model, the first step is always to perform an Audit on the model. A Revit file is a complex database, with many references. An Audit restores these references if there are any broken references.

Click Autodesk Revit Audit for extra information about preforming an Audit.

I have modified (changed or deleted) Assets, Spaces or Levels in my model, but do not see the changes in the classification form?
Also, changes to Spaces or Levels are not processed on the linked Assets.

TheModus Model Extender will not process all changes until the model is saved. If necessary, reapply the Localise Assets  function.

Some Revit categories are not shown

TheModus Model Extender only shows Model Categories. There is also an option to exclude certain categories. Remove excluded categories if necessary. See Exclude Categories.

My tree shows no Assets.

Check if the Assets are excluded. For more information, see Scope BIM Information

.

I can't tell from the Asset's 'CDC_Exclude' parameter whether the Asset is excluded or not. The check mark is gray.

Autodesk Revit does not set a new yes/no parameter to yes or no by default. As a result, this parameter must be manually checked or unchecked.

We recommend that you do this using a rule after initialization. See Classify automatically.

If several floors are classified at the same time, the warning "Multiple building stories are active" appears.

Levels in a Revit model have a parameter "Building Story". When classifying a floor on this parameter, TheModus Model Extender checks whether multiple Levels are marked as main floor. This is not allowed. In that case, uncheck the "Building story" parameter.

I added an extra parameter to the classification table, but I don't see this parameter in the Assets. Not even after the model has been reinitialized.

New parameters are only added to the Assets once they are assigned a value.

Can I use existing project parameters?

Yes. Instance project parameters can be used by the TheModus Model Extender. These must first be added to the classification standard and the tree structure.

Note! The parameter must be copied exact.

• Parameters added by TheModus Model Extender are "Read only".
• Parameters that are manually added to the project, and only then linked to the TheModus Model Extender are not "Read only".

Can I use Revit's default "Selection Sets" for exporting.

Yes, this is possible. Apply the following workflow:

• Open TheModus Model Extender and exclude all elements. Close TheModus Model Extender
• In the "Modify" tab in the "Selection" panel click "Save"
• Select the desired selection set
• Open the TheModus Model Extender. All elements in the selection set are now active. Add the elements back to the collection. Close TheModus Model Extender
• You can now export these elements

I have selected a Space or Room in the tree structure, but it is not visible in the floor plan.

Check the viewsettings of the active view.

How can I disconnect connected Assets

Select the assets to be disconnected and click Disconnect.

Are non-editable elements such as sweep families supported by the TheModus Model Extender?

Yes. However, the linked information will not always be visible in the model. Sometimes these are stored in the Extensible Storage, and are only visible in the TheModus Model Extender.

Can I remove sweep family information from TheModus Model Extender?

Yes, by disconnecting it using the TheModus Model Extender

All buttons are grayed out. What now?

• Check if you have a valid license.
• Check if you have access to the classification tables.
• Verify that the project has been initialized.

Can I use worksharing in combination with the TheModus Model Extender

The TheModus Model Extender supports worksharing. The only condition is that the Assets being edited must also be accessible to the user. So the worksets containing the elements must be 'editable'.

Up to Table of Contents

Various Youtube movies

Demonstrations

This article contains some demonstrations.

Information sharing demonstrations:

• Sort tags on the export definition. Click here for a demonstration.
• Rename tags ion the export definition. Click here for a demonstration.
• Export tags as attributes. Click here for a demonstration.
• Export to a different path than the default path. Click here for a demonstration.
• Use the ASK formula to add variable information to the export result. Click here for a demonstration.
• Use the SPLIT Formula to split parameter values into multiple tags. Click here for a demonstration.
• Use the ATTRIB Formula to bundle parameter values as attributes. Click here for a demonstration.
• Group asset collections in one export result. Click here for a demonstration.
• Split export results into multiple export files. Click here for a demonstration.

Demonstrations regarding classification of BIM information:

Add multiple "sub-elements" to elements in the BIM model. Click here for a demonstration.

Up to Table of Contents