Charts

---

Charts are the primary visualization tool in Exosphere for monitoring and analyzing Miniserver data over time. Create custom visualizations from any control or sensor, compare periods, and export data for further analysis.

---

Use Cases

Charts help you answer questions like:

• Energy monitoring – How much energy did we consume this month compared to last year?
• Temperature tracking – What's the temperature pattern in the server room over 24 hours?
• Peak analysis – When do we experience peak power loads?
• Consumption comparison – Which rooms consume the most energy?
• Trend analysis – Is our energy usage increasing or decreasing over time?

---

Getting Started

New to charts? Follow this quick path:

1. Create your first chart – Start with a simple line chart
2. Add data series – Select sensors to visualize
3. Adjust the time range – Choose day, week, or month view
4. Save and add to dashboard – Combine charts for monitoring

---

Chart Types

Exosphere offers multiple chart types organized into three categories based on their use case.

Live Charts (Real-Time Values)

Live charts display current or recent values, ideal for monitoring dashboards.

Pie Chart

Distribution visualization showing proportional values as slices.

• Best for: Market share, category breakdowns, percentage distributions
• Data source: Uses the last recorded value for each series

Donut Chart

Similar to pie chart with a center hole, often used to display a summary value.

• Best for: Same as pie charts, with space for additional context in center
• Supports: Custom center content display

Stat Chart

Large numeric values displayed in a responsive grid layout.

• Best for: KPI displays, quick status overview, dashboard headers
• Supports: Multiple values in grid arrangement

Gauge Chart

Radial gauge visualization for single values against a scale.

• Best for: Temperature, pressure, fill levels, any value with min/max range
• Supports: Custom scale ranges, threshold indicators

Bar Gauge

Linear horizontal or vertical gauge bars.

• Best for: Comparing multiple current values side-by-side
• Supports: Horizontal and vertical orientations

---

Trend Charts (Time Series)

Trend charts display data changes over time, essential for historical analysis.

Line Chart

Standard time series visualization connecting data points with lines.

• Best for: Temperature trends, energy consumption over time, continuous sensors
• Supports: Multiple series, various interpolation modes, area fills
• Interpolation options: Linear, Smooth, Step-start, Step-middle, Step-end

Area Chart

Filled area under the line, useful for showing volume or cumulative data.

• Best for: Cumulative values, part-to-whole relationships, stacked comparisons
• Supports: Stacking (absolute or normalized to 100%)

Bar Chart

Vertical bars for time-bucketed data comparisons.

• Best for: Daily/weekly/monthly consumption, event counts, periodic comparisons
• Supports: Stacking, grouped bars, navigator for large datasets

Heatmap Chart

Pattern visualization showing intensity across two dimensions.

• Weekly view: Hour of day (Y-axis) vs. day of week (X-axis)
• Monthly view: Day of month (Y-axis) vs. week (X-axis)
• Best for: Usage patterns, occupancy analysis, identifying peak times

---

Analytics Charts

Analytics charts help identify relationships, rankings, and tabular views.

Scatter Chart

Time-series scatter visualization showing individual data points over time.

• Best for: Identifying patterns, outlier detection, sparse data visualization
• Supports: Multiple series with different markers

Box Chart

Statistical distribution visualization showing median, quartiles, and outliers.

• Best for: Comparing value distributions across categories or time periods
• Supports: Whisker plots, outlier markers

Correlation Chart

Two-variable relationship visualization plotting one sensor against another.

• Best for: Identifying relationships between variables (e.g., temperature vs. energy consumption)
• Supports: Multiple series, trend lines

Ranking Chart

Horizontal bar chart sorted by value, showing top/bottom performers.

• Best for: Top consumers, highest temperatures, performance rankings
• Automatically sorted: Descending order by aggregated value

Table Chart

Tabular data display with sorting, filtering, and export capabilities.

• Best for: Detailed data inspection, raw value access, data export
• Supports: Pagination, column sorting, CSV export

---

Energy Charts

Specialized charts for energy monitoring and analysis.

Sankey Chart (Energy Flow)

Flow visualization showing energy distribution through a system.

• Best for: Energy Flow Monitor (EFM) controls, power distribution analysis
• Supports: Expandable/collapsible nodes, power and energy modes

---

Chart Templates

Exosphere provides pre-configured chart templates to accelerate common use cases. Templates include optimized settings for specific control types.

---

Creating a Chart

Quick Start

1. Navigate to Analytics → Charts
2. Click "New Chart"
3. Enter a chart name
4. Click "+" or press the + key to open the sensor search
5. Search and select sensors to add to the chart
6. Adjust time range using the toolbar controls
7. Click Save

---

Adding Data Series

Using the Sensor Search

1. Click the "+" button or press + on your keyboard
2. The sensor search palette opens
3. Type to search by sensor name, control type, or device
4. Click sensors to add them to the chart
5. Multiple sensors can be added in one session

