Starting the Control
To start the control click on the “Assets” button in the upper left corner of the PI Vision display. In the upper part select “weruSankey” by clicking on it.
Afterwards drag and drop any attribute on the Display. The Sankey Chart can now be used.
Configuration
With a right click on the control it is possible to press "Configure".
Thereby the configuration tile appears.
Check the checkbox Use AF.
Now you can configure what and where the Sankey Chart will scan in AF.
With the option AF Path you set the path to the AF Database that should be scanned for data.
With the option Medium you set the name of the attribute which is holding the data that should be visualized. This attribute needs to be in a certain Category, that can be configured with the option Category Name.
With the option Template Name you set what AF Object should be scanned.
Only AF Objects with one of the template names configured in this option will be looked at.
You can configure more than one template name. Just separate the template names with a “;” (see picture above)
If you changed any options, click on the blue button labeled “Load data” above the Sankey Chart to refresh it.
We highly recommend setting up the chart with an AF-Structure suitable for this. When you are not using AF, the Sankey Chart will show the standard Sankey, which is configured statically on the Server.
Change Standard Sankey
This can and should only be done by advanced users which are allowed to change files on the PI Vision server.
Ideally this was set up when installing the Werusys PI Vision Suite.
You need to edit the “weruPIVisionSuiteConfig.js” under “\PIVision\Scripts\app\editor\symbols\ext\libraries\”.
Then add or change like this:
var SankeyData = {
links: [
{target: "Energy Generation", value: 100.0},
{source: "Energy Generation", target: "Engine 1", value: 60.5},
{source: "Energy Generation", target: "Engine 2", value: 34.5},
{source: "Energy Generation", target: "Loss", value: "\\\\PI Vision Server\\cdt158"},
{source: "Engine 1", target: "Engine 1 heat", value: "AF Database\\Attribute"},
{source: "Engine 2", target: "Engine 2 heat", value: "8.42"}
]
};
This can only be changed by an admin!
Changing the Size of the Control
In case that the legend or some part of the control is not visible, it is necessary to adjust the size of the control. To do so, the first step is to change into edit mode (Icon in the upper right corner) and in a second step to click on the control. The eight appearing dots around the control can be used to adjust the size that everything is visible.
Removing the Control
Before removing the control it is necessary to switch into edit mode (Icon in the upper right corner). Thereafter it is possible to click on the control and press the delete key to remove the control.