Page tree

This page has not yet been translated to English.

Skip to end of banner
Go to start of banner
Skip to end of metadata
Go to start of metadata



Valid for

GridVis editionsSoftware platform

 


 

Sankey diagram

Within the framework of the energy flow analyses, relevant energy consumption values are required. In order to analyse these, they are arranged in informative energy flow diagrams (Sankey diagrams). With a Sankey diagram, you obtain a transparent and clear graphic illustration of your energy consumption and other measured values.

With the Sankey function, comprising the 3 areas of Sankey Manager, Sankey Configurator and Sankey Widget, you generate your own Sankey diagrams tailored to your company - easily, intuitively and without any programming knowledge - which can be integrated in every dashboard as a widget, for the purpose of energy flow analysis and evaluation.

Example of a Sankey diagram:

 

General description:

The Sankey diagram

  • Visualises energy flows (quantity flows) in graphical form as diagrams.
  • Connecting areas show consumption data or other measured values, proportional to the size of the measured value.
  • Is simple and intuitive to create with the Sankey Configurator, and manage with the Sankey Manager.
  • Can be integrated as a widget into every dashboard and evaluated.

The Sankey function consists of 3 areas:

1.

Sankey Manager

Management tool for Sankey diagrams.

2.

Sankey Configurator

Creation of individual Sankey diagrams.

3.

Sankey Widget

Can be placed on the dashboard.



The Sankey Manager

The Sankey Manager is the management tool for Sankey diagrams.

The Sankey Manager

  • Manages all Sankey diagrams.
  • Offers a structured and informative overview of all existing Sankey diagrams.

 

How do I open the Sankey Manager?

  1. Click in the navigation bar on the "Navigation " button.
  2. You will find the "Sankey Manager" in the drop-down menu under "Configurators ".

 

"Sankey Manager" area (overview window):

Item

Icon

Short text

Description

1

Create

Create new Sankey diagram.

2

Delete

Delete Sankey diagram.

3

Copy

Copy Sankey diagram.

4

Open

Open Sankey Configurator.

5

Search and filter

Search and filter Sankey diagrams.

6 

Mode

Sankey diagram mode. The Sankey diagram shows "live values" or "historical values".

7 

Type

Type of measured value (e.g. effective power).

8 

Description

Information text that has been stored with a Sankey diagram.

9 

Name

Name of the Sankey diagram. Clicking on the name opens a preview.

10 

Group

Sankey diagram group. Can be configured in the Sankey Configurator.

   


The Sankey Configurator

Using the Sankey Configurator, you create your own Sankey diagrams without programming knowledge. In order to create a Sankey diagram, you create nodes and connections in the Sankey Configurator and link these with each other, according to requirement (see also description of "Nodes and links").

The Sankey Configurator

  • Consists of 4 areas (settings, nodes, links and preview).
  • Facilitates the creation of individual Sankey diagrams without programming knowledge, through the creation and connection of nodes and links.
  • Facilitates e.g. the creation of energy flow analyses for your company without extensive time and effort. You can also select and visualise measured values such as current, effective power or harmonics. Measurement devices - e.g. from Janitza - are a prerequisite for energy flow analyses. These must be used at the desired measurement points and linked with the Sankey Configurator.
  • Opens for every Sankey diagram by clicking on the button "" in the "Actions" area of the Sankey Manager (see "The Sankey Manager" screen under item 4).

 

Settings




ItemIconShort textDescription
1

Name of the Sankey diagram.

 
2

Save

  • Saves input settings.
  • Automatically takes you to the next area (tab).
3 

Name

  • Name of the Sankey diagram.
  • The Sankey diagram appears in the Sankey Manager and on the dashboard as a widget under its name.
4 

Description

  • Information on the Sankey diagram.
  • Entry appears in the Sankey Manager.
5 

Group

  • Entry of individual group names, to which the Sankey diagram is assigned (see Sankey Manager, item 10).
  • Select existing group names from a selection field that opens.
  • Groups aid a clear structure within the Sankey Manager.
  • New groups can be input and created.
6 

Type

A precondition for the creation of a Sankey diagram is the selection of the measured value type.
Selection of the measured value type influences the “Links” area (refer to "Nodes and links").
The following measured value types are available for selection:

  • Effective power.
  • Apparent power.
  • Current.
  • Active energy.
  • User-defined (choice of all measured value types).
7 

 Colour mode

Selection of the colour mode for the links:

  • Uni-colour (colour selectable)
  • Transition (colour gradients).
If the “Transition” radio button is activated then colours from the node colours are used for the links
(Can be set in the “Nodes” area of the Sankey Configurator).
8 

Time mode

Choose between live or historical values:

  • “Live” mode shows current values.
  • “Historical” mode shows recorded values.
9 

Time period

