Polar Chart

Polar Chart Node

The polar chart node displays data containing both magnitude and direction (for example, wind data). It visualizes data using a wind rose.

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

Configuring your Polar 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. Enter the Data Field Name for the magnitude data. This value should exactly match the corresponding field name within the incoming payload.
5. Enter the Direction Field Name for the direction heading data. This value should exactly match the corresponding field name within the incoming payload. Measure this value in degrees (°): the expected range is 0° to 359°. 
6. Select how many direction bins will appear on the Polar Chart from the drop-down menu under Compass-Heading Bins:
   • 8 (N, NE, E, SE, S, SW, W, NW), 
   • or 16 (N, NNE, NE, ENE, E, ESE, SE, SSE, S, SSW, SW, WSW, W, WNW, NW, NNW).
7. Choose the Calculation Interval for the function to be applied over. This value must be an integer. 
8. Select a Unit of Measurement for the interval from the drop-down menu. These range from minutes to years.
9. You can set the number of decimal places for your data using Decimal Precision.
   

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.

Series Ranges

Configure this section if you want your Polar Chart to display color ranges. 

1. Enter a Symbol for the Units of Measurement (for example, m/s).
2. Add a Minimum and Maximum Range Value.
3. 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.

Map Settings 

In this section you can customize the map your Polar Chart will display.

1. Select Show Map in the Background if you want a map displayed under the wind rose.
2. Enter a Default Latitude and Longitude to determine where the map will be centred.
3. You can use coordinates from the payload to configure your map location. To do so, enter the JSON field names containing coordinate data under Latitude Field Name and Longitude Field Name. 
4. Set a default Zoom Factor for your map. This value must be an integer. We suggest you pick a value between 12 and 16. 
5. Select your Map Type:
   • Default Map,
   • or Satellite Map.  

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 device label under Device Label Name. 
2. Currently, the Polar Chart node only supports 'No Grouping'. When you select No Grouping (widget per device), one Polar Chart widget will appear for each device.

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