Multi-Axes Chart Node

Incorporates multiple axes, allowing for the visualization of more than one variable or dataset on the same chart, often with different scales. Useful for comparing different units or scales of data.

What is a Multi-Axes Chart?

A multi-axes chart, also known as a multi-axis chart, is a graphical representation that incorporates multiple Y-axes to visualize and compare different datasets with distinct units or scales within the same chart. This type of chart is particularly useful when plotting data with disparate ranges or units of measurement, allowing for better visualization of relationships and trends between variables that would otherwise be difficult to compare on a single scale. By providing separate axes for each dataset, a multi-axes chart enables users to effectively analyze and interpret complex data sets, identifying correlations and patterns that may not be apparent when using a single-axis chart. Whether it's comparing sales revenue and website traffic, or temperature and humidity levels, a multi-axes chart offers a versatile and intuitive way to display and analyze multidimensional data, making it a valuable tool for data visualization and analysis across various fields and industries.

Inputs

The multi-axes chart node has both mandatory and optional inputs. These are:

Input

Requirement

Comments

Input Field Name

Mandatory

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

File Name

Optional

This is mandatory if a field type is selected as File.

Note: Users will need to set up the FTP directory in order to use this functionality.

How to Use

Implementation

In the Rayven Workflow Builder:

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

Configuration

Section: General
This section contains basic configuration elements required for any multi-axes 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.
Multi Axes Type	Mandatory	Select one of the following from the dropdown menu Regular (Default) - displays the data field set up Devices - displays devices on the legend on the multi-axes chart Label Values - displays label values on the legend on the multi-axes chart
Stacked	Optional	If selected, the multi-axes chart will display in a stacked view.
Name of Y-axis	Mandatory	Enter the name of the y-axis label
Units of Measurement	Mandatory	Select the units of measurement from the dropdown menu to be used for the interval calculations: Seconds Minutes Hours Days Weeks (Start from Monday) Weeks (Start from Sunday) Months Years For example, if the following is configured: X-axis time interval = 1 Units of measurement = Hour Function = average Then the chart will calculate the average value for each column for the hour.
X-axis time Interval	Mandatory	Enter an integer to represent the interval on the x-axis
Data Point Increments	Mandatory	Select one of the following options: Running - based on the timestamp when the data is received by the node Fixed - round the timestamp when the data is received by the node If the chart’s unit of measurement is set to 5 minutes, the timestamp on x-axis for the running option will show 00:03, and followed by 00:08 while the fixed points option will show 00:05, and followed by 00:10.
Enable Display of Future Data	Optional	Allow data with a future timestamp to be displayed on the chart. Useful if forecasting logic is being implemented.
Consolidate and Auto-scale Axes	Optional	If selected, all y-axis ranges will be consolidated to a single range. The minimum and maximum value will automatically adjust based on the payload values.
Widget Refresh Interval (seconds)	Optional	Configure how often the chart widget will refresh. The default is every 60 seconds.
Interval Options Button	Mandatory	Allows users to show or hide the functionality to modify the intervals on the Rayven Dashboard.

