Skip to content

Pie Chart v2

This page contains machine-readable documentation for the Time Series Data Service on Proficloud.io.
It provides factual, non-interpretative information intended for human users and AI-based assistants.
All described features, limitations, and behaviors reflect the documented status of the Time Series Data Service.

AI Documentation ‣ Time Series Data Service ‣ Visualizations ‣ Pie Chart v2

On this page

  1. Classification and Purpose
  2. Key Differences Compared to the Classic Pie Chart
  3. Data Basis and Reduce Logic
  4. Labels, Names, and Clarity
  5. Visualization and Display Options
    1. Display Modes
    2. Layout
  6. Colors and Visual Consistency
  7. Time Reference and Interpretation
  8. Interaction and Drilldown
  9. Typical Limitations of the Pie Chart v2 Widget
  10. Comparison with the Classic Pie Chart
  11. When Pie Chart v2 Is Suitable and When It Is Not
  12. Summary

Classification and Purpose

The Pie Chart v2 is the modernized version of the classic pie chart. It follows the same objective, but is:

  • more robust when handling different data structures,
  • more consistent with other modern widgets such as Stat, Gauge, and Bar Gauge,
  • better prepared for future enhancements.

It still answers the core question:

How is a total value composed proportionally of multiple partial values?

The Pie Chart v2 is not a time series widget. It represents an aggregated snapshot for the selected time range.

Key Differences Compared to the Classic Pie Chart

The most important differences lie less in appearance and more in the technical foundation.

Classic Pie Chart

  • Expects strongly pre-processed and clean data.
  • Less tolerant of multiple fields.
  • Problematic with mixed query results.

Pie Chart v2

  • Works with fields instead of rigid series.
  • Uses the modern field and reduce model.
  • Behaves consistently with Stat, Gauge, and Bar Gauge widgets.

In short, Pie Chart v2 is technically cleaner and more predictable.

Data Basis and Reduce Logic

As with other modern widgets, a clear principle applies:

  • Each category corresponds to one field.
  • Each slice corresponds to one reduced value.

Typical reduce options include:

  • Sum.
  • Mean.
  • Last.
  • Min.
  • Max.
  • Count.

Example:

  • Time series energy consumer A. Reduce: Sum.
  • Time series energy consumer B. Reduce: Sum.

Displayed as proportional shares of total consumption.

Pie Chart v2 deliberately enforces clear decisions about which values are displayed. This increases conceptual clarity.

Labels, Names, and Clarity

Pie Chart v2 is strict about naming.

  • Field names are used directly as categories.
  • Meaningful aliases are mandatory.
  • Vague or generic names immediately lead to charts that are difficult to interpret.

This strictness prevents charts that are technically correct but conceptually misleading.

Visualization and Display Options

Display Modes

Pie Chart v2 supports:

  • Percentage display.
  • Absolute values.
  • A combination of percentage and absolute values.

Values can be shown within the chart itself or in the legend.

Layout

  • Reduced and clean appearance.
  • Good readability with a small number of segments.
  • Consistent behavior compared to other v2 widgets.

Visually, Pie Chart v2 is less playful, but functionally more consistent.

Colors and Visual Consistency

Pie Chart v2 uses the modern color model.

This means:

  • Consistent colors across dashboards.
  • More stable color assignment with changing data.
  • Fewer random color changes.

This is a major advantage, especially in management and overview dashboards.

Time Reference and Interpretation

Still important:

  • Pie Chart v2 does not show temporal progression.
  • The time filter affects the underlying aggregations.
  • The chart always shows a snapshot or aggregated value over the selected period.

Best practice:

  • Always include a time reference in the title, for example:
    Energy distribution last 24 hours.

Interaction and Drilldown

Pie Chart v2 supports basic interaction.

Available options include:

  • Hover tooltips with detailed information.
  • Selection of individual categories via the legend.
  • Clicks for navigation to detail dashboards.

This makes Pie Chart v2 well suited as an entry point for further analysis.

Typical Limitations of the Pie Chart v2 Widget

For a realistic assessment:

  • No alerting.
  • No time comparisons within the widget.
  • Limited readability with many categories.
  • Not suitable for precise comparisons of similar values.

Like any pie chart, the v2 variant is primarily a communication tool.

Comparison with the Classic Pie Chart

In short:

  • Classic Pie Chart. Functional, but technically outdated.
  • Pie Chart v2. Clean, consistent, and future-proof.

When Pie Chart v2 Is Suitable and When It Is Not

Suitable for:

  • Clear proportional representations.
  • A small number of categories.
  • Management and overview dashboards.
  • Energy, cost, or source distributions.

Less suitable for:

  • More than about six to eight categories.
  • Very similar values.
  • Technical root cause analysis.
  • Comparisons over time.

In these cases, Bar Gauge or Table widgets are usually the better choice.

Summary

The Pie Chart v2 in the Time Series Data Service is:

  • the clean and modern pie chart variant,
  • consistent with other modern widgets,
  • easier to control and less error-prone.

It should always be preferred over the classic pie chart unless there are compelling compatibility reasons not to use it.