Weather Chart Node

Visualizes meteorological data over a period. Can display information such as temperature, precipitation, wind speed, and pressure, helping in understanding weather patterns or forecasting.

What is a Weather Chart?

A weather chart is a versatile tool designed to visualize various types of weather data on a single graphical display. Its primary purpose is to present not only current weather conditions but also past data and forecasted trends in an easily understandable format. Typically, weather charts utilize a combination of bars, lines, wind degrees, and icons to represent parameters such as temperature, precipitation, wind speed, and atmospheric pressure. Additionally, users can customize the chart to display weather conditions using predetermined icons, enhancing clarity and visual appeal. By consolidating diverse weather data into a single chart, users can quickly grasp comprehensive insights into weather patterns, aiding in decision-making for activities ranging from daily planning to long-term forecasting.

Inputs

The Weather node has mandatory inputs. These are:

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.
JavaScript node for icons	Optional	To utilize the icons option, a JavaScript node is required that defines the icon parameters, these must match the available built-in definitions for the weather chart.

Functionality

Assigns icons to the other chart type options based on predefined weather condition codes. A JavaScript node is required before the weather node in order to assign certain weather conditions to these codes.

How to Use

Implementation

In the Rayven Workflow Builder:

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

Configuration

Section: General
This section contains basic configuration elements required for any Weather 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.
X - axis time interval dropdown	Mandatory	Select from a dropdown menu: Hourly Daily
Widget refresh interval (sec)	Optional	Configure how often the chart widget will refresh. The default is every 60 seconds.
Comma separators at thousand mark	Optional	When checked, there will be comma separators at the thousand mark.
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.

Section: Column
This section contains basic configuration elements required for any line chart implementation
Field	Requirement	Comments
Y-axis Field Name	Mandatory	Enter the field name of the incoming JSON payload
Y-axis Legend Name	Mandatory	Enter the name that will appear on the chart’s legend
Y-axis Group Name	Optional	Use a single label for y-axis metrics with a common unit of measurement. For example, you may have two fields called Minimum Temperature and Maximum Temperature. Since both have a common unit of measurement, you can enter Temperature as the Group Name for both metrics. This consolidates multiple y-axes labels into a single label.
Chart Type drop-down	Mandatory	Select from a dropdown menu Bar Line Dot Plot Wind Degree Note: When selecting Wind Degree, all of the following fields (after Function) within the Column section are removed, with the Function field only allowing Average.
Function	Mandatory	Select from a dropdown menu Last value received Sum Average Maximum Minimum Icons Note: When selecting Icons, the only chart option that can utilize the icons is using “Dot Plot” as the column’s type. It will also replace the remaining fields with an “Icons name field” - where you input the variable name associated with your workflows’ weather descriptions. When configuring the Y-axis Field Name for icons, it must be the same as another column, so that the icons can sit on top of that line/bar.
Range Min	Mandatory	Provide the minimum value for the range.
Range Max	Mandatory	Provide the maximum value for the range.
Decimal Precision	Optional	Enter the number of decimal places to display on the dashboard
Hex Color	Advanced	Hex code entry to select a color for this Condition’s output.

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: 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.