Guide / Controls / Charts

Radar

Several scores on one shape

When to use it. A spider/polygon profile chart: N axes radiate from center, each series draws one filled polygon — device health across dimensions, fleet comparisons, character stats. With editable, the first series' vertices drag along their axes, turning the chart into a multi-parameter tuner (EQ bands, PID gains, mixer sends) that fires one action carrying every axis value on release.

Type
radar
Default size
3 rows × 3 columns
Symbol
hexagon.fill
Docs
Docs complete
Search for it as
  • spider
  • web
  • polar
  • compare
  • skills
  • star chart
Radar: Fleet comparison (two overlaid profiles)
Rendered by the app

Fields

18 fields you can set on a radar control. Every control also takes the shared fields (id, position, span, sync, action).

Fields
FieldTypeDefaultWhat it does
haptichapticchoiceone of 10—

The buzz you feel after an edit

Plays this haptic on the phone when you let go of a dragged vertex; light if unset.

  • noneno vibration
  • lighta small soft tap
  • mediuma medium tap
  • heavya strong thud
  • softa gentle cushioned bump
  • rigida firm sharp click
  • selectionthe faint tick of picking an item
  • successthe double tap of a success
  • warninga two-pulse warning
  • errora sharp triple buzz of an error
Titlelabeltext—

The caption under the chart

Shows this text beneath the radar chart.

radarConfigradarConfigobject—

All the chart's look and edit settings in one box

Groups the chart options (rings, fill, labels, editing) that shape how the radar draws and behaves.

Colortintcolor#667eea

The main color of the chart

Colors the first series and seeds the palette the other series cycle through.

formatValueformatValuetext—

How the numbers are written

Formats the numeric value beside each vertex, e.g. as a whole number or a percent.

Series colorsradarConfig.colorsstring[]—

The colors for each series

Gives each series its own outline and fill color in turn; a series with its own color keeps it.

Curved edgesradarConfig.curvedon / offfalse (off)

Smooth or pointed shape

Draws each series as a rounded shape instead of a polygon with straight edges.

editableradarConfig.editableon / offfalse (off)

Drag the shape to change values

Lets you drag the first series' vertices along their axes; releasing fires the action with every axis value.

Fill strengthradarConfig.fillOpacitynumber0–1step 0.050.25

How solid the filled shape is

Sets how opaque the filled area inside each series outline is, from 0 (clear) to 1 (solid).

GlowglowRadiusnumber0–30 ptstep 10

A soft halo around the outline

Adds a glow behind each series outline in its own color, 0 (off) to 30 points wide.

Line endslineCapchoiceone of 3round

The shape of the outline corners

Rounds, cuts or sharpens the corners of each series outline.

  • round defaultsoft rounded corners
  • buttcorners cut flat
  • squaresharp pointed corners
maxValueradarConfig.maxValuenumber—

The value at the outer edge

Sets the value that reaches the rim on every axis; a max in the data overrides it.

Grid ringsradarConfig.ringsnumber1–12step 14

How many grid circles

Draws this many concentric grid rings (1 to 12) to read values against.

Axis labelsradarConfig.showAxisLabelson / offtrue (on)

Show the axis names

Prints each axis name around the outside of the chart.

LegendradarConfig.showLegendon / offfalse (off)

Show a key for the series

Adds a legend under the chart naming each series in its color.

PointsradarConfig.showPointson / offtrue (on)

Show dots at the corners

Draws a dot at each vertex of every series; dots always show while editing.

Value labelsradarConfig.showValueson / offfalse (off)

Show the numbers

Prints each vertex's number beside it; the vertex you are dragging always shows its number.

stepradarConfig.stepnumber—

Jump size when dragging

Snaps dragged values to multiples of this step, e.g. 5 or 0.1.

Theme fields

Restyle one control by setting these in its theme object; a layout's theme sets them for every control.

Theme fields
FieldTypeDefaultWhat it does
secondaryColortheme.secondaryColorcolor#FFFFFF99

Label text size

Sets the label text size from 8 to 24 points.

Emits and receives

What this control sends when you use it, and what it can show or follow when data arrives.

Emits

Emits
SendsWhenTypeWhat it sends
When you let go of the shapevaluereleasejson

the axis names and the first series' numbers, as JSON

Only when editing is on; dragging a corner redraws the shape live and sends once on release

Example: {"axes": ["Item 1", "Item 2", "Item 3"], "values": [3, 2, 1]}

Receives

Receives
TakesFromTypeWhat it does
seriesshowhub, mqtt, http, store, defaultjson

axes (the spokes) and series: a list of numbers, one per axis, each

the shape grows or shrinks to the new numbers along each axis

Example: {"axes": ["Item 1", "Item 2", "Item 3"], "series": [{"name": "Series 1", "values": [3, 2, 1]}]}

Sample

