Line Chart Node

Displays information as a series of data points connected by straight line segments. Ideal for showing trends over time or continuous data.

What is a line chart?

A line chart is a graphical representation commonly used to display trends and patterns in data over time or across different categories. It consists of data points connected by straight lines, with each data point representing a specific value at a given time or category. Typically, the horizontal axis (X-axis) represents time or categories, while the vertical axis (Y-axis) represents the corresponding values. Line charts are particularly useful for visualizing changes and trends in continuous data sets, such as stock prices over time, temperature variations throughout the day, or sales trends by month. They provide a clear and intuitive way to identify patterns, spot outliers, and analyze relationships between variables, making them valuable tools for data analysis, forecasting, and decision-making across various industries and domains.

Inputs

The line chart node has a mandatory input:

Input	Requirement	Comments
Y-Axis Field	Mandatory	This is the field name within the incoming JSON payload that contains the data to be displayed on the widget.

Functionality

The line chart node is used to compare changes over the same period of time for more than one group.

Outputs

The line chart node will display the Input Data Field using a line based on the configuration set.

How to Use

Implementation

In the Rayven Workflow Builder:

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

Configuration

Section: General
This section contains basic configuration elements required for any line 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	Mandatory	Select this checkbox to display the device or label name on the widget.
Y-Axis 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 from a dropdown menu Sum Average Maximum Minimum Accumulated As Is Last value received Changes Last Value from Each Device with Common Tag
Sub Function	Mandatory (Only available when Last Value from Each Device with Common Tag)	Select from a dropdown menu Sum Average Maximum Minimum
X - axis time interval	Mandatory	Provide an integer to determine the period of input data
Units of Measurement	Mandatory	Select from a dropdown menu Seconds Minutes Hours Days Weeks (Start on Monday) Weeks (Start on Sunday) Months Years
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.
Widget refresh interval (sec)	Optional	Provides an integer to determine how often the chart is updated.
Name of Y axis	Optional	Provide a name/title to represent the y-axis.
Output Field Name	Optional	Provide new field value for output.
Range Min	Optional	Provide the minimum value for the range.
Range Max	Optional	Provide the maximum value for the range.
Enable to display future data	Optional	Checkbox to allow/permit predictive values to be plotted.
Line Color	Optional	Users can select any color for the line chart to display on the dashboard.
Decimal Precision	Optional	Enter the number of decimal places to display on the dashboard.
Visual Option	Mandatory	Select from a dropdown menu Area Line
Dashboard 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: 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.