Category Bar Chart

Category Bar Chart Node

The category bar chart node displays data in vertical bars. Each bar represents a particular category or group. This node allows users to compare variables between different groups over a specific time period.

Adding a Category Bar 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 Category Bar Chart node and drag it onto the canvas. 
4. Connect the Category Bar Chart node to your desired input node.
5. Double click on the Category Bar Chart node to open its configuration window.

Configuring your Category Bar 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. Choose the Calculation Interval to apply the function over. This value must be an integer. 
5. Select a Unit of Measurement for the interval from the drop-down menu. These range from minutes to years.
6. Set a Widget Refresh Interval to determine how often the chart is updated. This value must be an integer and is measured in seconds.
7. Enter a name for the Y-axis Label. 
8. Select the Minimum and Maximum Range values for your Y-axis. 
9. Enter a name for the X-axis Label.
   

Example

If you configure the following:

X-axis time interval = 1

Units of measurement = Hour

Function = Average

The chart will calculate the average value for each column once an hour.

Configuring your categories

You need to configure each category that will appear on your chart.

1. Under X-axis Field, enter the name of the field within the incoming JSON payload that contains the data you want to display on the widget. Each unique x-axis field will be represented by a vertical bar.
2. Enter a label for each category you want to appear on the chart under Name of X-axis Category.
3. Select a Functionto apply to your data from the drop-down menu: 
   • Last Value Received,
   • Sum,
   • Average,
   • Min,
   • or Max.
4. You can set the number of decimal places for your data using Decimal Precision.
   
5. Select a color for each field using a hex or RGB code. If you leave this blank, the node will use a range of default colors.

Grouping by Device Label

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. Enter your chosen label under Device Label Name.
2. Select a method for grouping the dashboard data:
   • No Grouping (widget per device): one Category Bar Chart widget will appear for each device.
   • Group by device label value (widget per label value): one Category Bar Chart 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 Category Bar Chart widget will be displayed. It will contain data from all devices with the selected device label.

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