Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2....

37
This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186. Basic guideline to support the BRESAER design tool December 2017 (M35) D4.5: Basic guideline to support the BRESAER design tool WP 4, T 4.4 Authors: Léon van Berlo, Pim van den Helm, Linda Hoes-van Oeffelen (TNO); Carlos Ochoa, Guedi Capeluto (TEI) BREakthrough Solutions for Adaptable Envelopes in building Refurbishment EeB-02-2014 RIA

Transcript of Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2....

Page 1: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

[Digitare il testo] [Digitare il testo]

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Basic guideline to support the BRESAER design tool December 2017 (M35)

D4.5: Basic guideline to support the BRESAER design tool WP 4, T 4.4

Authors: Léon van Berlo, Pim van den Helm, Linda Hoes-van Oeffelen (TNO); Carlos Ochoa, Guedi Capeluto (TEI) BREakthrough Solutions for Adaptable Envelopes in building Refurbishment EeB-02-2014 RIA

Page 2: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 2

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Technical References

1 PU = Public PP = Restricted to other programme participants (including the Commission Services) RE = Restricted to a group specified by the consortium (including the Commission Services) CO = Confidential, only for members of the consortium (including the Commission Services)

Project Acronym BRESAER

Project Title BREakthrough Solutions for Adaptable Envelopes in building Refurbishment

Project Coordinator

Isabel Lacave Azpeitia

ACCIONA INFRAESTRUCTURAS

mailto: [email protected]

Project Duration February 2015 – July 2019 (54 months)

Deliverable No. D4.5

Dissemination level 1 PU

Work Package WP 4 - Efficient construction process validation and guidance for implementation

Task T 4.4 - Development of a software tool for supporting the envelope components installation

Lead beneficiary 10. TNO

Contributing beneficiary(ies)

13. TEI

Due date of deliverable

31 December 2017

Actual submission date

26 December 2017

Page 3: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 3

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Document history

V Date Beneficiary Author

1 29/09/2017 TNO Linda Hoes-van Oeffelen

2 09/10/2017 TEI Carlos Ochoa

3 12/10/2017 TNO Léon van Berlo

4 18/10/2017 TEI Carlos Ochoa

5 02/11/2017 TNO Léon van Berlo, Pim van den Helm

6 08/12/2017 EKO (review) Gulfem Inaner

7 15/12/2017 TNO Léon van Berlo, Pim van den Helm

8 19/12/2017 TEI, ACC (review) Guedi Capeluto, Isabel Lacave

9 21/12/2017 TNO Léon van Berlo, Pim van den Helm, Linda Hoes-van Oeffelen

Final review

26/12/2017 ACC (review) Isabel Lacave

update 21/08/2018 TNO Léon van Berlo

Page 4: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 4

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

0 Summary

The BRESAER BIM tool assists architects and designers in the evaluation of an early design of a specific target building when using façade elements developed in the BRESAER project. The tool is based on a BIM working method. The BRESAER tool is an online BIM service that runs in the cloud. It is based on open BIM standards like IFC and BCF. Within the BRESAER project, a connection is created between the online BIM service and the most common BIM authoring tool Revit. However, for every BIM authoring tool a connection to this online BIM service can be developed. Within task 4.4, advanced new technologies have been developed like Revit plugins, Revit Families and online IFC services. For Revit users, a special object library with BRESAER components was created using Revit Families. In these families, parameters such as width and height are open for subsequent specification by end-users that would like to modify each module in particular. Structural and connecting elements retain their sizes throughout.

Figure 1: Overview of Revit Families for BRESAER components

From Revit, a user can directly connect to the online BIM service and calculate results, like materials used and installation costs for the specific façade design. This gives designers the ability to create fast iteration of designing, evaluation and changing the design. Furthermore, the mounting order of the façade elements and its components is shown and a check is performed if façade elements are not positioned in front of openings (windows or doors) in a wall.

Page 5: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 5

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

The data flow in the full BRESAER setup is as following:

Figure 2: Architecture overview

A typical data flow involves the following steps:

1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export 6. Data transfer 7. Generate + transfer results 8. Store results at IFC project 9. Show results in Revit

