Screenshot

Overview

The 3D Charts Module from Perfect Abstractions adds 8 new components to Ignition for 3D data visualization.

When the 3D Charts Module is installed the 3D chart components are added to the existing component palette in the Ignition designer. Just like built-in components, the 3D chart components are dragged and dropped onto windows or templates and configured.

Chart Data

Each 3D chart has a property called Chart Data. This is a dataset that contains the values that are drawn on a chart.

Chart Mouse Interaction

Charts support the following mouse interactions:

Chart Types

There are three types of 3D charts:

XYZ Charts

Surface Chart

Type: XYZ Chart

Description: The Surface chart creates a surface from the coordinates in the Chart Data dataset. The surface is a triangulation which is a surface created from triangles. Each corner of a triangle is one of the XYZ coordinates from the Chart Data dataset. Each triangle is divided into three parts and each part contains one corner of the triangle. Each part is colored based on the z value of the triangle corner it contains.

Notes: The Surface Chart uses the 'x', 'y', 'z' columns of the Chart Data dataset.

Screenshot

Surface Chart Data

Each row of a Chart Data dataset is treated as a single data point, consisting of X, Y and Z values. The chart looks for number columns named "x", "y" and "z" in the Chart Data dataset to define the coordinates of each point. Here is an example of such a Chart Data dataset:

x

y

z

-1.23 0.45 0.96
-0.36 0.73 0.24
-1.28 0.58 0.63
-0.83 0.96 0.31
-1.17 0.42 0.12

Scatter Chart

Type: XYZ Chart

Description: The Scatter Chart displays data points in a three dimensional space. The data points are stored in the Chart Data dataset.

Notes: The Scatter Chart contains a category of properties called "Range" that are used to define the values that determine each axis selection range and color properties (The axis selection ranges are the colored background bands you see in the chart below). These are unique to the Scatter Chart. In the chart below you can see the green Y selection range and the purple Z selection range and the red X selection range.

Screenshot

Scatter Chart Data

Each row of a Chart Data dataset is treated as a single data point, consisting of X, Y and Z values and a name called a "series". The chart looks for number columns named "x", "y" and "z" in the Chart Data dataset to define the coordinates of each point and a string column named "series" to determine the series each point belong to. Here is an example of such a Chart Data dataset:

series

x

y

z

Series A -1.23 0.45 0.96
Series B -0.36 0.73 0.24
Series A -1.28 0.58 0.63
Series A -0.83 0.96 0.31
Series B -1.17 0.42 0.12

XYZ Chart Data Selection

Users can select data points on XYZ Charts by clicking on them. When points on a chart are selected the X, Y, Z values are displayed on the chart. Multiple data points can be selected by holding down the shift key and clicking on multiple data points. Multiple data points can also be selected by holding down the shift key and click and dragging the mouse to select data points within a rectangular area.

XYZ Charts have a Selected Data property that is a dataset that contains the X, Y, Z values of points on a chart that have been selected.

Category Charts

Bar Chart

Type: Category Chart

Description: The Bar Chart is a three dimensional bar chart, that displays multiple rows of data across any number of numeric categories.

Screenshot

Bar Chart Data

A Bar Chart looks for a column named "name" in the Chart Data dataset to define the name for a row. Data categories are defined by other column names and can be whatever you choose. Here is an example of such a Chart Data dataset:

name

Labor

Admin

Maintenance

Misc.

Warehouse A 12523.56 4762.54 3897.21 324.32
Warehouse B 15947.34 2364.73 5675.24 265.87
Site A 24896.28 8365.58 10543.63 2453.43
Site B 28675.83 7463.96 7352.31 1253.43
Main Office 13987.17 4983.42 5242.12 234.54

Stacked Bar Chart

Type: Category Chart

Description: The Stacked Bar Chart is a bar chart that can display multiple rows of data in the same row that is displayed in the chart.

