Skip to main content

Assets

This example shows how you can place assets inside the structure of the digital twin and attach documents such as manuals, instructions and photos. The digital twin now becomes a 3D navigation tool to navigate the equipment database and view real time IoT data as well as life cycle documents and maintenance information.

Solids​

In this example we place a TV, washing machine and a few routers inside the structure. The TV is represented by a binary GLTF model that was downloaded from Sketchfab. The washing machine is created with the solid modeler. It includes a simple box shape and a texture of an uploaded image that is applied to one of the sides of the box that faces the positive X-axis.

To avoid that a solid has to be created for every piece of equipment we define a generic solid Box that has three parameters for its dimension and an optional fourth parameter to define the color. In this example the routers will be represented as red boxes.

Topics​

The following topics are created to specify the washing machine. The geometry topic links to the name of the solid and the location is specified by the topic that represents the space. This space has a subtopic node that links to the geometry but this is not relevant to the user. A translation subtopic is entered to specify the location of the washer relative to the origin of the space. The datasheet links to a PDF that has been uploaded as a file. The form subtopic specifies the form that should be used when the asset is selected in the 3D model.

building.home.utilities.washer.geometry = Miele WWF 120()
building.home.utilities.washer.location = building.home.structure.HVAC
building.home.utilities.washer.translation = 1, 1, 0.3
building.home.utilities.washer.datasheet = miele_wwf120_datasheet.pdf
building.home.utilities.washer.form = Equipment

To place the television the following topics are defined:

building.home.multimedia.tv.geometry = tv.glb
building.home.multimedia.tv.location = building.home.structure.Living
building.home.multimedia.tv.translation = 10, 8.7, 0.3

There geometry of the routers are defined by linking to the solid Box and specify the dimensions and color as a parameter. Note that the router do not have a location subtopic. This means that they are positioned relative to the origin of the model instead of the origin of a specific space in the model. 

building.home.it.router_1.geometry = Box(0.02, 0.2, 0.3, `red`)
building.home.it.router_1.translation = 12, 6, 2
...

Form​

The form for showing information about the equipment has several pages defined by the --> token. The first page shows an uploaded photo and a quick instruction. The second page shows a PDF of the datasheet. The third page is used to set of modify the location in the 3D model.

Equipment

Name
|12

Photo
[document]
|6

Instruction
[markdown]
|6

Installationdate
|6

Warrantydate
|6



-->

Datasheet
[document]

-->

Location

Translation

Rotation

Geometry

Model​

The model includes the topics for the structure, utilities, multimedia and it equipment. You can optionally hide or show these topics or render them with transparency, such as the structure.

When the user clicks on the washer in the 3D model the form is displayed. The different pages of the forms are displayed by clicking on the next button at the bottom of the form. You can decide whether to use the same form for all assets or create special forms for one or more assets via the form subtopic.