Overview
The Heatmap widget displays a matrix of color-coded cells where color intensity represents values. It's excellent for identifying patterns in large datasets, displaying correlation matrices and visualizing geographic or temporal distributions.
Use Cases
- Pattern Recognition - Identify patterns in time-series data
- Temporal Analysis - Visualize data across time periods
- Usage Patterns - Display usage over time (hourly, daily, weekly)
- Anomaly Detection - Spot unusual patterns in data
Key Features
- Color intensity mapping
- Time-based clustering
- Hourly, daily, weekly, monthly views
- Interactive cell details
- Aggregation options
Configuration
Basic Settings
| Field | Required | Description |
|---|
| Title | ❌ No | Display name for the widget |
| Thing | ✅ Yes | Select Thing to display data from (not required for ThingType dashboards) |
| Measure | ✅ Yes | Choose measure to visualize |
| Aggregation | ✅ Yes | Data aggregation method (AVG, MIN, MAX, SUM) |
| Color | ✅ Yes | Color for the heatmap scale |
Heatmap Settings
| Field | Required | Description |
|---|
| Unit | ✅ Yes | Time granularity (hour, day, week, month, year) |
| Amount | ✅ Yes | Number of units to display (max 100) |
| Clustering mode | ✅ Yes | Y-axis clustering mode (byHour, byDay, byWeek, byMonth) |
| Min | ❌ No | Minimum value for color scale |
| Max | ❌ No | Maximum value for color scale |
Display Options
| Field | Required | Description |
|---|
| Transparent | ❌ No | Remove widget background |
| Border color | ❌ No | Custom border color |
| Background Color | ❌ No | Custom background color |
Best Practices
- Appropriate Granularity - Choose time unit matching data frequency
- Color Scales - Use intuitive color gradients (cool to hot)
- Pattern Analysis - Look for recurring patterns
- Aggregation Choice - Select aggregation matching analysis goals
- Sufficient Data - Ensure enough data points for meaningful patterns
What's Next?