Communicator for BIM

Table of Contents

In this chapter, we will discuss some of the features in HOOPS Communicator specific to the Building and Construction industry.

Supported formats

A list of all supported formats of HOOPS Communicator can viewed in the File Formats Reference Page.

The file formats specifically relevant to BIM are:

  • IFC

  • Revit

  • DWG 2D/3D and DXF

IFC

After an IFC file has been converted to the Stream Cache format, it can be viewed and interrogated in the HOOPS Web Viewer. The Model Tree in the case of an IFC model is derived from its structural building hierarchy (IFCBUILDING->IFCFLOOR->IFCSPACE…) with additional properties and attributes stored on the nodes of the model. The GlobalIDs of an IFC file are also stored among those attributes. More information on how to parse attributes in a model can be found here.

You can also export IFC data file to an XML file with the --output_xml_assemblytree command line option which you can then use to parse that attribute data outside of the viewer.

../../_images/BIM_IFCWall.png

Properties for a IFCWall element displayed in the HOOPS Web Viewer

IFC types

When loading a Stream Cache model converted from an IFC file into the HOOPS Web Viewer you can get a list of all IFC Types that exist in the model with the getGenericTypes() function.

    var ifctypelist = hwv.model.getGenericTypes();

Result:

"IFCPROJECT"

"IFCSITE"

"IFCBUILDING"

"IFCBUILDINGSTOREY"

"IFCSPACE"

"IFCSLAB"

"IFCBEAM"

"IFCRAMP"

"IFCCOLUMN"

...

Given the types above, you can get a list of nodes for a specific IFC type with the getNodesByGenericType() function.

    var nodelist = hwv.model.getNodesByGenericType("IFCDOOR");

To query the IFC type of an individual node, you can use the getNodeGenericType() function below:

    var nodeid = hwv.model.getNodeGenericType(10693);
../../_images/BIM_highlighted.png

An IFC model with all elements of type IFCDOOR highlighted.

Spatial Relationships

HOOPS Communicator supports spatial relationships for BIM elements in IFC files. Each BIM element has an ID, represented as a string. Relationships must be imported when the CAD file is loaded. The following options are available:

ifc_import_relationships: If set, relationships set in an IFC CAD file will be imported. The default value is true.

ifc_import_openings: If set, opening elements in the CAD file will be imported and seen as a node in the Viewer. The default value is false.

Here’s an example of how to get BIM information from a selection event:

var selection = selectionEvent.getSelection();
var nodeId = selection.getNodeId();
var bimId = hwv.model.getBimIdFromNode(nodeId);

console.log("bimInfo == " + JSON.stringify(hwv.model.getBimInfoFromBimId(nodeId, bimId), null, 2));

Result:

bimInfo == {
        "name": "Basic Wall:Generic - 500mm:214590",
        "connected": true
}

Using the bimId, we can get the IDs of related elements. For example, to get the related element IDs for ContainedInSpatialStructure:

containedInSpatialStructure = hwv.model.getBimIdRelatingElements(nodeId, bimId, Communicator.RelationshipType.ContainedInSpatialStructure);

for (var i = 0; i < containedInSpatialStructure.length; i++) {
        console.log(JSON.stringify(containedInSpatialStructure[i]));
}

In general, functions that end in “FromBimId” can be used to query the model using a BIM ID. For example: getNodeIdFromBimId(nodeId, bimId). Other useful functions:

  • getBimIdFromNode

  • getBimIdsFromGenericId

  • getNodeIdFromBimId

  • getGenericIdFromBimId

  • getRelationshipTypesFromBimId

  • getBimIdRelatedElements

  • getBimIdRelatingElements

  • getBimIdConnectedElements

  • getBimInfoFromBimId

The HOOPS Communicator demo UI also supports IFC relationships. In the image below, the window has been selected. The chart on the left (under the model tree) shows the elements related to the window: ContainedInSpatialStructure, FillsElement, and SpaceBoundary.

../../_images/spatial_relationships.png

IFC Layers

