Skip to content

OpenBIMRL | Structure

Structure (Name WIP)

Gesamtansicht.png

1. Perform check

In order to perform a check, the check documents must first be configured:

  1. Select rule set: At least one rule set must be selected. The quick upload of a rule set in openBIMRL format can be done directly via the view menu. The rule editor can be used to individually manage all check rules in the project.

  2. Select model: Optionally, the model to be checked can be set. All models are checked as standard.

Each rule set can contain any number of rules, each of which is represented by its own graph. The check is started via the playback icon below the selection and checks all selected rule sets. After the check, the check results are listed and can be evaluated on the model.

Aufbau1.png

2. Evaluate check results

The output of the check results takes place in the lower area.

Rule sets can be expanded to display the individual rules and these in turn can be expanded to display check results for individual items. Via the button Details is... (nothing is displayed? except in case of success).

Auswertung.png

Switch on visualization

Check results can be visualized on the model. The eye symbol next to the corresponding rule is used for this purpose. In addition, the graph symbol can be used to display the corresponding graph.

switchVisualization1.png

switchVisualization2.png

left: before switching on teh visualization, right: after switching on the visualization

3. Editor functions/ Navigation bar

Aufbau2.png

Besides the play button, there are buttons for:

  1. Reset view: resets the displayed highlights of a checking rule in the model.
  2. Edit mode: turns on the edit mode for the graph and expands the toolbar in the graph view.

The toolbar allows various editing options for the control graph.

ToolbarExtended.png

left: Toolbar in normal state, right: Toolbar in edit mode

From left to right, these buttons exist in the edit mode:

  1. Change of focus: Toggles between interactive focus of the 3D viewer and the graph.
  2. Node function menu: Opens the block library in which all existing blocks are displayed in groups. The search
  3. bar can be used to quickly find specific blocks and add them to a rule via drag & drop.
  4. add to group: Adds selected nodes to a group.
  5. remove from group: Removes selected nodes from a group.
  6. rest to graph center: Resets the camera to the graph center.
  7. reset to canvas origin: Resets the camera to the canvas origin.
  8. Background grid: Turns the background grid on/off.
  9. Latency: Turns on/off the processing time of each node.

4. Graph view

With an openBIMRL graph, a building model can be cheked against self-defined rules using graphical programming. A graph is always read from left to right and usually starts with an input block and ends with an output block, as shown in the example below.

How do i create an openBIMRL graph?

Here, a step-by-step tutorial illustrates a small example of how to create a new graph.

  1. Activate the edit mode.
  2. Selectt Create Rule Set from the Function Area Menu
  3. In the Selection list of rule sets, select the newly created rule set.
    Erstellen1-3.png
  4. Unfold the set in the lower section.
  5. Click the +-Icon and enter a name.
    Erstellen4-5.png
  6. Save the change.
  7. Display the graph of the rule using the corresponding button.
  8. Change the focus from the 3D viewer to the graph view.
    Erstellen6-8

Now you have already created a new graph, which will be filled with blocks in the following.

Add blocks
  1. Open the Block library.
  2. Search for addition.
  3. Drag the additions block from the Math - Operators group into the workspace.
    BlöckeAdden.png
  4. Search for Input.
  5. Drag two textInput blocks from the Input Functions group into the workspace.
  6. Search for Identifier
  7. Drag the RuleIdentifier block from the Identifiers group into the workspace.

The graph is almost complete, it just needs to be linked now and get input values.

  1. Drag an edge from each of the gray nodes of the input blocks to the two left gray nodes of the addition block.
  2. Connect the addition block to the RuleIdentifier block in the same way.
  3. Add values to the input blocks by double-clicking on each of them.
    BlöckeVerknüpfen.png

Now you have successfully created an openBIMRL graph which can be used for checking via the play button.

Use cases in an openBIMRL graph

Move in graph

The navigation in the graph is done with the mouse. You have the possibility to move the graph with the left mouse button and to zoom in or out with the mouse wheel. By clicking on blocks you select them and can drag them around in the workspace.

simple interaction with blocks

After selection a block, you can use the typical Windows shortcuts to select the node:

  • copy (STRG+C)
  • paste (STRG+V)
  • delete (DEL)
advanced interaction with blocks

Furthermore you can:

  • select a set of blocks (STRG+Links click)
  • Select blocks within an area (SHIFT+DRAG)
Grouping blocks

A group can be created when a single block is selected and then the Add to group button is pressed or when multiple blocks are selected without a group.

When selecting blocks that are already in a group, all selected blocks are added to a group regardless of whether they were in a group or not. The group to add to is determined by which block was selected last.