Line Chart Node

Line Chart Node

The line chart node enables the visualization of time-series data on a single line. Line charts are an easy way to track and analyze changes to a metric over time. They are better for displaying small changes than bar graphs, and you can use them to compare changes over the same period for more than one data group.

Adding a Line Chart node to your workflow

1. First, select your desired solution and navigate to Rayven Workflow.
2. Select ‘Visualizations’ from the left-hand panel. 
3. Find the Line Chart node and drag it onto the canvas. 
4. Connect the Line Chart node to your desired input node.
5. Double click on the Line Chart node to open its configuration window. 

Configuring your Line Chart node

1. First, give your node a Name. Choose something simple that clearly explains its purpose.
2. If you want, you can add a Widget Subtitle. This additional text helps explain the data presented in the node. Anything added here will appear directly under the Widget Name in a smaller font.
3. Select the Device/Device Label Name checkbox if you want the device or label name displayed on the widget.
4. Enter your Data Field Name: the field within the incoming payload with the data you want the widget to display. This data will be your y-axis.
5. Choose a Function to apply based on your desired chart calculation. The options are:
   • Sum,
   • Average,
   • Maximum,
   • Minimum,
   • Accumulated,
   • As-Is,
   • Last value received.
6. Choose your X-axis Time Interval to determine the period the calculation should happen within. You must enter this as an integer.
7. Select a Unit of Measurement from the dropdown menu. These range from minutes to years.
8. You can set a Widget Refresh Interval to determine how often the chart updates in seconds. You must enter this as an integer.
9. Choose whether you want to add a Y-Axis Name or Title.
10. If you have a new field where outputs should appear, enter this value under Output Field Name.
11. Range Min and Range Max allow you to set minimum and maximum range values for your chart.
12. Select the Enable to Display Future Data checkbox to allow the plotting of predictive values.
13. Choose a Line Color. 
14. Use Decimal Precision to set the number of decimal places for your data.
    

Selecting a date format

To configure any line chart, you must choose your date format. When configuring your X-axis and Tooltip fields, select from the following options:

• Default,
• Date only,
• Time only.
  

Grouping by Device Label

You need to select how data should be grouped and displayed on the widget. To group data by device label, you must first create at least one label in the Device Labels section of the Workspace. See Creating Device Labels and Configuring Nodes Using Labels for more information.

1. Select your desired device label from the dropdown list under Device Label Name.
2. Select a grouping option to determine the dashboard display: 
   • No Grouping (widget per device): one Image widget will appear for each device.
   • Group by device label value (widget per label value): one Image widget will appear for each unique value label. For example, if the device label is ‘Color’ and the label values are ‘Green’ and ‘Gold’, the dashboard will display two widgets. One will show data for devices labeled ‘Green’, and the other for devices labeled ‘Gold’.
   • Group by device label name (one widget): only one Image widget will be displayed. It will contain data from all devices with the selected device label.

When viewing the Line Chart Widget in Rayven Live, clicking the eye icon will open a popup window where you can view historical data and compare data sets.

See Also: Creating a dashboard, Creating device labels, Configuring nodes using labels
As of Release: 08.12.2021