HOOPS Communicator will convert all IFCPRESENTATIONLAYERASSIGNMENT` elements in IFC models to layers that can be queried in the HOOPS Web Viewer. To find out more about layers please refer to this Programming Guide entry.

IFC GlobalID

When an IFC model is converted to a Stream Cache the IFC GlobalId attribute of an entity is not only available by querying the properties of the node but can also be accessed directly via the getNodeGenericId() function.

    var IFCGlobalID = hwv.model.getNodeGenericId(8813);

Result:

"06MIg93QbEyhsz9Us1N2lq"

To retrieve a list of nodes ids based on their generic id you can use the getNodeIdsByGenericIds() function, which takes a list of generic IDs and returns their corresponding NodeIds.

    var nodeids = hwv.model.getNodeIdsByGenericIds(["06MIg93QbEyhsz9Us1N2lq"]);

Result:

[8813]

IFC Walk Operator

When loading a Stream Cache Model converted from an IFC file, the keyboard-based walk operator uses a set of predefined IFC types to determine walls and floors in a model. Based on that information it can perform collision detection as the user navigates through the model, automatically adjusting the height of the camera to the floor and blocking movement through walls.

To activate the keyboard-based walk operator and enable collision detection please see the code below:

    var keyboardWalkOperator = hwv.operatorManager.getOperator(
        Communicator.OperatorId.KeyboardWalk,
    );
    keyboardWalkOperator.enableBimMode();
    var walkMode = 1;
    var walkModeOperator = hwv.operatorManager.getOperator(Communicator.OperatorId.WalkMode);
    walkModeOperator.setWalkMode(walkMode);
    hwv.operatorManager.set(Communicator.OperatorId.WalkMode, 0);

Please note that activating collision detection can affect performance with larger models.

See below for the default keys when using keyboard-based walk:

../../_images/BIM_default_keys.png

Properties for a IFCWall element displayed in the HOOPS Web Viewer

Revit

Revit support has been officially introduced with HC2019 and has seen constant improvements. Currently, it offers support for:

  • Node attributes

  • 3D views

  • Layers

  • Textures and colors

  • Linked views

Support for 2D Views (elevation views, etc) and other enhancements are planned for a future release.

../../_images/BIM_revit_example.png

Revit example model with part properties

DWG

HOOPS Communicator supports 2D and 3D content within a DWG file with the ability to display each sheet in a DWG file as well as the 3D geometry.

Importing DWGs

When importing DWG files you can specify if you are only interested in the 2D (drawing) content, the 3D data within a DWG file or both with the --drawings_mode Converter command line option. If you choose both then the sheet tab in the model browser will contain all sheets as well as the 3D model.

Sheets

When a DWG file has been imported with drawings enabled then each sheet will be visible in the Sheet tab in the model browser. By clicking on a sheet in the model browser the HOOPS Web Viewer will switch to the new sheet.

To find all sheets in a model when writing your UI programmatically you can use the getSheetIds() function which returns a list of NodeIds for each sheet representing the top-level node for each sheet.

    var sheetids = hwv.sheetManager.getSheetIds();

Results:

[4, 56706]

You can also get the NodeId of the currently active sheet with the getActiveSheetId() function.

To switch to a new sheet you can use the setActiveSheetId() function.

    hwv.sheetManager.setActiveSheetId(56706);

When a 2D sheet is activated the HOOPS Web Viewer will automatically switch to “drawing mode”, ensuring that camera manipulation is constrained, and a drawing background is added to the model.

../../_images/BIM_DWG_file.png

Properties for an IFCWall element displayed in the HOOPS Web Viewer

By default, the HOOPS Web Viewer will display a drawing sheet on a white background with a dark grey shadow effect on top of a grey window background. You can change the color of both backgrounds and the shadow with the setSheetColors() function.

    hwv.sheetManager.setSheetColors(
        Communicator.Color.white(),
        Communicator.Color.black(),
        Communicator.Color.white(),
    );

You can also choose to turn off the sheet background altogether with the setBackgroundSheetEnabled() function.

    hwv.sheetManager.setBackgroundSheetEnabled(false);
../../_images/BIM_model_no_sheet_background.png

Properties for a IFCWall element displayed in the HOOPS Web Viewer

Federated models in BIM

A common concept in BIM is to break up large building projects into multiple disciplines (Architectural, Plumbing, Mechanical, etc.) each worked on by different teams and often represented by their model files. To support this workflow HOOPS Communicator allows you to easily aggregate models in the HOOPS Web Viewer using the loadSubtree functionality.

For more information about model aggregation please see the Loading Subtrees Programming Guide.