# Heatmap & Analytics

# Heatmap & Analytics

The Heatmap feature visualizes presence patterns over time, showing you where people spend the most time in a room. Use this data to optimize zone placement and understand room usage.

> **Note**: Heatmap is available for Everything Presence Lite (EPL) and Everything Presence Pro devices.

## Accessing the Heatmap


1. From the Live Dashboard, click the **menu icon** (☰)
2. Select **Heatmap**

 ![](https://docs.everythingsmart.io/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2U1MTYzNjNkLThhMWItNDI0Zi1hOTk5LTI0ZDFmMDUxZDNhZi80ZjJhMGE5YS02ZDc0LTQ3ODctYjYzNS02YjEyNmZiMzg3ZDUvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTM2ODExMDAsImV4cCI6MTc5Mzc2NzUwMH0.IGsDQzkKZ5_ixMhJvmlzjESoBHEbHCWpk6VBab18xqc)

## Understanding the Heatmap

### Color Scale

The heatmap uses colors to show presence intensity:

| Color | Meaning |
|-------|---------|
| **Blue/Purple** | Low presence (rarely occupied) |
| **Green** | Moderate presence |
| **Yellow** | High presence |
| **Orange/Red** | Very high presence (frequently occupied) |

### What It Shows

The heatmap displays accumulated presence data over the selected time period. Areas where targets are detected more frequently appear "hotter" (warmer colors).

## Time Period Selection

Choose the time range for your heatmap data:

 ![](https://docs.everythingsmart.io/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2U1MTYzNjNkLThhMWItNDI0Zi1hOTk5LTI0ZDFmMDUxZDNhZi8zZDM2ZDdjNS0yYWE4LTQ1OTAtOTM1OC00ZmM0M2MxZWIxYjgvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTM2ODExMDAsImV4cCI6MTc5Mzc2NzUwMH0.lsX9W_B25vi9ksgk5kxHfwZYlObHOOmj3d0HmI1RI4A)

| Period | Description |
|--------|-------------|
| **Last Hour** | Recent activity snapshot |
| **Last 24 Hours** | Full day overview |
| **Last 7 Days** | Weekly patterns |
| **Last 30 Days** | Monthly usage trends |
| **Custom Range** | Select specific start/end dates |

## Hourly Activity Chart

Below the heatmap, an activity chart shows presence levels by hour:

* **X-axis**: Hours of the day (0-23)
* **Y-axis**: Presence intensity
* **Bars**: Average activity level for each hour

 ![](https://docs.everythingsmart.io/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2U1MTYzNjNkLThhMWItNDI0Zi1hOTk5LTI0ZDFmMDUxZDNhZi9iOWE0NDFkOS01OGNiLTQ5MjYtOGEwZi05NzQ0ZGM4NzY4YWUvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTM2ODExMDAsImV4cCI6MTc5Mzc2NzUwMH0.Sclh6BIzsZOXvtz2UYjN44Hz0M_5PVv1KtULUebCxuU)

This helps identify:

* Peak usage times
* Quiet periods
* Daily patterns

## Interpreting the Data

### High Activity Areas

Hot spots (red/orange) indicate:

* Frequently occupied locations
* Primary seating or work areas
* High traffic pathways

**Action**: Ensure these areas have reliable zone coverage.

### Low Activity Areas

Cold spots (blue/purple) indicate:

* Rarely used spaces
* Possible detection blind spots
* Areas blocked by furniture

**Action**: Consider if these areas need zones, or if sensor repositioning would improve coverage.

### Traffic Patterns

Trails of moderate activity often show:

* Walking paths through the room
* Routes between entry points and seating
* Movement between activity zones

## Use Cases

### Optimizing Zone Placement


1. View heatmap for the past week
2. Identify where people actually spend time
3. Adjust zones to match real usage patterns
4. Remove zones from unused areas

### Identifying Dead Zones


1. Compare heatmap to expected room usage
2. Look for unexpectedly cold areas
3. Check if furniture or obstacles block detection
4. Consider repositioning the sensor

### Understanding Room Usage


1. View activity by time of day
2. Identify peak hours for different areas
3. Use insights for automation timing
4. Optimize lighting schedules based on actual patterns

### Debugging False Triggers


1. Look for unexpected hot spots
2. Check areas near windows or walls
3. Identify reflection or interference sources
4. Add exclusion zones where needed

## Data Collection

### How Data Is Collected

* Target positions are sampled periodically
* Position data is aggregated into grid cells
* Cell counts accumulate over time
* Data is stored locally in the add-on

### Data Retention

Heatmap data is retained based on the selected time period. Older data may be automatically pruned to manage storage.

### Privacy Note

All heatmap data stays local to your Home Assistant instance. No data is sent externally. The heatmap shows aggregate patterns, not individual tracking.

## Clearing Heatmap Data

To reset the heatmap and start fresh:


1. Open **Settings**
2. Find **Clear Heatmap Data**
3. Select the room to clear
4. Confirm the action

> **Note**: This permanently deletes historical presence data for the selected room.

## Tips for Better Heatmaps


1. **Let it collect data** - Heatmaps are most useful after several days of data
2. **Check multiple time ranges** - Daily vs weekly patterns may differ
3. **Compare before/after** - After moving zones or the sensor, compare heatmaps
4. **Use with Room Builder** - Overlay helps identify furniture-related blind spots

## Next Steps

* [Zone Editor](/doc/66bbf380-ac1f-408e-a58b-c878f72783f7) - Adjust zones based on heatmap insights
* [Room Builder](/doc/dae67af3-d87c-4acb-ba3f-4f85a802d40f) - Add furniture to understand coverage
* [Recording & Playback](/doc/d42d473d-5ef2-4a79-b7f8-1581374c0edd) - Debug specific tracking issues

---

**Documents**

- [EP1 vs EPL: Which Sensor is Right for You?](https://docs.everythingsmart.io/s/products/doc/ep1-vs-epl-which-sensor-is-right-for-you-5B3RxiY3Kp)
- [Everything Presence One (EP1)](https://docs.everythingsmart.io/s/products/doc/everything-presence-one-ep1-3R178yZSUP)
- [Everything Presence Pro](https://docs.everythingsmart.io/s/products/doc/everything-presence-pro-nh3fIXmow9)
- [Everything Presence Lite (EPL)](https://docs.everythingsmart.io/s/products/doc/everything-presence-lite-epl-ZVnBzYzuX2)
- [Zone Configurator](https://docs.everythingsmart.io/s/products/doc/zone-configurator-93b9scGsa2)
- [Knowledge Base Articles](https://docs.everythingsmart.io/s/products/doc/knowledge-base-articles-KnRRmk4zvt)