Cartesian Chart Node

A chart that utilizes Cartesian coordinates to display values for typically two variables for a set of data. Useful for showing relationships between two or more variables.

What is a Cartesian Chart?

A Cartesian chart is a fundamental type of graph used to plot data points on a two-dimensional plane defined by an x-axis and a y-axis. Each data point's position is determined by two input values: one for the horizontal (x) axis and one for the vertical (y) axis. This chart is especially useful for creating scatter plots, where multiple data points can be displayed to identify patterns, correlations, or distributions within the dataset. By plotting these points, users can visually assess relationships between the variables, such as trends, clusters, or outliers. Cartesian charts are widely used in various fields, including science, economics, and engineering, to analyze and interpret data effectively.

Inputs

The cartesian chart node has two mandatory inputs. These are:

Input	Requirement	Comments
X-axis field name	Mandatory	Determines the value of each data point on the x-axis
Y-axis field name	Mandatory	Determines the value of each data point on the y-axis

How to Use

Implementation

In the Rayven Workflow Builder:

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

Configuration

Section: General
This section contains basic configuration elements required for any cartesian chart implementation
Field	Requirement	Comments
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.
Device/Device Label Name	Optional	Select this checkbox to display the device or label name on the widget
Decimal Precision	Optional	Enter the number of decimal places to display for each column
Auto-scale by min/max values	Optional	Select this checkbox to enable the chart to automatically adjust the minimum and maximum ranges for both axes
Widget Refresh Interval (seconds)	Optional	Configure how often the chart widget will refresh. The default is every 60 seconds.
Dashboard to Link To	Optional	Ability to link any type of dashboard to the cartesian chart.
Upload Background Image	Optional	Ability to upload any type of image (File: png, jpg, etc..) to the cartesian chart which will act as the background.

Section: X-Axis Info
This section contains configuration elements for the cartesian chart’s x-axis
Field	Requirement	Comments
Name of X-axis	Mandatory	Enter a name for the x-axis label.
X axis minimum value	Mandatory	Enter the minimum value on the x-axis.
X-axis center value	Optional	Enter the center value on the x-axis. A vertical line will be displayed that crosses this point.
X-axis maximum value	Mandatory	Enter the maximum value on the x-axis.
X-axis field name	Mandatory	Enter the field name of the incoming JSON payload that will be displayed on the x-axis.
X-axis Function	Mandatory	Select from a dropdown menu. This is the calculation performed by the node that will determine the value displayed by each data point. Last value received Average Minimum Maximum Sum
Calculation Interval	Mandatory only if Average, Minimum, Maximum and Sum is selected	Provide an integer to determine the period of input data.
Units of Measurement	Mandatory only if Average, Minimum, Maximum and Sum is selected	Select from a dropdown menu Seconds Minutes Hours Days Weeks (Start on Monday) Weeks (Start on Sunday) Months Years

Section: Y-Axis Info
This section contains configuration elements for the cartesian chart’s y-axis
Field	Requirement	Comments
Name of Y-axis	Mandatory	Enter a name for the y-axis label.
Y-axis minimum value	Mandatory	Enter the minimum value on the y-axis.
Y-axis center value	Optional	Enter the center value on the y-axis. A horizontal line will be displayed that crosses this point.
Y-axis maximum value	Mandatory	Enter the maximum value on the y-axis.
Y-axis field name	Mandatory	Enter the field name of the incoming JSON payload that will be displayed on the y-axis.
Y-axis Function	Mandatory	Select from a dropdown menu. This is the calculation performed by the node that will determine the value displayed by each data point. Last value received Average Minimum Maximum Sum
Calculation Interval	Mandatory only if Average, Minimum, Maximum and Sum is selected	Provide an integer to determine the period of input data.
Units of Measurement	Mandatory only if Average, Minimum, Maximum and Sum is selected	Select from a dropdown menu Seconds Minutes Hours Days Weeks (Start on Monday) Weeks (Start on Sunday) Months Years

Section: Color Picker
This section contains configuration elements for editing the colours of each data point
Field	Requirement	Comments
If Input	Optional	To add a new rule, click the Add color button. Enter a field name and create a rule to determine the color of data points on the cartesian chart. Enter a hex code to add a color. To add a new rule, click the Add color button.
Input Data Field	Mandatory	Enter a field name that matches the x-axis or y-axis data field.
Operator	Mandatory	Select an operator from the dropdown menu: = < >
Value	Mandatory	Enter a numeric value for this field.
Color	Mandatory	Select a color for each field using a hex or RGB code. If no selection is made, a range of default colors will automatically be used.

Section: Quadrants Info
This section contains configuration elements for selecting the background color for each quadrant. The size of the quadrants is determined by the center values of the x-axis and y-axis.
Field	Requirement	Comments
Top left	Optional	Select a color for the top left quadrant.
Top right	Optional	Select a color for the top right quadrant.
Bottom left	Optional	Select a color for the bottom left quadrant.
Bottom right	Optional	Select a color for the bottom right quadrant.

Section: Tooltip Info
Field	Requirement	Comments
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: Group by Device Label
Field	Requirement	Comments
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 ‘Color’ and there are the values ‘Green’ and ‘Gold’, then two widgets will be displayed, one with devices with Color Label equal to “Green” and one with devices with Color 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.