The Sankey Configurator requires entry of the period in both modes (live and historical values).
Entry of the time period has different effects in each of the two modes:

  • In “Live” mode - selection of the update rate
  • In "Historical" mode
    - consumption values (e.g. active energy) are determined and presented over a period of time.
    - for measured values (e.g. current, power), an arithmetic mean value of all measured values is formulated and presented.
10 

Measured value

With activated slide control:

  • Appears if the mouse pointer is held over a link in the Sankey diagram for the measured value (see point 6 “Type”) as a “tool tip”.
  • If the visualisation setting (point 18) is set to “Measured value” then the measured value appears directly in the link in the Sankey diagram.
  • It is possible to configure the “Measured value” colour via a dialogue field.
11 

Relative value

With activated slide control:

  • Appears if the mouse pointer is held over a link in the Sankey diagram for the measured value as a “relative value” in % (“tool tip”).
  • If the visualisation setting (point 18) is set to “Relative value” then the relative size appears directly in the link in the Sankey diagram.
  • It is possible to configure the “Relative value” colour via a dialogue field.
12 

Mode

Activated radio button - “Reference total”:

  • The relative size of the measured value pertains to all measured values.

Activated radio button - “Reference node”:

  • The size of the measured value pertains to the individual node
13 

Associated value

The associated value shows the measured value, multiplied by a factor and assigned a unit. In this way it is possible to visualise e.g. the “costs” (or similar) in your Sankey diagram links at a glance.

With activated slide control:

  • Appears if the mouse pointer is held over a link in the Sankey diagram for the measured value, assigned a factor and unit, as an “Associated value” (“tool tip”).
  • If the visualisation setting (point 18) is set to “Associated value” then the associated value appears directly in the link in the Sankey diagram.
  • It is possible to configure the “Associated value” colour via a dialogue field.
14 

Factor

“Factor” input field:

  • The factor is an operand, which is multiplied with your measured value and assigned the corresponding unit (point 15), which gives the associated value.
15 

Unit

“Unit” input field:

  • Unit of the associated value.
16 

Loss management

With activated slide control:

  • The system calculates the loss between the input and output of a node.
  • By entering a tolerance, deviations are visualised as losses in the Sankey diagram. Nodes that indicate losses pulsate.
  • It is possible to configure the “Losses” colour via a dialogue field.
17 

Tolerance

“Tolerance” input field:

  • Value in %, at which the loss management should trigger (nodes pulsate).
18 

Show measurement

The “Show measurement” selection list has 4 settings:

  • Off
  • Measured value
  • Relative value
  • Associated value
The selected setting appears directly in the Sankey diagram link (see example “tool tip display” in the following).
19

“Back” button

Clicking on the button takes you back to the Sankey Manager

20

“Help” button

  • Direct help (bottom left in the window).
  • Button leads to this help screen. After closing the help screen, you return to the previous screen.

 

 Example of “tool tip display”:

In this example, the following slide controls are activated:

  • Measured value (in kW)
  • Relative value (in %)
  • Associated value (in €)

The setting in the “Show measurement” selection list is “Measured value”.

Note

In the GridVis desktop installation, it is possible to configure virtual devices (VD). With virtual devices, it is possible to add up different measured values. The results can be selected as an independent device. This application is very helpful in order to replace a missing measured value.



Nodes and links - explanation

  • A link is an area between two nodes
  • link presents a measured value as an area.
  • A node is not a measured value
  • Nodes are groupings or a combination of links (measured values).
  • Nodes can exhibit multiple links or just a single link.
  • Nodes have input and output links.
  • Start nodes only ever have output links.
  • Target nodes only ever have input links.

 

Area

Function

Description

Nodes

  • Intermediate nodes
  • Start / target nodes
  • Nodes mapped in the Sankey Configurator can be defined as start, intermediate or target nodes.
  • Nodes have their own colours and names.

Links

  • Area(s) between nodes
  • Measured value
  • The area of a link shows the size relationship (of the measured value) in relation to the entire level.
  • A link is used to connect two nodes with each other.

Note:

If measured values required for the creation of a Sankey diagram are missing (e.g. measured values lie in the future or recordings are missing),
the system plots the measured values (links) for the Sankey diagram with dotted red lines:


Note

In order to generate complex Sankey diagrams it is important and helpful to link individual nodes, and to display and check the results using the “preview” function! 

Nodes

A node

  • is not a measured value!
  • constitutes a combination of measured values.
  • is required for establishing the link.

The system marks unused nodes. In the “Links” window (sub-navigation > "Links" tab), you link unused nodes and the system removes the marking.

Note

Structure the nodes created in a clear manner! Use created nodes in links ideally when these are first created.

ItemIconShort textDescription
1

Insert node

Insert new node
2

Save configuration

Save configuration settings of the node.

3 

