Style Box Plot

Box plot (v2.0.0+)

How a sensor's readings spread: each box shows the median, the middle half of the readings (the quartiles) and the whiskers. One box per entity, or one per hour, day, week or month. It is a history chart like Line, and shares its period, calendar spans, previous and next buttons, statistics, axes, hover readout and compact layout.

Good for

Comparing spread rather than a single average: how steady each room's temperature is, how a day's readings vary over a week, which sensor swings the most.

Example

type: custom:chartdeck-card
style: box
title: Temperatures per day
group_by: day
period:
  last: 7
  unit: day
entities:
  - entity: sensor.inside_temperature
    name: Inside
  - entity: sensor.outside_temperature
    name: Outside

To use this style, set style: box (or pick Box plot under Distributions in the editor's Style section). The chart options are in the editor's Chart section.

Sensible defaults

• One box per entity over the period. With group_by (hour, day, week or month) there is one box per group instead, and several entities sit side by side in their colours.
• Each value counts for as long as it held. History records changes, so a room that sat at 20 °C all day and flickered to 30 °C for a few minutes has a median of 20. The value carried in from before a group counts from its start, unavailable time doesn't count, and the current group stops at now.
• From long-term statistics (source: statistics) hourly rows are read (five-minute rows for hourly boxes). Each row counts once, and its own min and max widen the box's lowest and highest.
• Whiskers reach 1.5 times the box's height, with readings beyond them drawn as outlier dots.
• Period: the last 24 hours when period isn't set, as on the line chart.

Options

whiskers: tukey         # tukey (default): 1.5 × box height, outliers as dots; range: lowest to highest
orientation: vertical   # vertical (default) or horizontal, with the names up the side
readings: false         # true draws each reading as a dot over its box

• readings: true draws each reading as a dot, nudged sideways the same way every time, over its box. At most 120 are drawn per box.
• Quantiles are weighted (Hazen): four readings 1, 2, 3 and 4 have a median of 2.5.
• Grouping only sets the boxes' boundaries here, so there is no Combine with choice.
• Per entity, color sets the box colour.

Hovering or touching a box shows its highest, quartiles, median, lowest, average and number of readings, and how many outliers there are.

In the editor: the period and source, Group readings by, Boxes, Whiskers reach, Show each reading, the axes and layout. Each entity has a Box colour.

Transforms, conditions and units (v2.2.0+)

• A per-entity transform works here: box a running total (cumulative) or a rate of change (derivative) instead of the readings. With source: statistics it works on the statistics' averages.
• A when hides readings before the boxes are worked out, so each box describes only the time the condition held.
• Unit conversion applies to the readings, so the boxes are in the unit shown.
• legend_toggle hides and shows entities from the names row.

Everything else

The period, calendar spans, source, axes, gridlines, hover and compact layout are the same as on the line chart. See Line for each one.

Layout: one chart for the whole card. Every shared option is described on the Options page.

Previous: Heatmap · Next: Funnel · All styles