Notes: In addition to the 'name' column in the Chart Data dataset, the Stacked Bar Chart looks for a column named "row" to determine which row in the chart to place the data.

Screenshot

Stacked Bar Chart Data

The dataset example below displays 6 dataset rows in 3 chart rows.

The "name" column specifies a name for a row in the Chart Data dataset. The "row" column specifies which row in the chart to display a dataset row. Data categories are defined by other column names and can be whatever you choose.

name

Labor

Admin

Maintenance

Misc.

row

Site A 24896.28 8365.58 10543.63 2453.43 Sites
Site B 28675.83 7463.96 7352.31 1253.43 Sites
Site C 28675.83 7463.96 7352.31 1253.43 Sites
Warehouse A 12523.56 4762.54 3897.21 324.32 Warehouses
Warehouse B 15947.34 2364.73 5675.24 265.87 Warehouses
Main Office 13987.17 4983.42 5242.12 234.54 Offices

Waterfall Chart

Type: Category Chart

Description: The Waterfall Chart displays a series of positive and negative values as a visualization of a running total for each row, ending with a totalized column.

Notes: The total column is calculated automatically and it is not recommended to include it manually in the Chart Data dataset.

Screenshot

Waterfall Chart Data

The "name" column specifies the name of a row in the Chart Data dataset. The data categories are specified by the other column names and can be whatever you choose. The chart automatically creates a column in the chart called "Total" which contains a calculation of each row's running total. Here is an example of a Chart Data dataset for a Waterfall Chart:

name

Funding

Development

Advertising

Sales

Project A 4.41 -0.41 -2.03 2.38
Project B 3.79 -0.61 -0.68 3.03
Project C 1.73 -0.87 -2.99 2.68
Main Project 0.79 -0.16 -1.72 2.03

Line Chart

Type: Category Chart

Description: The Line Chart is a line chart displayed in 3D.

Screenshot

Line Chart Data

The chart looks for a column named "name" in the Chart Data dataset to define the name for a row. Data categories are defined by other column names and can be whatever you choose. Here is an example of such a Chart Data dataset:

name

Q1/2018

Q2/2018

Q3/2018

Q4/2018

Site A 140 367 654 483
Site B 138 372 303 600
Site C 633 610 268 695
Warehouse A 245 362 706 905
Warehouse B 743 535 55 70

Area Chart

Type: Category Chart

Description: The Area Chart is a type of line chart that is filled in from the bottom in each row.

Notes: The data format for the Chart Data property dataset is the same as for the Bar Chart. Displaying data points by clicking on the chart does not currently work for the Area Chart.

Screenshot

Area Chart Data

The chart looks for a column named "name" in the Chart Data dataset to define the name for a row. Data categories are defined by other column names and can be whatever you choose. Here is an example of such a Chart Data dataset:

name

Q1/2018

Q2/2018

Q3/2018

Q4/2018

Site A 140 367 654 483
Site B 138 372 303 600
Site C 633 610 268 695
Warehouse A 245 362 706 905
Warehouse B 743 535 55 70

Category Chart Data Selection

Users can display numeric values on Category Charts by clicking on bars or lines on a chart. Clicking on a bar or line will display the values for the row and column of the bar/line that was clicked on. This works for all category charts except the Area Chart. You can see the row and column that was selected in the Waterfall Chart above - the first row and the right-most column are selected.

Pie Chart

Type: Pie Chart

Screenshot

Pie Chart Data

Pie Charts look for two columns to define the dataset, a 'key' and 'value' column. If there are duplicate keys the last one in the dataset will be used. The value should be entered as a raw value, and a percentage value will be automatically calculated.

key value
Site A 18
Site B 7
Site C 24
Main Office 28
Warehouse 33

Library

The 3D Charts Module uses the Orson Charts library.

Next

Links

Questions

Have a question not answered by the documentation? Send an email to support@perfectabstractions.com.

Want to purchase a license? Send an email to sales@perfectabstractions.com.