Data Source Types

Charts support multiple data source configurations:

---

Managing Series

Series List

The series panel shows all data sources in your chart:

• Toggle visibility – Click the eye icon to show/hide series
• Change color – Click the color swatch to select a new color
• Reorder – Drag series to change display order
• Remove – Click the X to remove a series
• Filter – Use the search box to find specific series

Pagination for Large Charts

When charts have many series, pagination keeps the interface manageable:

• Page sizes: 5, 10, 25, or 50 series per page
• Navigate between pages using the pagination controls
• Series filter applies across all pages

---

Time Range Selection

Bucket Sizes (Time Window)

The bucket determines the overall time period displayed:

Resolution (Data Granularity)

Resolution controls how data points are aggregated:

Time Navigation

• Previous/Next – Arrow buttons shift the time window
• Zoom In/Out – Adjust resolution for more/less detail

---

Chart Customization

Color Configuration

Color Palettes

Choose from three built-in color palettes:

Custom Series Colors

Override individual series colors:

1. Click the color swatch next to a series name
2. Select from the 56-color palette (7 base colors with variations)
3. Color persists with the chart

---

Y-Axis Configuration

Configure the Y-axis for precise data display:

Multi-Frame Support (Multiple Y-Axes)

Charts can have multiple "frames" with different Y-axes:

1. Add a new frame using the frame controls
2. Assign series to specific frames
3. Each frame can have its own chart type and Y-axis settings
4. Use the layer selector to view all layers or focus on specific ones

---

Interpolation Modes

Control how data points are connected in line/area charts:

---

Stacking Options

For area and bar charts, configure how series are stacked:

Stacking Scope:

• None (Overlay) – Series overlap, independent scales
• Per Series Set – Stack within defined groups
• All Series – Single stack with all series

Stacking Mode:

• None – No stacking
• Absolute – Stack values, show totals
• Normalize to 100% – Show percentage contribution

---

Analysis Features

Benchmark Lines

Display statistical reference lines on your chart:

• Average (avg) – Mean value across the time range
• Minimum (min) – Lowest recorded value
• Maximum (max) – Highest recorded value

Toggle these in the chart settings to add context to your data.

---

Reference Values

Add custom reference lines for goals or thresholds:

1. Open chart settings
2. Navigate to Targets
3. Add a target with:
   • Name – Descriptive label
   • Value – Numeric threshold
   • Color – Line color
4. Multiple targets can be added per chart

---

Period Comparison

Compare current data against previous periods:

Display Modes:

• Overlay – Show comparison as dashed line
• Side by Side – Adjacent bars/areas
• Absolute Change – Show difference value
• Percent Change – Show percentage difference

---

Data Filtering

Series Filters (Data Filters Bar)

Filter which series are displayed based on aggregated values:

Threshold Operators: >, <, >=, <=, ==

Aggregation Options: avg, sum, min, max, last, first, count

---

Gap Handling

Configure how missing data is displayed:

Gap Threshold Multiplier: 2x, 4x, 8x, or 16x the resolution

• Determines when gaps are considered "missing data" vs. normal intervals

---

Exporting Data

CSV Export

CSV export is only available for Table charts.

1. Open a chart with the Table chart type
2. Click the Export CSV button in the table toolbar
3. The CSV file downloads immediately with the current table data

The export includes all visible columns and rows, with timestamps in ISO format. The filename automatically includes the current date.

---

Chart Toolbar Features

The chart toolbar provides quick access to common actions:

---

Auto-Refresh

Enable automatic chart refresh for real-time monitoring dashboards.

Available Intervals:

• 5 seconds (real-time monitoring)
• 30 seconds
• 1, 5, 10, 30 minutes
• 1 hour

Requirements:

• Device must be online

The refresh countdown timer shows when the next update will occur.

---

Statistics Recording

Backfill Statistics

For sensors that don't have historical data, use the backfill feature:

1. Select sensors missing data in the chart
2. Click Backfill Statistics in the toolbar
3. The system retrieves historical data from the Miniserver

Live vs Statistical Data

Charts can display two types of data:

The chart header indicates which mode is being displayed.

---

Best Practices

Performance Optimization

Chart Organization

• Keep charts focused – 5-8 series maximum for readability
• Use consistent colors – Same sensor = same color across charts
• Name descriptively – Include location or purpose in chart name
• Group in dashboards – Combine related charts for context

---

Troubleshooting

For common chart issues and solutions, see the Charts Troubleshooting Guide.

Quick Fixes

---

Related Features

• Chart Configuration – Series settings, Y-axis, value mapping, layering
• Dashboards – Combine multiple charts into unified views
• Export Center – Export chart data and schedule automated reports
• Value History – View data in tabular format
• Data Selection – Find and select datapoints

---

Related Documentation

• Connection Troubleshooting
• Structure File Integration
• License Plans
• User Permissions

---