Periodic Data Chart #

Introduction #

The Periodic Data Chart is a report-focused component designed to visualize dataset values grouped over a comparison period (e.g., daily, weekly, monthly). It aggregates values across time using defined strategies (sum, avg, min, max) and renders grouped bar or line charts to facilitate trend and pattern comparisons across time intervals.

Features #

  • Supports Bar and Line chart types
  • Aggregates data using: Sum, Avg, Min, Max
  • Groups data by comparison periods (e.g., hours in day, days in week, months in year)
  • Fully compatible with reporting mode sizing (fixed width/height)
  • Automatically adjusts X-axis labels based on comparison period
  • Consistent legend grouping and color mapping
  • Localized tooltips and multi-language support

Use Cases #

  • Reporting energy usage per hour/day/week/month
  • Comparing performance metrics across time intervals
  • Identifying seasonal patterns or cyclic behavior
  • Embedding clear and condensed time-based charts into PDF/print reports

Configuration #

  • valueDataset: Source dataset to visualize
  • chartType: "bar" or "line"
  • aggregationType: SUM, AVG, MIN, MAX
  • comparisonPeriod: e.g., HOURLY_DAILY, DAILY_WEEKLY, MONTHLY_YEARLY
  • from, to: Optional date overrides
  • loadConf: Fallback configuration for aligned data fetching
  • reportMode: Enables fixed dimension rendering for PDF/export

Example #

  • Bar chart

Periodic Data Chart

  • Line chart

Periodic Data Chart