> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/german/plattform/photoreal-twin.md).

# PhotoReal-Zwilling

## Über den Digital Twin

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F8ZWP3U6lAjO0lpp0y3oy%2FDigital%20Twin%20v2_Hero.png?alt=media&#x26;token=8811abf4-53d7-4d9a-8723-a5c597f23687" alt=""><figcaption></figcaption></figure>

In BuildingPro Suites ist ein Digital Twin eine Darstellung eines Geräts, das interaktiv mit einem oder mehreren Assets verbunden ist. Die Darstellung kann ein Foto, aber auch eine technische Zeichnung sein.

Die von den Assets gesendeten Daten werden in der Darstellung über sogenannte Links angezeigt. So können Systeme aus der Ferne ausgelesen werden.

Über die mit dem Digital Twin verbundenen Assets können auch Daten geschrieben werden. Daher ist es möglich, Einstellungen am System direkt über den Digital Twin vorzunehmen.

In BuildingPro Suites besteht ein Digital Twin aus einem oder mehreren Bildern, die frei auf einer Leinwand angeordnet werden können.

## Bedienelemente eines Digital Twins

Der Digital Twin besteht aus den folgenden Elementen:

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FZlK2HHeUkoj4jKCM4LyG%2FDigital%20Twin%20v2_0.png?alt=media&#x26;token=d51866bc-705c-44c6-add5-d772b4477ac1" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="85">Element</th><th width="215">Titel</th><th>Details</th></tr></thead><tbody><tr><td><strong>[Y1]</strong></td><td>Leinwand</td><td>Alle Bilder und anderen Elemente des Digital Twin werden auf der Leinwand angezeigt.</td></tr><tr><td><strong>[Y2]</strong></td><td>Bild</td><td>Ein Bild eines Geräts. Sie können eine unbegrenzte Anzahl an Bildern hochladen.</td></tr><tr><td><strong>[Y3]</strong></td><td>Notiz</td><td>In einer Notiz kann Text eingegeben werden.</td></tr><tr><td><strong>[Y4]</strong></td><td>Link</td><td>Zeigt einen Wert eines Assets an</td></tr><tr><td><strong>[Y5]</strong></td><td>Link mit Referenzpunkt</td><td>Der Referenzpunkt kann über einem Bild platziert werden, um die Verständlichkeit des Digital Twin zu erhöhen.</td></tr></tbody></table>

## Einen Digital Twin erstellen

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FZKZAqt786FmKdQCMXuzA%2FDigitalTwinv2_1.png?alt=media&#x26;token=23203496-7066-464d-adcf-65961eade0f9" alt=""><figcaption></figcaption></figure>

1. Klicken Sie auf Digital Twin **\[A]**\
   ▷ Die Digital-Twin-Übersicht öffnet sich **\[A1]**
2. Klicken Sie auf **\[B]**\
   ▷ Das Fenster **\[C]** öffnet sich
3. Geben Sie dem Digital Twin in **\[C1]**
4. Optional: In **\[A]**, geben Sie ein übergeordnetes Asset an. In diesem Fall können nur Assets verwendet werden, die diesem übergeordneten Asset untergeordnet sind.
5. Klicken Sie auf **\[C3]**\
   ▷ Der Digital Twin wird erstellt und geöffnet **\[D]**

Nach der Erstellung ist der Digital Twin leer. Fahren Sie mit den nächsten Schritten fort, um den Digital Twin zu konfigurieren.

## Ein Bild hinzufügen

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FnRWdIu638fd54ZxptH9C%2FDigitalTwinv2_2.png?alt=media&#x26;token=6ffd0f2a-f185-44c9-b076-46ae1313c322" alt=""><figcaption></figcaption></figure>

Voraussetzung: Sie befinden sich in einem Digital Twin **\[D]**

1. Klicken Sie auf **\[D1]**\
   ▷ Das Fenster **\[E]** wird geöffnet.
