Level Node

Level visualizations are similar to gauge charts but are often used to display a simple level of a single metric, such as battery level, fuel tank level, or any other kind of reservoir.

What is a level?

A level visualization would typically represent the current fill level of the tank relative to its maximum capacity. This visualization often takes the form of a vertical bar graph, with the length or height of the bar indicating the current volume level as a percentage of the total capacity. Users can quickly assess the volume status at a glance, facilitating efficient monitoring and management of tank levels. Level visualizations for tank volumes are commonly used in industries such as manufacturing, logistics, and utilities, where precise control and monitoring of fluid levels are essential for operational efficiency and safety.

Inputs

The level node has a mandatory input:

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

Functionality

The level node displays the level of liquid in a tank or silo.

How to Use

Implementation

In the Rayven Workflow Builder:

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

Configuration

Section: General
This section contains basic configuration elements required for any level 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.
Symbol	Optional	Enter a symbol that will be displayed at the end of the value (e.g. L or %).
Decimal Precision	Optional	Enter the number of decimal places to display on the dashboard.
Comma Separators at Thousand Mark	Optional	When checked, there will be comma separators at the thousand mark.
Input Data Field	Mandatory	This is the field name within the incoming JSON payload that contains the data to be displayed on the widget.
Full Level Value	Mandatory	Provide maximum value of the tank for percentage calculation. This parameter also accepts dynamic value from the JSON payload by taking [[]] notation (eg. [[max_tank_level]] where the JSON key max_tank_level holds the maximum tank level value)
Liquid Type	Mandatory	Select from a dropdown menu to update display color: Water Fuel Effluent
Range	Mandatory	It is possible to add as many rows as you would like by clicking on “+ Add Column” at the end of the section. Similar to Full Level Value field, this parameter also accepts dynamic value from the JSON payload by taking [[]] notation (eg. [[level_1]] where the JSON key level_1 holds the tank level value)
Hex Color	Mandatory (Only for Range)	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: 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.