Skip to content

MetricCharts

Jump to bottom
Leonard edited this page Dec 16, 2020 · 3 revisions

English Version

Graphen

Implementiert im Rahmen einer Bachelorarbeit von Robert Bohnsack

Setup in Unity

Um die Graphen in Unity zu benutzen, müssen folgende Schritte beachtet werden:

Setup der Szene

Zur Benutzung kann die voreingestellte Szene ChartMigration geöffnet und gestartet werden.

Wer sich die Szene selbst erstellen möchte, folgt der bereits bestehenden Anleitung. Daraufhin müssen noch einige Anpassungen getätigt werden.

  • Das VRPlayer Prefab muss mit dem VRPlayer Prefab aus Charts (Assets/SEE/Charts/Prefabs/ChartsPlayer.prefab) ersetzt werden. Der Name sollte dennoch VRPlayer lauten.
  • Beim GameObject GamepadPlayer müssen zusätzlich ChartControlDevice und ChartAction belegt werden.
  • Dasselbe wie für GamepadPlayer gilt auch für DesktopPlayer
  • Das ChartManager Prefab (Assets/SEE/Charts/Prefabs/ChartManager.prefab) muss der Szene hinzugefügt werden. -- Die Länge der Liste NonVrObjects muss auf 2 gestellt werden. Dieser werden die MainCamera und das EventSystem hinzugefügt. -- Dem Kind ChartsVR muss unter CameraTransform der Transform der VR Kamera (VRPlayer $\rightarrow$ SteamVRObjects $\rightarrow$ VRCamera) hinzugefügt werden.

Controller Belegung für VR

Zur Änderung der Controller Belegung vom Unity Editor aus, muss über den Browser verfahren werden. Die entsprechende Seite wird in Unity über Window $\rightarrow$ SteamVR Input $\rightarrow$ Open Binding UI geöffnet. Aufgrund eines Fehlers muss in manchen Fällen zudem der Port in der URL zu 27062 geändert werden. Dies wird möglicherweise in Zukunft behoben. Nun können den Tasten der Controller über ein simples Interface die in Unity definierten Funktionen nach Belieben zugewiesen werden.

Benutzung

Erstellung von Graphen

Desktop

Die Oberfläche zum Erstellen von Graphen kann mit der Taste "G" geöffnet und geschlossen werden. Unten links in der Ecke befindet sich eine Schaltfläche zum Erstellen der Graphen.

VR

Die Aktion zum erstellen eines Graphen kann über die Controller Belegung beliebig zugewiesen werden.

Benutzeroberfläche der Graphen

In der Folgenden Abbildung ist ein Graph zu sehen, welcher so in der Software auftauchen könnte.

Bild eines Graphen

Nr. in Grafik Funktion
1 Schließt den Graphen
2 Durch ziehen kann die Größe des Graphen verändert werden
3 Gibt an welche Metrik auf der jeweiligen Achse angezeigt wird. Durch einen Klick wird eine Liste geöffnet, aus welcher eine neue Metrik gewählt werden kann
4 Ein Marker. Durch einen einfachen Klick wird dieser, so wie der mit ihm verbundene Knoten und alle anderen mit dem Knoten verbundenen Marker hervorgehoben. Wird dann über ihn gehovert, so wird die Hervorhebung akzentuiert. Durch einen Doppelklick wird die Kamera zu dem verbundenen Knoten bewegt
5 Eine rötliche Einfärbung eines Markers bedeutet, dass dieser einen oder mehrere andere Marker überlagert. Je röter die Einfärbung, desto mehr Marker werden überlagert
6 Diese Zahlen stellen die maximalen und minimalen Werte auf den beiden Achsen dar
7 Ein Infotext, welcher den Namen des verbundenen Knotens, so wie seine Werte für die Metriken auf beiden Achsen enthält
8 Wird diese Schaltfläche gedrückt gehalten, so kann der Graph verschoben werden. Ein Klick führt zur Minimierung des Graphen
9 Aktiviert oder deaktiviert die Seitenleiste des Graphen