2. Klicken Sie auf **\[E1]** um ein Bild hochzuladen oder ein Bild dort per [↗ Drag'n'Drop abzulegen.](/collection/german/vorwort/user-interface-elements.md#dragging-elements)
3. Das Bild wird hochgeladen **\[E2]**
4. Das Bild erscheint im Digital Twin

### Ein weiteres Bild hinzufügen

In einigen Fällen kann es sinnvoll sein, mehrere Bilder desselben Systems anzuzeigen. Dies ist zum Beispiel der Fall, wenn nicht alle Bedienelemente auf einem Foto gezeigt werden können, weil sie sich beispielsweise auf der Rückseite des Geräts befinden.

Wiederholen Sie die Schritte aus ↗ Ein Bild hinzufügen, um ein weiteres Bild hinzuzufügen. Sie können eine unbegrenzte Anzahl an Bildern hinzufügen.

## Im Digital Twin navigieren

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FPKh6Z7FruAwQBpPgbC1B%2FDigitalTwinv2_3.png?alt=media&#x26;token=0c5e87eb-8fe4-4563-b31f-3b52e51add62" alt=""><figcaption></figcaption></figure>

### Leinwand verschieben

Sie können die Leinwand verschieben.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FhUVCpK261CJ9x4PEOk9i%2FAdobe%20Express%202024-03-15%2017.17.37.gif?alt=media&#x26;token=167f3ef1-2bde-4b13-9189-af47006a1863" alt=""><figcaption></figcaption></figure>

1. Klicken Sie mit der linken Maustaste auf die Leinwand und verschieben Sie die Leinwand per Drag'n'Drop.

#### Bild verschieben

1. Klicken Sie mit der linken Maustaste auf ein Bild und verschieben Sie es per Drag'n'Drop auf der Leinwand.

#### Bild drehen

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FlRQK6TxnCUH7Bz525TGH%2FAdobe%20Express%202024-03-15%2017.18.08.gif?alt=media&#x26;token=a5f24a3a-a375-4c72-a586-4ef84b84da46" alt=""><figcaption></figcaption></figure>

1. Klicken Sie mit der linken Maustaste auf ein Bild.\
   ▷ Das Bild wird blau umrandet und mehrere Bedienelemente werden angezeigt.
2. Verschieben **\[F2]** per Drag'n'Drop, um das Bild zu drehen.

#### Bild vergrößern/verkleinern

1. Klicken Sie mit der linken Maustaste auf ein Bild.\
   ▷ Das Bild wird blau umrandet und mehrere Bedienelemente werden angezeigt.
2. Verschieben **\[F3]** per Drag'n'Drop, um das Bild zu drehen.

#### Bild skalieren

1. Klicken Sie mit der linken Maustaste auf ein Bild.\
   ▷ Das Bild wird blau umrandet und mehrere Bedienelemente werden angezeigt.
2. Verschieben **\[F4]** per Drag'n'Drop, um das Bild zu drehen.

#### Bild sperren

Sie können die Position des Bildes auf der Leinwand sperren, damit es nicht versehentlich verschoben wird.

1. Klicken Sie mit der linken Maustaste auf ein Bild.\
   ▷ Das Bild wird blau umrandet und mehrere Bedienelemente werden angezeigt.
2. Klicken Sie auf **\[F5]** um die Position des Bildes zu sperren.

### Aktuelle Ansicht speichern

Um **speichern** die aktuelle **Ansicht der Leinwand** in Ihrem Digital Twin, klicken Sie zunächst auf das Zahnradsymbol <img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FMASXhb3CG4ZPF4xjq349%2Fimage.png?alt=media&#x26;token=1d259e3f-c192-4dc9-80db-791aa10ea05c" alt="" data-size="line"> in der oberen rechten Ecke der Leinwand. Ein Fenster öffnet sich <img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2Fee7vlDNY28Dnzsp54DtH%2Fimage.png?alt=media&#x26;token=2f8332f1-cfe8-4e99-9deb-3e3af6ba99e9" alt="" data-size="original"> in dem Sie die Option **"Ansicht als Standard speichern"**. Wenn Sie auf diese Option klicken, werden der aktuell eingestellte Maßstab und die Position der Viewbox gespeichert. Wenn Sie diesen Digital Twin das nächste Mal öffnen, wird er automatisch in der gespeicherten Ansicht geladen.

## Einen Wert verknüpfen

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2Ffj7yuKKaGXDL7D4qYNkY%2FDigitaler%20Zwilling%20Link%20(1).png?alt=media&#x26;token=82a24631-9043-4afb-9167-ddab33e01a28" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FzMjDDjKWz5k2TqVYOt6I%2FDigitaler%20Zwilling%20Link%20(7).png?alt=media&#x26;token=ae1e785c-5068-454b-b000-387711db628b" alt=""><figcaption></figcaption></figure>

Voraussetzung: Sie befinden sich in einem Digital Twin **\[D]**

1. Klicken Sie auf **\[D1]**
2. Klicken Sie auf die Leinwand, wo der Link erscheinen soll.\
   ▷ Ein Link **\[D2]** erscheint.
3. Klicken Sie auf den Link **\[D2]** mit der linken Maustaste\
   ▷ Die Seitenleiste **\[D3]** öffnet sich
4. Klicken Sie auf „Config“ **\[A]**\
   ▷ die Konfiguration **\[D3]** wird angezeigt.
5. In **\[B]**, wählen Sie das Asset aus, dessen Werte im Link angezeigt werden sollen.
6. In **\[C]**, können Sie die Form des Links ändern.
7. In **\[D]**, wählen Sie die Farbe aus, in der der Link angezeigt wird.
8. Optional: Aktivieren Sie **\[E]** um zu verhindern, dass der Link per Drag-and-Drop mit der Maus verschoben wird.
9. Optional: Aktivieren Sie **\[F]** um einen Referenzpunkt zu aktivieren.\
   ▷ Sie können den Referenzpunkt auf dem Bild per Drag-and-Drop verschieben.
10. Optional: Mit **\[G]**, aktivieren Sie einen Titel für den Link.
11. Optional: Aktivieren Sie **\[H]** um den Status des Assets anzuzeigen.
12. Aktivieren **\[I]** um Attributwerte des Assets im Link anzuzeigen.\
    ▷ In **\[I1]**, können Sie die Attribute auswählen, die sichtbar sein sollen.\
    ▷ In **\[I2]**, können Sie Beschriftungen für die Attribute anzeigen.\
    ▷ Um aggregierte Daten anzuzeigen, klicken Sie auf **\[I3]** und aktivieren Sie **\[I4]** und wählen Sie eine Aggregation aus.
13. Optional: In **\[J]**, wählen Sie die Wertzuordnung zu Farben aus. Klicken Sie auf das entsprechende Attribut und fügen Sie dann die Zuordnung hinzu. Siehe auch [-> Wertzuordnung in BuildingPro Suites](/collection/german/akademie/value-mapping-in-eliona.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.buildings.ability.abb/collection/german/plattform/photoreal-twin.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.