This document is a user manual how to setup and use the tools that are produced for the BRESAER project.

Page 6: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 6

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Table of content

0 SUMMARY ....................................................................................................................................... 4

1 INTRODUCTION ................................................................................................................................ 8

2 TOOL STRUCTURE ............................................................................................................................. 9

2.1 TERMS AND DEFINITIONS ..................................................................................................................... 9

2.2 TOOL OVERVIEW ................................................................................................................................ 9

2.3 INPUT AND OUTPUT OF THE TOOL ......................................................................................................... 11

2.4 RELATION WITH OTHER ACTIVITIES IN THE PROJECT ................................................................................... 11

3 INSTALLATION INSTRUCTIONS ........................................................................................................ 12

3.1 INTRODUCTION ............................................................................................................................... 12

3.2 SYSTEM REQUIREMENTS .................................................................................................................... 12

3.3 USER REQUIREMENTS ........................................................................................................................ 13

3.4 BIMSERVER INSTALLING .................................................................................................................... 13

3.5 BIMSERVER SETUP ........................................................................................................................... 15

3.6 REVIT PLUGINS INSTALLING ................................................................................................................. 21

3.7 REVIT PLUGINS SETUP ....................................................................................................................... 23

3.8 REVIT FAMILIES ............................................................................................................................... 26

3.9 BRESAER BOT SUBSCRIPTION ........................................................................................................... 27

3.10 VIEW RESULTS ............................................................................................................................... 28

4 DATA FLOW ................................................................................................................................... 30

5 MODELLING GUIDE ......................................................................................................................... 31

5.1 IFC MODEL VIEW DEFINITION ............................................................................................................. 31

5.2 HOW TO USE THE REVIT FAMILIES ........................................................................................................ 31

6 RESULTS INTERPRETATION ............................................................................................................. 32

7 EXAMPLE CASE ............................................................................................................................... 35

8 CONCLUSIONS ................................................................................................................................ 37

Page 7: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 7

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

List of Tables Table 1: Inputs for Task 4.4 from other deliverables ...................................................................................... 11

Table 2: Settings of the BIMserver starter ...................................................................................................... 14

List of Figures Figure 1: Overview of Revit Families for BRESAER components ....................................................................... 4

Figure 2: Architecture overview ........................................................................................................................ 5

Figure 3: The BRESAER lite setup....................................................................................................................... 9

Figure 4: The full BRESAER setup ..................................................................................................................... 10

Figure 5: An example building with several BRESAER facade elements ......................................................... 10

Figure 6: BIMserver starter console ................................................................................................................ 14

Figure 7: Results interpretation ....................................................................................................................... 29

Figure 8: Data flow in the BRESAER setup ....................................................................................................... 30

Figure 9: Example output of the BRESAER tool ............................................................................................... 32

Figure 10: Visualization of panels in front of openings ................................................................................... 33

Figure 11: A few images of the flowsheet regarding mounting Ulma and Stam side by side ......................... 34

Figure 12: Example model (IFC) ....................................................................................................................... 35

Figure 13: Revit upgrade warning ................................................................................................................... 36

Figure 14: Revit upgrade result ....................................................................................................................... 36

Page 8: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 8

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

1 Introduction

The aim of this deliverable is to provide a basic guideline to support the use of the BRESAER BIM tool. The BRESAER BIM tool assists architects and designers in the evaluation of an early design of a specific target building when using façade elements developed in the BRESAER project. The tool is based on a BIM working method. The BRESAER tool is an online BIM service that runs in the cloud. It is based on open BIM standards like IFC and BCF. This deliverable covers the following topics:

- Tool structure (chapter 2) - Installation instructions (chapter 3) - Data flow (chapter 4) - Modelling guide (chapter 5) - Results interpretation (chapter 6) - Example case (chapter 7) - Conclusion (chapter 8)

1.1 Disclaimer

The software described in this document is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This programs are distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with the programs. If not, see <https://www.gnu.org/licenses/>.

Page 9: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 9

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

2 Tool structure

2.1 Terms and definitions