Benutzeroberfläche der Seitenleiste

Bild der Seitenleiste

Nr. in Grafik Funktion
1 Über diese Schalfläche lässt sich zwischen der Ansicht als Baum und der Standardansicht wechseln
2 Diese Schaltfläche aktiviert oder deaktiviert den Knoten im aktuellen Graphen. Ist der Knoten kein Blattknoten, so werden alle darunter liegenden Knoten auch deaktiviert
3 Der Name des Knotens

Quellen

In der Benutzeroberfläche der Graphen tauchen einige Grafiken auf. Diese stammen aus folgenden Quellen:

  • Icon zum Schließen von Graphen: Close Window icon icon by Icons8
  • Icon zum Verschieben von Graphen: Hand Drag icon icon by Icons8
  • Icon zur Größenveränderung: Enlarge icon icon by Icons8
  • Icon zum Öffnen der Seitenleiste: flaticon.com by Kirill Kazachek
  • Icon Darstellung als Baum: flaticon.com by srip

English Version

Graphs

Implemented as part of a bachelor thesis by Robert Bohnsack

Setup in Unity

To use the graphs, the following steps must be followed:

Scene Setup

The preconfigured scene ChartMigration may be opened and started for use.

If one wants to create his own scene, then one should follow the pre-existing [instructions] (NonAnimatedScene). Afterwards, some changes need to be performed:

  • The VRPlayer Prefab must be replaced by the VRPlayer Prefab of Charts (Assets/SEE/Charts/Prefabs/ChartsPlayer.prefab). The Name should nonetheless remain VRPlayer.
  • In the GameObject GamepadPlayer the additional fields ChartControlDevice and ChartAction must be assigned.
  • The same thing must be done to DesktopPlayer -- The length of the list NonVrObjects must be set to 2. These will be added to the MainCamera and the EventSystem. -- The Child ChartsVR must be added to the transform of the VR camera in CameraTransform (VRPlayer $\rightarrow$ SteamVRObjects $\rightarrow$ VRCamera)

Controller Assignment in VR

To change the controller assignment in the Unity editor, the browser must be used. The corresponding site is opened in Unity through Window $\rightarrow$ SteamVR Input $\rightarrow$ Open Binding UI. In some cases, because of an error, the port must be changed to 27062 in the URL field. This may be resolved in the future. Now the controller keybindings may be defined at will using a simple interface to bind the keys to functions.

Usage

Graph Creation

Desktop

The graph creation interface can be opened and closed with the "G" key. Within that, in the lower left corner, there's a graph creation button.

VR

The action for graph creation can be assigned to any controller keybind at will within the keybind settings interface.

Graph User Interface

A graph can be seen in the following figure, such a graph may emerge in the software.

Graph Example

Num. in Graphic Function
1 Closes the Graph
2 Can be dragged to resize the graph
3 Selects which metric is shown on which axis. Can be clicked to open a list and select a different metric
4 A Marker. By clicking it the node and the markers connected to the clicked node will be highlighted. If one was to then hover above the node, it will be accentuated. Bei double-clicking it the camera will be moved to the connected node.
5 A red coloring of the marker means that the marker overlaps with one or more markers. The redder the coloring, the more markers are being covered
6 These numbers display the greatest and smallest numbers on these axis
7 An Info Text, which shows the name of the connected node and its metric values on both axis
8 Holding this button pressed allows moving the graph. A single click minimizes the graph
9 (De-/)Activates the graph's sidebar

Sidebar User Interface

Sidebar Picture

Num. in Graphic Function
1 With this button one may switch between the standard and tree views
2 This button activates or deactivates the node in the current graph. If the node is not a leafnode, then all of its childnodes will also be deactivated
3 The node's name

Sources

In the user interface of the graphs there are multiple graphics. These are taken from the following sources:

Clone this wiki locally