Overview

Displaying multivariate data in the form of a two-dimensional chart of three or more quantitative variables with the Radar Widget. You will find 2 kinds of radar in this category.

The user explicitly defines two lists:

• The list of series (circular envelopes, called "layers" in the nivo documentation), which defaults to 1 element.
• The list of domains (axes, called "dimensions" in the nivo documentation), which defaults to 3 elements.

Single Series Case

If a user configures:

• One series: "Series 1"
• Three domains:
  • "Variable 1" mapped to property "var1" (which is a number or a string but not an array)
  • "Variable 2" mapped to property "var2" (which is a number or a string but not an array)
  • "Variable 3" mapped to property "var3" (which is a number or a string but not an array)

Then upon receiving the following message:

payload = {
    "var1": 3,
    "var2": 6,
    "var3": 9
  }
return msg;

a radar chart with three branches and a single envelope is displayed.

If a new message arrives with values for var1, var2, and var3, then the radar chart updates with the new values.

Multiple Series Case

If a user configures:

• Four series: "Series 1", "Series 2", "Series 3", "Series 4"
• Three domains:
  • "Variable 1" mapped to property "var1" (which is an array of four numbers or four strings)
  • "Variable 2" mapped to property "var2" (which is an array of four numbers or four strings)
  • "Variable 3" mapped to property "var3" (which is an array of four numbers or four strings)

Then upon receiving the following message:

msg.payload = {
    "var1": [1, 2, 3, 4],
    "var2": [1, 2, 3, 4],
    "var3": [1, 2, 3, 4]
  }
return msg;

a radar chart with three branches and four concentric envelopes of diameters 1, 2, 3, and 4 is displayed.

If a new message arrives with values for var1, var2, and var3, then the radar chart updates with the new values.

Remarks

• If only one series is configured, then the values for each axis must be numbers or strings (no arrays).
• If N series are configured, then the values for each axis must be arrays of dimension N.
• The order of series definition is the order in which we assign array elements: the first series will be linked to the 0th elements of the arrays, etc.