BIM (Building Information Model): a dataset that represents a building BIM Bot: an online BIM tool with some kind of intelligence operating (semi-)autonomous BCF (BIM Collaboration Format): an open data standard to exchange issues and results of simulations in a BIM environment IFC (Industry Foundation Classes): an agreement to standardize BIM data

2.2 Tool overview

The BRESAER BIM tool assists architects and designers in the evaluation of an early design of a specific target building when using façade elements developed in the BRESAER project. The tool is based on a BIM working method. The BRESAER tool is an online BIM service that runs in the cloud. It is based on open BIM standards like IFC and BCF.

Figure 3: The BRESAER lite setup

It is possible to upload an IFC file to this system and get results from the tool. Results can be cost estimation, needed materials, etc.

Page 10: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 10

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Within the BRESAER project, a connection is created between this online BIM tool and the most common BIM authoring tool Revit. The setup looks like this:

Figure 4: The full BRESAER setup

From Revit, a user can directly connect to the online service and calculate results. This gives designers the ability to create fast iteration of designing, evaluating and changing the design. Within the rest of this document, we will describe two setups of the BRESEAR tool.

• “Full BRESAER system” is Revit + plugins + IFC + online system o The full BRESAER system has the option to work from Revit directly on the online

service, or with an intermediate local BIMserver. We call these options the ‘Direct BRESAER system’ and the ‘full BRESAER system’.

• “Lite BRESAER system” is use of IFC + online system The full BRESEAR system described in this document works with, but not limited to Revit. The lite BRESAER system is the base system that every BIM Authoring tool can connect to.

Figure 5: An example building with several BRESAER facade elements

Page 11: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 11

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

2.3 Input and output of the tool

The BRESAER tool provides Revit families for the different BRESAER elements, which the user can apply to design a building with BRESAER elements in Revit. The output of the tool is an overview of the materials used for this specific design, including the installation costs. The mounting order of the façade elements and its components is shown in videos. Furthermore, the BRESAER tool performs a check if façade elements are not positioned in front of openings (windows or doors) in a wall.

2.4 Relation with other activities in the project

Table 1 gives an overview of the different deliverables from the BRESAER project used as inputs for the activities in task 4.4.

Table 1: Inputs for Task 4.4 from other deliverables

Deliverable Definition

D2.4 Initial costs and payback calculations for the demonstration locations

D3.1 Envelope components specifications

D3.2 Preliminary constructive design

D3.3 Simulation and validation to achieve an advanced design

D3.5 Prototyping and initial cost estimation

D3.6 Final design, manufacturing and final cost estimation

D4.1 PV system configuration for the target building

D4.2 Air handling and distribution system for the target building

D4.3 Logistics efficiency and initial installation analysis of BRESAER system

The tools developed in task 4.4 focus on the design process of buildings. Therefore mainly WP6 will benefit from these tools.

Page 12: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 12

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

3 Installation instructions

3.1 Introduction

To install the full BRESAER system you need several components: - BIMserver (local) including plugins:

o IfcOpenShell o IFC Plugins o Bimvie.ws

- Revit - Revit plugin to connect to local BIMserver - Revit Families

To install the direct BRESAER system you need several components:

- Revit - Revit plugin to connect to BRESAER Bot - Revit Families

This chapter explains how to install these components.

3.2 System requirements

System requirements for running a BIMserver version 1.5: - A working (outgoing) internet connection (from your BIMserver). BIMserver needs this in

order to: o Install plugins that are hosted on the internet o Send emails (via SMTP) o Connect to other BIMservers (for example when running remote services)

- A working (incoming) internet connection (to allow other people to connect) - Disk space (to store the database, logs, plugins etc...) - Java 8 (or higher)

The amount of required heap memory depends on what plugins you install, the size of your models and the amount of concurrent users of BIMserver. A rule of thumb is that you need about 15 times the size of the largest (unzipped) IFC file you want to be able to upload, times the maximum number of concurrent users. Make sure you install a 64bit JRE/JDK if you have a 64bit system. The main advantage will be that you are going to be able to reserve more than 1300MB of memory, which you probably will want to.

