kalkih/mini-graph-card
Mini Graph Card
mini-graph-card is a customizable dashboard card and sensor widget for Home Assistant designed to visualize historical telemetry and sensor data. It functions as a time-series data visualizer that renders historical numeric and binary sensor data as line or bar graphs using an SVG graphing component.
The project differentiates itself through the ability to extract specific nested attributes from entities and map non-numeric states into numeric values for visualization. It supports dynamic visual styling via color thresholds, logarithmic scales, and filling effects, alongside a multi-axis coordinate system that allows the comparison of sensors with different numeric ranges.
The tool includes capabilities for historical data aggregation using functions such as averages, medians, and sums to summarize trends. It provides precision controls for data point density, local history data caching to reduce network requests, and customizable interactivity for defining tap actions and navigation paths within the dashboard.
Features
- Sensor Data Visualizers - Provides a dashboard card for visualizing historical sensor and binary sensor telemetry as line or bar graphs.
- Custom Dashboard Cards - Provides a customizable modular UI component for visualizing historical sensor data within Home Assistant dashboards.
- Sensor - Retrieves specific sensor attributes for visualization instead of relying on the primary entity state value.
- Multiple Y-Axis Configurations - Displays multiple independent Y-axes on a single chart to compare sensors with divergent numeric scales.
- Multi-Axis Coordinate Systems - Supports coordinate systems with multiple independent primary and secondary axes for comparing sensors with different numeric ranges.
- Time-Series Visualizers - Visualizes historical telemetry and sensor trends using interactive line and bar charts.
- Telemetry Attribute Extraction - Traverses complex data structures to retrieve specific nested attributes from entities for visualization.
- Time-Series Aggregations - Summarizes raw historical sensor values into discrete time buckets using mathematical functions like averages and sums.
- SVG-Based Vector Rendering - Utilizes scalable vector graphics to render historical sensor data, ensuring crisp visualization across different screen densities.
- IoT Telemetry Mapping - Converts complex sensor attributes and non-numeric states into visual graphs with human-readable labels and scales.
- State-to-Numeric Mappings - Converts string-based sensor states into numeric values for visualization while maintaining custom display labels.
- Home Automation Visualizations - Creates custom visual widgets for Home Assistant to track sensor history and device states.
- Sensor Monitoring Widgets - Implements minimalistic monitoring displays that extract state values or nested attributes from smart home entities.
- Local Data Caches - Provides local caching and compression of time-series sensor data to reduce network requests and improve load times.
- Measurement Value Formatting - Adjusts numerical precision and scaling factors for sensor data to ensure accurate state labels.
- Dashboard Data Caching - Implements a caching layer to store and compress historical telemetry, accelerating the loading of dashboard graphs.
- Data-Driven Visual Styling - Adjusts graph appearance using color thresholds and filling effects based on the underlying sensor values.
- Smart Home Metrics - Processes and aggregates raw smart home sensor data into summaries using averages, sums, and thresholds.
- State-Driven UI Rendering - Automatically updates graph views in response to changes in underlying sensor states or configuration parameters.
- Graph Data Density Controls - Controls the level of detail and smoothing in graphs by specifying the number of data points displayed per hour.
- Dashboard Cards - Minimalistic sensor data visualization.
