# Digital Twin

## About the Digital Twin

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/GSttPqoEPROpqLVsrjQN/Digital%20Twin%20v2_Hero.png" alt=""><figcaption></figcaption></figure>

In Eliona, a Digital Twin is the representation of a device that is interactively linked to one or more assets. The representation can be a photo, but also a technical drawing.

Data sent by the assets is displayed in the representation via so-called links. This allows systems to be read remotely.

Data can also be written via the assets connected to the Digital Twin. This makes it possible to make settings directly on the system via the Digital Twin.

In Eliona, a Digital Twin consists of one or more images that can be freely arranged on a canvas.

## Controls of a Digital Twin

The Digital Twin consists of the following elements:

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/1cij719vfgvQnGR5JHgU/Digital%20Twin%20v2_0.png" alt=""><figcaption></figcaption></figure>

| Element   | Title                     | Details                                                                                     |
| --------- | ------------------------- | ------------------------------------------------------------------------------------------- |
| **\[Y1]** | Canvas                    | All images and other elements of the Digital Twin are displayed on the canvas.              |
| **\[Y2]** | Image                     | An image of a device. You can upload unlimited images.                                      |
| **\[Y3]** | Note                      | Text can be entered in a note.                                                              |
| **\[Y4]** | Link                      | Displays a value of an asset                                                                |
| **\[Y5]** | Link with reference point | The reference point can be placed over an image to improve the clarity of the Digital Twin. |

## Create a Digital Twin

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/4paINCYpUIRDhBg61uvh/DigitalTwinv2_1.png" alt=""><figcaption></figcaption></figure>

1. Click on Digital Twin **\[A]** ▷ The Digital Twin overview opens **\[A1]**
2. Click on **\[B]** ▷ The window **\[C]** opens
3. Assign the Digital Twin in **\[C1]** a name
4. Optional: Enter in **\[A]** a parent asset. In this case, only assets that are subordinate to this parent asset can be used.
5. Click on **\[C3]** ▷ The Digital Twin is created and opened **\[D]**

The Digital Twin created is empty after creation. Continue with the next steps to configure the Digital Twin.

## Add an image

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/x6HbuMPohsiYo9jFoaBn/DigitalTwinv2_2.png" alt=""><figcaption></figcaption></figure>

Prerequisite: You are in a Digital Twin **\[D]**

1. Click on **\[D1]** \
   ▷ The window **\[E]** opens.
2. Click on **\[E1]**, to upload an image or place an image there via [↗ Drag’n’Drop](https://docs.buildings.ability.abb/collection/english-v14/foreword/controls#dragn-drop) .
3. The image is uploaded **\[E2]**
4. The image appears in the Digital Twin

### Add another image

In some cases, it can be useful to display several images of the same system. This is the case, for example, if not all controls can be shown in one photo because, for example, they are located on the back of the device.

Repeat the steps from ↗ Add an image to add another image. You can add an unlimited number of images.

## Navigate in the Digital Twin

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/EuNdXkh1xLDQztwDnXJH/DigitalTwinv2_3.png" alt=""><figcaption></figcaption></figure>

### Pan canvas

You can move the canvas.

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/xyuZxc2plbZq8e8Oa2zu/Adobe%20Express%202024-03-15%2017.17.37.gif" alt=""><figcaption></figcaption></figure>

1. Click with the left mouse button in the canvas and pan the canvas by drag and drop.

#### Move image

1. Click with the left mouse button on an image and move it on the canvas by drag and drop.

#### Rotate image

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/vHlDcYQU4VCuy9oQMGfB/Adobe%20Express%202024-03-15%2017.18.08.gif" alt=""><figcaption></figcaption></figure>

1. Click with the left mouse button on an image. ▷ The image is outlined in blue and several controls appear.
2. Move **\[F2]** by drag and drop to rotate the image.

#### Enlarge/reduce image

1. Click with the left mouse button on an image. \
   ▷ The image is outlined in blue and several controls appear.
2. Move **\[F3]** by drag and drop to rotate the image.

#### Scale image

1. Click with the left mouse button on an image. \
   ▷ The image is outlined in blue and several controls appear.
2. Move **\[F4]** by drag and drop to rotate the image.

#### Lock image

You can lock the position of the image on the canvas so that it cannot be moved accidentally.

1. Click with the left mouse button on an image. \
   ▷ The image is outlined in blue and several controls appear.
2. Click on **\[F5]**, to lock the position of the image.

### Save the current view

To **the current view of the canvas** in your Digital Twin **save**, first click the gear icon <img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/nTXA4fSHfaKhJUseVX0Z/image.png" alt="" data-size="line"> in the upper right corner of the canvas. A window opens <img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/9nsyRFMnVe3Voe2E5ZFX/image.png" alt="" data-size="original">

in which you will find the option **"Save view as default**". If you click this option, the currently set scale as well as the position of the viewbox will be saved. The next time this Digital Twin is opened, it will automatically be loaded in the saved view.&#x20;

## Link a value

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/Q8WEnmZlbgldG3eCL2jB/Digitaler%20Zwilling%20Link%20(1).png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/2WLRrDu86Z5Ki6tUB3kX/Digitaler%20Zwilling%20Link%20(7).png" alt=""><figcaption></figcaption></figure>

Prerequisite: You are in a Digital Twin **\[D]**

1. Click on **\[D1]**
2. Click on the canvas at the location where the link should appear. ▷ A link **\[D2]** appears.
3. Click with the left mouse button on the link **\[D2]** ▷ The sidebar **\[D3]** opens
4. Click on "Config" **\[A]** ▷ the configuration **\[D3]** is displayed.
5. Select in **\[B]** the asset whose values should be displayed in the link.
6. In **\[C]** you can change the shape of the link.
7. Select in **\[D]** the color in which the link is displayed
8. Optional: Activate **\[E]** to prevent the link from being moved by drag and drop with the mouse.
9. Optional: Activate in **\[F]** a reference point. ▷ You can move the reference point in the image by drag and drop
10. Optional: Activate with **\[G]** a title for the link.
11. Optional: Activate with **\[H]** to display the status of the asset.
12. Activate **\[I]** to display attribute values of the asset in the link.

    ▷ In **\[I1]** you can select the attributes that should be visible.

    ▷ In **\[I2]** you can show labels for the attributes.

    ▷ To display aggregated data, click on **\[I3]** and activate **\[I4]** and select an aggregation.
13. Optional: Select **\[J]** the value mapping to colors. Click on the respective attribute and then add the mapping. See also [-> Value mapping in Eliona](https://docs.buildings.ability.abb/collection/english-v14/academy/value-mapping-in-eliona)

##


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.buildings.ability.abb/collection/english-v14/documentation/digital-twin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.