Analysis

An Analysis is a visual display of data from the following data sources within Tulip

• App (single or many)
• Table (single)
• Machine (single or many)

App: Data is organized around App Completions from the past

Table: Data is current values in Table Rows

Machine: Data is past events from OPC tags that are stored in attributes

It is defined via:

1. A “Chart Template” that determines the type of display - bar chart, table etc.
2. A set of configuration fields and their current values. The available configuration fields depend on the Chart Template.

This doc will review all the possible configuration fields for each chart template and data source combination.

Additionaly, Chart Layers allowing to create Insights are detailed at the end of this page.

Properties For All Chart Templates

Formatting Options

The formatting options are configured in the formatting panel on the right side of the analytics editor. They are grouped into give sections and are available for all templates but Single Number, Table and Slideshow.

Legend

Applies to all charts.

X Axis

Applies only to charts with a X axis.

Y Axis

Applies only to charts with a Y axis.

Line

Applies only to line and multiline charts.

Data Labels

Applies only to the donut chart.

One Operation

This displays one variable or table field on the X axis and a numerical value on the Y axis.

Compare Variables

This displays multiple numerical or boolean variables or table fields on the X axis and a numerical value on the Y axis.

Multiple Operations

This displays multiple numerical or boolean variables or table fields on the Y axis across the same X axis. Available for

Results on X Axis

This shows individual app completions on the X axis and a numerical or boolean value on the Y Axis. Available only for App analyses.

Scatter Plot

This shows one numerical table field or variable on the x axis and a numerical value on the Y axis. Available only for App analyses.

Single Number

This shows a single value based on a variable, field or expression.

Slideshow

This shows images of a single image variable and additional variable values next to it. Available only for App analyses.

Table

This shows a tabular overview of the selected data.

Record Limit

All analyses are limited to a maximum of 1000 visualized records. If the analysis configuration would return more than 1000 records, last 1000 records are shown. "Last" is defined by a descending order of the X Axis values.

Example: If the X Axis is configured to be a datetime field, the most recent 1000 records will be shown.

Series Limit

All analyses are limited to a maximum of 50 visualized series. If the analysis configuration would return more than 50 series, the first 50 are shown. If this is the case, a warning icon is shown on the chart to surface it to the user.

Layers

Layers can be added to certain chart types in Tulip to generate Insights. Insights are pieces of information that are extracted from or created using the data visualized in the analysis.

Control Chart Layer

This layer can be added to Tulip Table analyses with the following configuration:

• Template: One Operation
• Display type: Line Chart
• X Axis: any
• Y Axis: Numeric value (Number, Integer, Interval)

The Layer can be turned on in the "Chart Layers" side panel which can be accessed using the "Chart Layers" button in the top right corner of the analytics editor. It offers two different limit settings with different configuration options.

Static Limits

Allows to manually define an upper and lower control limit and a center line to use single outlier and prominent shift rules.

Calculated Limits

Automatically identifies appropriate boundaries for single outlier detection based on the currently visible data and an acceptance range (6 sigma equivalent). Upon initially selecting this option, the limits are automatically calculated.

Rules

The following rules are available:

Alerting

When the control chart is active, alerting can be activated in the Alerts panel. This can be accessed using the "Alerts" button in the top right corner of the analytics editor.

When alerting is turned on, Tulip will automatically check for new insights in the background every hour and send an email the the users specified in the "Recipients" list in the Alerts panel.

The email contains:

• The name of the analysis
• The timestamp of evaluation
• The type and count of new insights
• A link to the analysis

Forecast Layer

The Forecast layer in Tulip’s Analytics Builder provides out-of-the-box forecasting for time-series data. The layer uses machine learning to evaluate the existing data in you analysis to predict and visualize a likely future development of that data as a 95% confidence interval.

This layer can be added to Tulip Table analyses with the following configuration:

• Data Source: Tulip Table
• Template: One Operation
• View: Line Chart
• x-Axis: Time-series, grouped by day
• y-Axis: Numeric value (Number, Integer, Interval)

Once a chart configuration is fulfilling these requirements, the Forecast Layer will be available in the Chart Layers panel. This can be opened by clicking on the Chart Layers button in the top right corner of the analytics editor.

The following configuration options are available:

Trendline Layer

The trendline layer adds a linear trend line to charts in Tulip Analyitcs. It can be added to Tulip Table analyses with the following configuration:

• Data Source: Tulip Table
• Template: One Operation
• View: Line Chart, Bar Chart, Dot Plot
• x-Axis: Any
• y-Axis: Numeric value (Number, Integer, Interval)

Once a chart configuration is fulfilling these requirements, the Trendline Layer will be available in the Chart Layers panel. This can be opened by clicking on the Chart Layers button in the top right corner of the analytics editor.

There are no additional settings avaialbe for the trend line layer.

Tests

Requirements