Section: Regular Multi Axes Chart (Default)
This section contains configuration elements for a default multi-axes chart, i.e. using a combination of bars, lines and dot plots for each metric
Field	Requirement	Comments
Y-axis Field Name	Mandatory	Enter the field name of the incoming JSON payload
Y-axis Legend Name	Mandatory	Enter the name that will appear on the chart’s legend
Y-axis Group Name	Optional	Use a single label for y-axis metrics with a common unit of measurement. For example, you may have two fields called Minimum Temperature and Maximum Temperature. Since both have a common unit of measurement, you can enter Temperature as the Group Name for both metrics. This consolidates multiple y-axes labels into a single label.
Display As	Mandatory	Select one of the following from the dropdown menu Bar Line Area Dot Plot
Function	Mandatory	Select one of the following from the dropdown menu Last value received Sum Average Min Max Last value from each device with common label File (only available when dot plot is selected)
Dashboard to Link to	Optional	Ability to link any type of dashboard to the multi-axes chart.
Node to Link to	Optional	Ability to link a node to the multi-axes chart. Use case: parent-child charts.
Straight Line Function	Optional	Select one of the following from the dropdown menu Sum Average Min Max
Range Min	Optional	Enter the minimum value on the y-axis for each field. If you have entered a Y-axis Group Name for multiple fields, each of these must have the same minimum value. Note: If there are different minimum values provided, the multi-axes chart will display the lowest minimum value set for the grouped y-axis.
Range Max	Optional	Enter the maximum value on the y-axis for each field. If you have entered a Y-axis Group Name for multiple fields, each of these must have the same maximum value. Note: If there are different maximum values provided, the multi-axes chart will display the highest maximum value set for the grouped y-axis.
Decimal Precision	Optional	Enter the number of decimal places to display for each field.
Hex Color	Optional	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: Devices and Label Values - Multi Axes Chart
This section contains configuration elements for a devices/label values multi axes chart.
Field	Requirement	Comments
Display As	Mandatory	Select one of the following from the dropdown menu Bar Line Area Dot Plot
Y-axis Field	Mandatory	Enter the field name of the incoming JSON payload
Function	Mandatory	Select one of the following from the dropdown menu Last value received Sum Average Min Max
Stacked	Optional	If selected, the multi-axes chart will display in a stacked view.
Name of Y axis	Mandatory	Enter the name of the y-axis label
Units of Measurement	Mandatory	Select the units of measurement from the dropdown menu to be used for the interval calculations: Seconds Minutes Hours Days Weeks (Start from Monday) Weeks (Start from Sunday) Months Years For example, if the following is configured: X-axis time interval = 1 Units of measurement = Hour Function = average Then the chart will calculate the average value for each column for the hour.
X axis Time Interval	Mandatory	Enter an integer to represent the interval on the x-axis
Range Min	Optional	Enter the minimum value on the y-axis for each field. If you have entered a Y-axis Group Name for multiple fields, each of these must have the same minimum value. Note: If there are different minimum values provided, the multi-axes chart will display the lowest minimum value set for the grouped y-axis.
Range Max	Optional	Enter the maximum value on the y-axis for each field. If you have entered a Y-axis Group Name for multiple fields, each of these must have the same maximum value. Note: If there are different maximum values provided, the multi-axes chart will display the highest maximum value set for the grouped y-axis.
Data Point Increments	Mandatory	Select one of the following options: Running - based on the timestamp when the data is received by the node Fixed - round the timestamp when the data is received by the node If the chart’s unit of measurement is set to 5 minutes, the timestamp on x-axis for the running option will show 00:03, and followed by 00:08 while the fixed points option will show 00:05, and followed by 00:10.
Enable Display of Future Data	Optional	Allow data with a future timestamp to be displayed on the chart. Useful if forecasting logic is being implemented.
Consolidate and Auto-scale Axes	Optional	If selected, all y-axis ranges will be consolidated to a single range. The minimum and maximum value will automatically adjust based on the payload values.
Widget Refresh Interval (seconds)	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.
Dashboard to Link to	Optional	Ability to link any type of dashboard to the multi-axes chart.
Node to Link to	Optional	Ability to link a node to the multi-axes chart. Use case: parent-child charts.
Interval Options Button	Mandatory	Allows users to show or hide the functionality to modify the intervals on the Rayven Dashboard.

Section: Delay
Field	Requirement	Comments
Apply Delay	Optional	When checked, it allows users to delay the display of the data on the timeline chart.
Delay Size	Mandatory (Only when Apply Delay is checked)	Enter a numeric value that will delay the display of data on the chart in any time measurement unit.
Delay Units	Mandatory (Only when Apply Delay is checked)	Select a time measurement unit from a dropdown menu: Seconds Minutes Hours Days Weeks Months Years

Section: Date Format
This section contains basic configuration elements required for any line chart implementation
Field	Requirement	Comments
X - axis	Optional	Select from a dropdown menu Default Date Only Time Only
Tooltip	Optional	Select from a dropdown menu Default Date Only Time Only

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: File Display
This section contains configuration elements for displaying a file icon on the multi-axes chart. This section contains the FTP details for obtaining the files. Clicking on the icon will allow you to download the file. Examples of supported file types are MP3, MP4, WAV, CSV, PDF, TXT, JPG, PNG, and GIF.
Field	Requirement	Comments
FTP Address	Mandatory	The FTP address for the folder within the FTP server in which the files are located.
FTP User Name	Mandatory	The username to access the FTP server.
FTP Password	Mandatory	The password to access the FTP server.

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.