Exosphere Documentation

Chart Configuration

Configure series settings, Y-axis options, value mappings, legend display, and layering to build precise chart visualizations.


This page covers the detailed configuration options available when building charts. For chart types, creation, and analysis features, see the main Charts documentation.


Series Configuration

Each series in a chart can be individually configured to override the global chart settings. Open the series settings by clicking on a series in the series panel.

Chart Type Override

Override the global chart type for individual series. This allows mixing different visualization styles in one chart — for example, showing temperature as a line and energy consumption as bars.

Available per-series chart types: Line, Area, Bar, Column, Scatter, Pie, Stat

Mixing chart types works best with separate Y-axes. Assign each series type to its own axis to avoid scale conflicts.


Aggregation & Resolution

Control how data points are aggregated for each series independently.

ResolutionDescription
AutoAutomatically chooses based on the time range
As RecordedRaw data, no aggregation — highest fidelity
1 second – 1 yearFixed intervals from seconds to years

Per-series resolution overrides the global chart resolution. Use this when different series need different granularity — for example, a fast-changing power value at 1-minute resolution alongside a slow-changing temperature at 1-hour resolution.


Differential Display

For series using statistical data mode, enable Show Diff to display the difference between consecutive values instead of absolute values. This is useful for cumulative meters (energy counters, water meters) where you want to see consumption per interval rather than the running total.


Time Offset

Shift a series forward or backward in time by a specified number of seconds. Use cases:

  • Compare shifted data – Overlay yesterday's data on today's chart without using period comparison
  • Compensate for sensor delays – Align data from sensors with known reporting lag
  • Correlate cause and effect – Shift an input series to align with a delayed output

Custom Legend Label

Override the auto-generated legend text for a series with a custom label. Useful when the default label (device + control + state) is too long or not descriptive enough.


Y-Axis Configuration

Separate Y-Axes

When a chart displays series with different units or scales (e.g., temperature in °C and power in kW), assign series to separate Y-axes to prevent one from being squashed flat.

  1. Open series settings for the series you want to separate
  2. Enable Separate Y-Axis
  3. The series gets its own Y-axis on the opposite side of the chart

Each separate axis scales independently based on its own data range.

Custom Axis Range

Set explicit minimum and maximum values for the Y-axis instead of auto-scaling:

SettingDescription
MinFixed lower bound (e.g., 0 for percentages)
MaxFixed upper bound (e.g., 100 for percentages)

Leave either blank to auto-scale that end of the range.

Custom ranges are useful for gauges, percentages, and any value where the expected range is known. Auto-scaling can make small fluctuations appear dramatic when the actual range is narrow.

Format String

Customize how values are displayed on the Y-axis and in tooltips using a format string:

<v> °C       →  22.5 °C
<v> kWh      →  1,450 kWh
<v> %        →  85 %

The <v> placeholder is replaced with the actual value.


Value Mapping

Value mapping transforms raw numeric values into meaningful labels, colors, or categories. This is especially useful for digital states, enums, and status indicators.

Mapping Types

TypeDescriptionExample
DefaultNo mapping, raw values displayed22.522.5
MiniserverUses the Miniserver's built-in value descriptions1On
CustomUser-defined mapping rules0Offline, 1Online

Custom Mapping Rules

Custom mappings support four match types:

Match TypeDescriptionExample
ExactMatch a specific value0 → "Off"
RangeMatch a numeric range18–22 → "Comfortable"
RegexMatch a string pattern/err.*/ → "Error"
SpecialMatch true, false, empty, or nullnull → "No Data"

Each mapping result can specify:

  • Format string – Display text
  • Background color – Cell or indicator background
  • Foreground color – Text color

Use value mapping for digital controls (switches, alarms) to show human-readable labels like "Open/Closed" instead of raw 0/1 values.


Legend Configuration

Show/Hide Legend

Toggle the legend visibility from the global chart settings. When hidden, series are still identifiable via tooltips.

Label Components

Control which parts of the series identification are shown in the legend:

ComponentExampleDefault
Device"Miniserver Office"Shown
Category"Lighting"Hidden
Room"Meeting Room 1"Hidden
Control"Ceiling Light"Shown
Control Type"Switch"Hidden
State"Value"Shown

Adjust these based on your chart context. If all series come from the same device, hide the device label. If they come from different rooms, show the room label.

Legend Value Statistics

Display aggregated statistics next to each series name in the legend:

StatisticDescription
MinMinimum value in the visible time range
MaxMaximum value in the visible time range
AvgAverage value in the visible time range
LastMost recent value

Enable any combination of these to see at-a-glance statistics without hovering over the chart.


Layering & Multi-Series Composition

Charts in Exosphere compose multiple series into a single visualization. Understanding how series layer and interact is key to building readable, informative charts.

Series Ordering

The order of series in the series panel determines their rendering order:

  • For line/area charts: Later series render on top of earlier ones
  • For stacked charts: Series stack bottom-to-top in panel order
  • For bar charts: Grouped bars follow the panel order left-to-right

Drag series in the panel to reorder them. Place the most important series last so it renders on top.

Stacking Behavior

Stacking controls how series values are combined:

ScopeEffect
None (Overlay)Series overlap independently
All SeriesAll series stacked into one group
Per Series SetStack within defined groups
ModeEffect
AbsoluteValues stack additively (total = sum)
Normalize to 100%Each stack scaled to show percentage contribution

Per-series stacking overrides allow individual series to opt out of the global stacking mode.

Combining Chart Types

Mix chart types within one chart by setting per-series chart type overrides:

Common combinations:

  • Line + Bar – Trend line over periodic consumption bars
  • Area + Line – Filled background context with a highlighted metric on top
  • Bar + Scatter – Aggregated values with individual data point outliers

When mixing chart types, use separate Y-axes for series with different scales. The chart automatically positions axes on the left and right sides.

Multi-Axis Layering

When series use separate Y-axes, the chart creates independent visual layers:

  1. Primary axis (left) – First series group, rendered in the background
  2. Secondary axis (right) – Separated series, rendered in the foreground

Each axis auto-scales independently, so a temperature range of 18–24°C and a power range of 0–5000W both use the full chart height.


Interpolation & Smoothing

Global Smoothing

Toggle smooth interpolation for all line and area series from the global chart settings. When enabled, data points are connected with spline curves instead of straight lines.

Per-Chart-Type Interpolation

Different chart types support different interpolation modes (configured in the main Charts settings):

ModeBest For
LinearGeneral-purpose, accurate representation
SmoothAesthetic presentation, smoothed trends
Step-startDigital states, discrete value changes
Step-endValues that hold until the next change

Use Step-end interpolation for switch states and digital controls. It correctly shows that the value holds until the next change, rather than implying a gradual transition.


Settings Hierarchy

Chart configuration follows a layered hierarchy where more specific settings override general ones:

Global Chart Settings (chart type, stacking, legend, smoothing)
    ↓ overridden by
Per-Series Settings (chart type, resolution, stacking, Y-axis)
    ↓ overridden by
Value Mappings (display format, colors per value)

This means you can set sensible defaults at the global level and fine-tune individual series as needed.