Heat Map Chart Node

Visualizes data through variations in coloring. The colors represent values, making it easy to understand complex data patterns at a glance. Often used for showing density, temperature, or activity levels.

HeatMap
HeatMap2

What is a Heat Map Chart?

A heatmap chart is a visual representation of data where values are depicted using colors in a matrix format. Each cell within the matrix corresponds to a specific data point, and the color of the cell indicates the value of that data point, typically with a gradient scale ranging from lighter to darker colors. Heatmaps are particularly effective in revealing patterns, trends, and correlations within large datasets, as they allow viewers to quickly identify areas of high or low values. They are commonly used across various fields including finance, marketing, biology, and data analysis, enabling analysts to gain insights into complex datasets and make data-driven decisions. With their intuitive visual representation, heatmap charts facilitate efficient data exploration and communication of key findings to stakeholders.

Inputs

The heat map chart node has one mandatory input. This is:

Input

Requirement

Comments

Input Data Field

Mandatory

This is the field name within the incoming JSON payload that contains the data to be displayed on the widget.

Note: The payload must include a timestamp that corresponds to the x- and y-axis dimensions, and an input data field, which is the data to be represented in each cell.

How to Use

Implementation

In the Rayven Workflow Builder:

Select Visualizations.
Drag the Heat Map Chart node to the canvas.
Provide an input to the Heat Map Chart node by connecting it to another node.
Double click on the Heat Map Chart node to open the configuration window.

Configuration

Section: General
This section contains basic configuration elements required for any heat map chart implementation
Field	Requirement	Description
Widget Name	Mandatory	Enter a name for this node. This provides a handle to which you and others can refer, so it should be simple but meaningful and explain the node’s purpose.
Widget Subtitle	Optional	Additional text that can be used to explain the data presented by the node. This will appear directly under the Widget Name, in a smaller text size.
Widget Header	Mandatory	Ability to hide or show the widget’s header.
Device/Device Label Name	Mandatory	Select this checkbox to display the device or label name on the widget.
Heatmap Type	Mandatory	Select from the dropdown menu: Timestamp Category
Input Data Field	Mandatory	This is the field name within the incoming JSON payload that contains the data to be displayed on the widget.
Function	Mandatory	Select one of the following from the dropdown menu: Last value received Sum Average Min Max
Widget Refresh Interval (sec)	Optional	Configure how often the chart widget will refresh. The default is every 60 seconds.
Decimal Precision	Optional	Enter the number of decimal places to display for each field.

Section: Tooltip Info
Field	Requirement	Description
Show Tooltip	Optional	When checked, it allows users to display their tooltip text on the widget.
Tooltip Text	Optional	This section only exists when “Show Tooltip” is checked. Users are able to write any tooltip message they desire which will be displayed on the widget.

Section: Color Picker
Field	Requirement	Description
Min Value	Mandatory	The minimum value for the heat map color range.
Mid Value	Mandatory	The midpoint value for the heat map color range.
Max Value	Mandatory	The maximum value for the heat map color range.
Null Cells	Optional	Future values are treated as nulls. If no value is entered, the chart will display white cells. You may, however, wish to enter a hex color for these cells.
Hex Color	Mandatory	Select a desired color you wish to see when the value received falls under the value set.

Section: Group by Device Label
Field	Requirement	Description
Device label name	Mandatory	There are no labels available in this box until you have saved at least one in the Device Labels section of the Workspace. Select a Label to use to filter devices.
Grouped	Mandatory	Select a method for grouping the widget on the dashboard from the dropdown: No Grouping (widget per device): one widget will appear for each device Group by device label value (Widget per label value): One widget will appear for each value of a label. For example, if the Label is ‘Colour’ and there are the values ‘Green’ and ‘Gold’, then two widgets will be displayed, one with devices with Colour Label equal to “Green” and one with devices with Colour Label equal to “Gold” Group by device label name (One widget): Only one widget will be displayed and this will contain data from all devices.