Node name

  • Appears as a selection (start and target nodes) in the “Links” window (sub-navigation > "Links" tab).
  • Appears in the Sankey diagram as the node designation.

Note:
Node names cannot be switched off!

4 

Node colour selection

Note:
If the “Transition” radio button is activated in the “Links” window then the “Nodes” colour selection has effects on the visualisation of the Sankey diagram (see item 7 in the Sankey Configurator).

5

 

Start node

Defined node type. The selected node type is displayed in “blue”!

Note:
The definition of the node type has effects on the start and target nodes in the “Links” window:

  • Defined start or target nodes are stipulated as start or target nodes.
  • Defined intermediate nodes can be selected as start or target nodes.

Node (intermediate node)

 

Target node
6Copy nodeClicking on the button copies the selected node.
7

Position of the node

Shift created nodes up or down in the configuration window.

Note:
This function

  • aids the overview in the configuration window.
  • sorts and structures your nodes.
  • has no effect on the Sankey diagram plotted.

8Delete node

Note:
Deleted nodes can not be restored!

Links

  • The area of a link shows the size relationship (of the measured value) in relation to the entire level.
  • A link is used to connect two nodes with each other.

ItemIconShort textDescription
1Insert link

Insert new link.

2

Save link

Save configuration settings of the link.

3Copy link

Clicking on the button copies the selected link.

4Position of the link

Shift created links up or down in the configuration window.

Note:

This function

  • Aids the overview in the configuration window.
  • Sorts and structures your links.
  • Has no effect on the Sankey diagram plotted.
5Delete link

Note:

Deleted links cannot be restored!

6 Name of the link

Appears in the Sankey diagram as a tool tip, if the mouse is moved over the link.

7 Start node

Shows the node types start and intermediate node.

Note: 

  • The definition of the node type takes place in the “Nodes” window (sub-navigation > "Nodes" tab).
8 Measuring devices selection Note:
  • If measuring devices are missing, it is also possible to apply virtual measuring devices (VD). You create VDs in the desktop version of the GridVis software.

Note:

  • The user can select measurement devices and measured values from the master project.
9 Measured value selection

Note:

  • The (measured value) type selected in the “Settings” window (see item 6 “The Sankey Configurator”) influences the selection. You only have the full selection of all measured values with the (measured value) type “User defined”.
10 Target node

Shows the node types target and intermediate node.

Note: 

  • The definition of the node type takes place in the “Nodes” window (sub-navigation > "Nodes" tab)..

The preview function

Clicking on the “Preview” button in the sub-navigation provides you with a preview of your Sankey diagram.
Newly created links are directly shown in the “Preview” function for the Sankey diagram.

 

ItemIconShort textDescription
1

Back

Go back to the Sankey Manager

2 

Preview

Preview of the Sankey diagram.

Note:

If measured values required for the creation of a Sankey diagram are missing (e.g. measured values lie in the future or recordings are missing),
the system plots the measured values (links) for the Sankey diagram with dotted red lines:

Note

 Plot Sankey diagrams that show positive and negative measured values

  • negative measured values with a dotted line and
  • positive measured values in areas.

If your Sankey diagram contains only positive or only negative measured values then the system plots all links in full. A “minus sign” indicates the negative measured values.


Example 1: Positive and negative measured values in a Sankey diagram.

Example 2: Sankey diagram with exclusively negative measured values.



The Sankey Widget

Once created, Sankey diagrams can be placed on existing or new dashboards as widgets.
In the “Dashboards” window, your Sankey diagram can be

  • selected via its name.
  • freely positioned on the dashboard and scaled.

 

ItemIconShort textDescription
1 

Select visualisation

Visualisation selection list: Select "Sankey diagram" widget!

2 

Choose a Sankey

Selection list with all Sankey diagrams

3 

Header

Slide control for showing or hiding the header.


Loss management

The system calculates the loss between the input and output of a node. Inputting a tolerance (relative in %) influences the loss. Deviations from the measured values, which exceed the entered tolerance, are plotted on the Sankey diagram as losses (the affected nodes pulsate):

  • You configure the colour of “Losses” via a dialogue field in the “Settings” window (see point 16, table “The Sankey Configurator”)
  • The system plots losses as areas, which flow into a loss node.
  • A loss target node is a combination of all losses that have arisen. 
  • With a pulsating node, the colour gradient shows the direction of the loss.
The loss arises from
(loss direction):
Colour gradient of the pulsating nodeComment

Input to output

White to full-tone colour

(see example 1 “Loss at the node output” in the following).

Output to input

Full-tone colour to white

The system does not plot losses on the input side as areas
(see example 2 “Loss at the node input” in the following).


Note

  • Losses that arise on the input side are usually connection or configuration errors.
    As such, the “Loss management” also serves as a plausibility check for your configuration.

 Example 1 “Loss at the node output”

 

Example 2 “Loss at the node input”


 

  • No labels