Page 13: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 13

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

For advanced queries, you will need to use a JDK, for all other features a JRE will suffice. Within BRESAER, just the JDK is sufficient.

3.3 User requirements

The BIMserver GUI plugin bimvie.ws is only tested for the Chrome Browser version 64. Most of the features will also work on Firefox and Safari. There are known issues with Internet Explorer when it comes to WebGL and visualisation of geometry. Older versions of Chrome will also work, but have limited options for the end-users. We recommend using Chrome version 64 or later.

3.4 BIMserver Installing

This in only needed for the Full BRESAER system. You can skip this for the Direct BRESEAR System setup. For BRESAER we advise to use the executable JAR file, most operating systems allow you to double

click the file to start running it.

(Windows) Make sure you do not put the .jar file in C:\Program Files or C:\Program Files (x86) because

Windows plays funky tricks with those directories

[http://www.hanselman.com/blog/VistasShowCompatibilityFilesAndTheScrumptiousWonderThatIsFileVirtualiz

ation.aspx]

• Make sure you have a recent version of a Java Runtime Environment (JRE) or Java

Development Kit (JDK), a JRE can be downloaded here http://java.com.

• Download the latest JAR build

from https://github.com/opensourceBIM/BIMserver/releases

• Some browsers rename the JAR file, make sure it ends with ".jar"

• Start the program by double clicking

• Normally you won’t have to change any settings and you can simply start the

BIMserver by clicking "Start"

(OSX) You can change the default JVM under Applications | Utilities | Java Preferences, on some OSX

installations this somehow defaults to an older version of Java where the BIMserver needs version 8._

Page 14: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 14

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Figure 6: BIMserver starter console

Table 2: Settings of the BIMserver starter

Settings Meaning

JVM Allows for a JVM other than the default JVM to be selected (This feature

seems to not be working for some people)

Home

directory

Location of the home directory, this is where the database, log files etc...

are stored. If you have ran a previous version of BIMserver on the same

home directory, the database cannot always be migrated successfully

Page 15: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 15

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Settings Meaning

Address

The address the server will be binding on, if you want the BIMserver to be

available on other machines than your own, you will have to change this

to a real IP address or a hostname pointing to the right IP address

Port The port must be free, and the firewall must be configured to allow

listening on this port

Max heap

size

The amount of heap memory appointed to the instance JVM of the

BIMserver, more heap means larger models can be stored/retrieved. The

amount of heap is limited by the amount of memory available on your

machine, but be sure to always save a few hundred of MB's to your OS

and other applications. On 32-bit Windows computers, the limit is around

1500MB. A Typical BIMserver will need at least 2GB

Max Perm

Size

256MB should be enough, if you are deploying a lot of plugins you might

need more

Stack size

The amount of stack size available for every thread, you are probably not

ever going to need more than 512KB. With a stack size that is too low, you

will be getting StackOverflowError messages

Force IPv4

On some operating systems binding will happen automatically on the IPv6

address of a machine, even if the user is not using IPv6. With this option

you can override to use IPv4, only use this option if you have problems

with this specific issue

Use proxy

server

You can check this option if you need to use a proxy server for outgoing

connections

Proxy

Host The host of your proxy server

Proxy Port The port of your proxy server

3.5 BIMserver setup

After BIMserver is installed, you will see ‘BIMserver started successfully’ in the console screen. Click ‘launch web browser’ after that. You will see the setup screen in a web browser:

Page 16: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 16

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Fill in the data.

Create an admin user. Remember your password!

Page 17: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 17

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

You don’t need to install an e-mail server when you remember your e-mail and password!

Install all available plugins.

Page 18: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 18

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Start the setup.

The setup is running. This might take a while (several minutes)

Page 19: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 19

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

After the setup is finished you will see a link ‘open bimvie.ws’. Bimvie.ws is a plugin that is installed in BIMserver to be able to interact with the server from a Graphical User Interface (GUI).

Fill out your e-mail and password you used for creating an admin user (few steps earlier).

Page 20: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 20

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Well done! You have a running BIMserver on your computer. Click ‘Project’ – ‘New project’ to create your own IFC project.

