Polar Chart Node

Displays data along a radial axis and angular coordinates. Useful for comparing multiple variables with a central point relating them.

What is a Polar Chart?

A polar chart, also known as a wind rose chart, is a specialized graph used to visualize data that includes both magnitude and direction. This type of chart is particularly effective for representing data such as wind speeds and directions, or noise levels from different sources. In a polar chart, data points are plotted in a circular layout where the angle represents the direction (e.g., north, south, east, west) and the distance from the center indicates the magnitude. This format allows for an intuitive and comprehensive representation of how certain variables change in relation to direction, providing clear insights into patterns that might be difficult to discern using other chart types. For instance, in meteorology, polar charts are crucial for showing wind speed and direction distributions, helping in weather forecasting and analysis.

Inputs

The polar chart node has 2 mandatory inputs. These are:

Input	Requirement	Comments
Data Field Name	Mandatory	Provide the JSON key for the magnitude data
Direction Field Name	Mandatory	Provide the JSON key for the direction heading data, where the expected value is from 0° to 359°

Functionality

Visualizes magnitude and directional data using a wind rose visualization

How to Use

Implementation

In the Rayven Workflow Builder:

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

Configuration

Section: General
This section contains basic configuration elements required for any polar 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.
Widget Header	Mandatory	Ability to hide or show the widget’s header.
Device/Device Label Name	Mandatory	Select this checkbox to display the device or label name on the widget.
Polar Type	Mandatory	Select one of the options in the drop down menu: Regular Noise Rose
Data Field Name	Mandatory	Provide the JSON key for the magnitude data.
Angle Field Name	Mandatory (If Noise Rose is selected)	Provide the JSON key that holds the angle data.
Direction Field Name	Mandatory (If Regular is selected)	Provide the JSON key for the direction heading data, where the expected value is from 0° to 359°
Calculation Interval	Mandatory	Enter an integer to represent the interval for each calculation
Units of Measurement	Mandatory	Enter the units of measurement to be used for the interval calculations. For example, if the following is configured: X-axis time interval = 1 Units of measurement = Hour Function = average Then the chart will calculate the average value for each column once an hour
Compass-Heading Bins	Mandatory	Select how many direction bins will appear on the polar chart. Select from: 8 (N, NE, E, SE, S, SW, W, NW) 16 (N, NNE, NE, ENE, E, ESE, SE, SSE, S, SSW, SW, WSW, W, WNW, NW, NNW) Custom Degree - Allow users to input a custom degree value.
Custom Degree Value	Mandatory	Enter a numeric value to set the degree difference on the polar chart.
Starting From Zero	Optional	If this is checked, the degree will start from 0. If unchecked, the degree will start from the lowest value received by the node.
Widget Refresh Interval (sec)	Mandatory	Configure how often the chart widget will refresh. The default is every 60 seconds.
Decimal Precision	Optional	Enter the number of decimal places to display for each field.

Section: Series Ranges
This section contains configuration elements required for each color range
Field	Requirement	Comments
Symbol	Optional	Enter a symbol for the units of measurement. (e.g. m/s)
Range Min Value	Optional	Enter the minimum value for the range
Range Max Value	Optional	Enter the maximum value for the range
Hex Color	Optional	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.
Range Name	Mandatory (Only when “Noise Rose” is selected as the Polar Type)	Enter a name for the range setup for the noise data.

Section: Map
This section contains configuration elements required for the polar chart’s map
Field	Requirement	Comments
Show map in the background	Optional	Select this checkbox to display a map under the wind rose visualization
Default Latitude	Optional	Enter a decimal value for latitude where the map will be centered
Default Longitude	Optional	Enter a decimal value for longitude where the map will be centered
Latitude Field Name	Optional	If using coordinates from the payload, enter the JSON key that stores latitude information
Longitude Field Name	Optional	If using coordinates from the payload, enter the JSON key that stores longitude information
Zoom Factor	Optional	Integer value for setting the default map zoom setting. Suggested values are between 12 and 16
Map Type	Optional	Select from Default map Satellite map

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