Bar Chart Node

Displays data with rectangular bars with lengths proportional to the values they represent. Useful for comparing several items across categories.

What is a bar chart?

A bar chart is a graphical representation commonly used to display and compare categorical data. It consists of rectangular bars, where the length or height of each bar represents the quantity or frequency of a particular category. Typically, the categories are displayed along the horizontal axis (X-axis), while the corresponding values are depicted along the vertical axis (Y-axis). Bar charts are versatile and effective for visualizing various types of data, such as sales figures by product, population demographics by age group, or survey responses by category. They provide a clear and intuitive way to identify trends, patterns, and variations within the data, making them valuable tools for data analysis, reporting, and decision-making across a wide range of fields and industries.

Inputs

The bar 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 provides a visual presentation of time-series data using vertical bars to track changes over time.

Outputs

The bar chart node will display the Input Data Field using vertical bars based on the configuration set.

How to Use

Implementation

In the Rayven Workflow Builder:

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

Configuration

Section: General
This section contains basic configuration elements required for any bar 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.
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 Last value received Last Value from Each Device with Common Tag
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 (seconds)	Optional	Configure how often the chart widget will refresh. The default is every 60 seconds.
Name of Y axis	Optional	Provide a name to represent the y-axis.
Output Field Name	Optional	Provide a 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 Display of Future Data	Optional	Allow data with a future timestamp to be displayed on the chart. Useful if forecasting logic is being implemented.
Color	Optional	You can select any color for the bar chart to display on the dashboard.
Decimal Precision	Optional	Enter the number of decimal places to display on the dashboard.
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 time series chart.
Delay Size	Mandatory (Only when Apply Delay is checked)	Provide an integer to determine the delay period.
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.