Choose a name for your project and choose Ifc2x3TC1 as the schema.

Page 21: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 21

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

3.6 Revit plugins installing

This only works on Windows and with Revit already installed. For the Full BRESAER System, download the executable installer from https://github.com/opensourceBIM/BIMBot-RevitPlugin/releases/tag/1.0.6 For the Direct BRESEAR System, download the installer on https://github.com/opensourceBIM/BIMBot-RevitPlugin/releases Follow the installation instructions from the installer.

You might get a warning that the plugin is not signed. Just choose ‘Always Load’ when this happens.

Page 22: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 22

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

After installing the plugin, you will have an extra tab in your Revit screen. In the full BRESAER system, you now need to tell Revit where your Local BIMserver is located, and how to login there. Do this by clicking on the ‘projects’ button in the ‘BIMserver’ ribbon. The first time you will get a ‘login settings for BIMserver’ screen:

Page 23: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 23

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Fill out your credentials. Choose ‘IFC2x3 Coordination View’ and the ‘Ifc2x3TC1’ format. Make sure ‘IFC Export addin is installed’ is checked. You only have to do this once. In the Direct BRESAER system, you have to connect to the BRESAER Bot directly, which you can find in the search screen for Bots. You only have to do this once per project.

3.7 Revit plugins setup

Now let’s link your Revit project to your BIMserver project. This in only needed for the Full BRESAER system. You can skip this for the Direct BRESEAR System setup.

Page 24: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 24

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Click ‘Projects’ in the BIMserver ribbon in Revit. You will see an overview of projects in your local BIMserver. Choose the IFC project you want to link to your Revit file and click ‘save’. And close the screen. You only have to do this once for every Revit project. You can test the setup by clicking on ‘export’.

This will pop up a screen where you can add a comment to your export. Click ‘exporteer’ to send the data from Revit, as IFC, to your local BIMserver.

Page 25: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 25

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Geometry will be created, the revision will be created, lots of stuff is happening, until the progress bar is at 100% and the project is uploaded to your local BIMserver. Repeat this step every time you want your model to be evaluated. Now click ‘> Project’. This will open a web browser and bring you to the IFC project on your local BIMserver.

Click on the ‘eye’-icon right of the project name, and your IFC model will show on screen (make sure you installed all plugins during setup of BIMserver). At this stage, there is no connection yet to the BRESAER online tool. This will be setup later.

Page 26: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 26

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

3.8 Revit families

Download the Revit families from https://github.com/berlotti/Bresaer-tools/releases Follow the Revit installation instructions for installing new Revit Families. Schematic 3D representations of the technological modules used in BRESAER were made in Revit. Each of the components of the modules was grouped as “families”, which is the Revit name for elements that have common sets of parameters and related graphical representation. They can be manipulated as a unit according to the needs of each drawing. They are similar to the “blocks” used in AutoCAD, except that in families, a wider series of variables can be managed by end-users and the representation maintains the association between elements. For example, in a Revit family the global size of a window system can be manipulated, but specific connecting elements would retain their original size and relative position if required. On the other hand, for an AutoCAD block all the comprising elements would change their size when the scale command is applied, and the association needs to be broken in order to edit the block. A family can be composed of a single drawing element or a combination of them, including nested families. Restrictions can also be placed by the creator of the families in terms of the size relationships between the components that constitute the family. A simple example is the proportion between height and width of a metallic profile. A formula can be used to state that relationship, which will be respected in all sizes that the end-user specifies. Families can also be placed in specific component categories to schedule elements in the right ones, and to avoid mixing between incompatible classes. Families were created for the tool with parameters such as width and height open for subsequent specification by end-users of the plugin that would like to modify each module in particular, see overview below. Structural and connecting elements retain their sizes throughout.

Family Model Dimensions Notes

EURECAT

Can be adapted to each case

Page 27: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 27

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

SOLARWALL

Height: up to 6m (Usually 2m) Constant Width 1m

STAM

Width: 0.8-1.1m Height: 0.8-2.7m

ULMA