The placeholder value the editor shows before real data arrives.

  • {"axes": ["Item 1", "Item 2", "Item 3", "Item 4", "Item 5"], "series": [{"name": "Series 1", "values": [3, 2, 4, 1, 3]}]} then {"axes": ["Item 1", "Item 2", "Item 3", "Item 4", "Item 5"], "series": [{"name": "Series 1", "values": [4, 1, 2, 3, 4]}]}

Examples

3 examples, each one a control you can paste into a layout.

Fleet comparison (two overlaid profiles)

JSON 9 lines
{
  "type": "radar",
  "id": "rover-compare",
  "position": [0, 0],
  "span": [3, 3],
  "label": "Rover profiles",
  "radarConfig": { "showLegend": true, "curved": true },
  "sync": [{ "method": "meshsocket", "type": "listen", "event": "broadcast", "filter": { "msg_type": "fleet_stats" }, "valuePath": "radar" }]
}

Open in CAR-TER

Radar: Fleet comparison (two overlaid profiles)
Rendered by the app

Multi-parameter tuner (editable EQ)

JSON 10 lines
{
  "type": "radar",
  "id": "eq-tuner",
  "position": [0, 0],
  "span": [3, 3],
  "label": "EQ bands",
  "radarConfig": { "editable": true, "step": 1, "showValues": true, "rings": 5 },
  "action": { "method": "meshsocket", "mode": "broadcast", "event": "broadcast_request", "payload": { "msg_type": "eq_set", "bands": "{{value}}" } },
  "defaultValue": "{\"axes\":[\"60Hz\",\"250Hz\",\"1kHz\",\"4kHz\",\"12kHz\"],\"max\":10,\"series\":[{\"values\":[5,6,5,4,6]}]}"
}

Open in CAR-TER

Radar: Multi-parameter tuner (editable EQ)
Rendered by the app

Skill chart with glow

Demonstrates curved, fillOpacity, glowRadius, lineCap, colors and showAxisLabels: a smooth glowing shape with a custom series color.

JSON 13 lines
{
  "type": "radar",
  "id": "skills",
  "position": [0, 0],
  "span": [3, 3],
  "label": "Skills",
  "tint": "#00D4FF",
  "glowRadius": 10,
  "lineCap": "round",
  "haptic": "light",
  "radarConfig": { "curved": true, "fillOpacity": 0.4, "rings": 5, "maxValue": 10, "showAxisLabels": true, "showPoints": false, "colors": ["#00D4FF", "#FF9500"] },
  "defaultValue": "{\"axes\":[\"Speed\",\"Range\",\"Torque\",\"Grip\"],\"series\":[{\"values\":[8,5,7,6]}]}"
}

Open in CAR-TER

Try it on your phone

carterkit serves a small hub on your computer and pushes one example to CAR-TER on your iPhone or iPad. Pair once with the code it prints.

  1. Install the Python kit.

    pip install carterkit
  2. Show “Fleet comparison (two overlaid profiles)” on your phone.

    carterkit demo radar --example 'Fleet comparison (two overlaid profiles)'
  3. Swap in any example name from this page, or leave --example off for the first one.

carterkit quickstart · Get CAR-TER

Square cells — [2, 2] minimum, [3, 3] when axis labels are long. The control keeps itself round.

RadarConfig

Field Type Default Description
rings number 4 Concentric grid rings
maxValue number data max Per-axis maximum (payload max wins)
fillOpacity number 0.25 Polygon fill opacity 0–1
curved bool false Rounded polygon instead of straight edges
showPoints bool true Vertex dots (always on while editing)
showAxisLabels bool true Axis names around the rim
showValues bool false Numeric value beside each vertex (the dragged vertex always shows)
showLegend bool false Series legend under the chart
colors string[] built-in palette Series color cycle (per-series color wins)
editable bool false Drag the first series' vertices along their axes
step number — Snap dragged values to this step (e.g. 1, 5, 0.1)

Sync Payload Structure

Axes + one or more series — natural JSON or an encoded string:

{
  "axes": ["Speed", "Range", "Torque", "Battery", "Thermals"],
  "max": 100,
  "series": [
    { "name": "Rover A", "color": "#667eea", "values": [80, 55, 70, 90, 62] },
    { "name": "Rover B", "color": "#FF9500", "values": [65, 82, 58, 74, 88] }
  ]
}

Shorthand: {"axes": […], "values": […]} renders one anonymous series.

Series Fields

Field Type Required Description
name string no Legend name
color string no Series color (hex)
values number[] yes One value per axis, in axis order

Behavior

  • Dataset pushes animate the polygons; series after the first draw underneath the editable one
  • Editing: touch near an axis to grab its vertex, drag along the axis (values clamp to 0…max, snap to step), release fires the action with all values
  • Edits update the control's stored dataset live, so state readback returns the tuned values
  • Needs at least 3 axes to render (it's a polygon)

Notes

  • For one value on one scale use Unit; radar earns its footprint at 3+ dimensions
  • Keep axis counts ≤ 8 and labels short — the rim gets crowded fast
  • Scale is shared across axes v1 (per-axis scales would make shapes lie)

Generated from ControlDocs/radar.md. Something unclear or missing? Tell me.