Width: 0.25m-0.5m steps 50mm 0.5m-0.9m steps 100mm Height: 0.6m-1.8m steps 100mm

3.9 BRESAER BOT subscription

So you have Revit connected to your local BIMserver. Now it is time to connect your local BIMserver to the online BRESAER tool. This in only needed for the Full BRESAER system. You can skip this for the Direct BRESEAR System setup because you already connected to the BRESAER Bot. Do this by opening the IFC project in your local BIMserver again (most probably on http://localhost:8082/apps/bimviews/?page=Projects but could also be something else in your setup). In the full BRESEAR setup you have the option to choose subprojects from other projects to link the BRESAER Bot. This is a distinction from the Direct setup. Open your Project and click on the black triangle on the right of the project name. Choose ‘add external service’ or ‘add BIM Bot’ (depending on the version of BIMserver you have installed). You will get a list of available online services.

Page 28: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 28

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Find the BRESAER service and click ‘add’.

A setup screen follows to make sure your local BIMserver and the remote service speak the same language. In the case of BRESEAR you should probably leave everything default and choose ‘next’. Now your IFC project is linked to the remote service / BIM Bots, but you still have to provide access rights to the remote service. Click ‘authenticate’ behind the name of the BRESAER service. You will get a new screen to provide access to your data. After this step, your local IFC project is connected to the remote BRESAER Service.

3.10 View results

Every time you export your data from Revit it will be placed on your local BIMserver, and send to the BRESAER system. When you click the ‘view’ button in Revit, you will be guided to the BIMserver visualisation tab in your browser. When Revit detects a format that can be imported, it will import the data in native Revit. There are several types of results:

- BIM Collaboration Format – this can be imported in Revit and/or viewed in the browser - Visualisation / IFC – this can be viewed in the browser - Other (text, html, etc) – which can be downloaded and/or viewed in the browser

Page 29: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 29

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Visualisation results will become available for the user with a checkbox in the 3D Visualisation screen. Results of the BRESAER calculation will be placed in the ‘extended data’ tab on your local BIMserver where you can view the results:

Figure 7: Results interpretation

Page 30: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 30

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

4 Data flow

The data flow in the full BRESAER setup is as following:

Figure 8: Data flow in the BRESAER setup

There are two types of interfaces:

- The technical interface between the tools (API) - The Graphical User interface (GUI)

A typical dataflow involves the following steps:

1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export 6. Data transfer 7. Generate + transfer results 8. Store results at IFC project 9. Show results in Revit

The Direct BRESEAR Setup has generally the same dataflow, with the exception of step 3 and 8.

Page 31: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 31

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

5 Modelling guide

5.1 IFC Model view definition

The IFC data schema is very extensive and rich. It has about 800 objects and 12.000 properties defined. The full extent of the IFC agreements are never implemented in software tools. Software vendors only support a part of the full IFC agreement. To define what parts the concept of ‘Model View Definitions’ (MVDs) is created. An MVD defines which parts of the full IFC agreement are supported. The most used and infamous MVD is the ‘coordination view’. Almost every IFC export from a major BIM software tool exports IFC according to the Coordination View MVD. For the Bresaer project, you need to export IFC to the ‘IFC coordination view’, which is the most common and well-known MVD for IFC.

5.2 How to use the Revit families

Families can be manipulated after receiving output from the program. They are placed on the building surfaces where the user can observe if the distribution is adequate. As part of the program output, Revit families that were placed into the drawing can be inserted once more as separate elements representing a given technological module. They have been designed to be placed on a building surface (which might not always be perfectly vertical). Due to this reason, use the option “place on workplane”. After the families have been inserted in the drawing, they can be manipulated for fine-tuning through parameters that are available for editing. All other alignment operations are also available. For families representing the ULMA, STAM and Solarwall* modules, the parameters that are available for user change through the “Properties” panes are their height (parameter h) and width (parameter w). Height refers to the axis-to-axis distance between horizontal panel divisions, while width refers to the axis-to-axis distance between vertical supports. *= in Solarwall the width is constant (1 meter) For the family representing the Eurecat window, two parameters are available for modification: h_window refers to the height of the original window opening, and w_window to the width of the original window opening.

Page 32: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 32

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

6 Results interpretation

The main output of the BRESAER tool is a text file (shown in figure 9) containing a report about the materials used when applying the BRESAER façade elements, and the belonging installation cost.

Figure 9: Example output of the BRESAER tool

The file starts by calculating the generic components for the backing structure like Aluskit vertical profiles. Followed by amounts of components used for each type of façade element that occurs in the model. This accounting also shows how many façade elements of a specific size are used.

Page 33: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 33

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

The cost is estimated by the area the panels cover and therefor also given first for each type of façade element. Near the end of the output file, the total cost of the whole is shown. The components like connectors, rails, anchors, L70’s, L90’s and profiles are calculated from the panels and how they are applied. This counting takes into account that the façade elements can share these components in some cases, reducing the amount needed. Parts like bolts, nuts and washers are calculated by the number of used components mentioned previously. The BRESAER tool also performs a check if façade elements are not positioned in front of openings (windows or doors) in a wall. The Eurecat element is also checked for this, but then if the framing does not cover the opening. Figure 10 shows how these issue elements are highlighted. The framing of the façade element on the left side also covers the window, but the panel itself does not. Since the framing can be repositioned in reality (not within the Revit family) this is not an issue and there for not highlighted.

Figure 10: Visualization of panels in front of openings

Page 34: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 34

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

The flowsheets (mounting order façade elements and its components) are covered by external videos. A link to these videos is included in the output text file shown in figure 8. There are six options described and that can occur. In all cases the example shows how mounting works when a façade element covers (and even exceeds) the vertical Aluskit profile that will be used by a neighbouring façade element as well. Figure 11 shows some images representing flowsheet representing Ulma and Stam mounted side by side. The order makes sure the component needed later for another façade element is place before it becomes inaccessible.

Figure 11: A few images of the flowsheet regarding mounting Ulma and Stam side by side

The videos can be found at: http://www.modelservers.org/public/projects/Bresaer.

Page 35: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 35

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

7 Example case

An example model with BRESAER façade elements is created for this project.

Figure 12: Example model (IFC)

The Revit model and an exported IFC (in coordination view MVD) can be found on https://github.com/opensourceBIM/Bresaer/ The BREASAER example model is created in Revit 2016. You might be using a later version and Revit asks you to upgrade the model. This has no effect on the working of the BRESAER tools and plugins, so feel free to choose what you want.

Page 36: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 36

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

Figure 13: Revit upgrade warning

Figure 14: Revit upgrade result

Page 37: Basic guideline to support the BRESAER design tool · 1. Link Revit project – IFC project 2. Choose BIM Bot 3. Link BIM Bot – IFC project 4. Configurate BIM Bot 5. Trigger / export

D4.5 Basic guideline to support the BRESAER design tool 37

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement N° 637186.

8 Conclusions

The BRESAER BIM tool assists architects and designers in the evaluation of an early design of a specific target building when using façade elements developed in the BRESAER project. The tool is based on a BIM working method. The BRESAER tool is an online BIM service that runs in the cloud. It is based on open BIM standards like IFC and BCF. Within the BRESAER project, a connection is created between the online BIM service and the most common BIM authoring tool Revit. However, for every BIM authoring tool a connection to this online BIM service can be developed. Within task 4.4, advanced new technologies have been developed like Revit plugins, Revit Families and online IFC services. For Revit users, a special object library with BRESAER components was created using Revit Families. From Revit, a user can directly connect to the online BIM service and calculate results, like materials used and installation costs for the specific façade design. This gives designers the ability to create fast iteration of designing, evaluation and changing the design. Furthermore, the mounting order of the façade elements and its components is shown and a check is performed if façade elements are not positioned in front of openings (windows or doors) in a wall. The DOA stated to ‘consider use of BIM’, but we build the whole system fully on BIM technology. This creates extra value for future use in the industry. Instead of creating one tool, task 4.4 created a set of tools that work interconnected. This creates extra value and lowers the threshold for users that prefer working in their existing software tools.