> For the complete documentation index, see [llms.txt](https://support.meetuma.ai/uma-knowledgebase/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.meetuma.ai/uma-knowledgebase/data-and-reporting/analytics-pro/dashboard/air-quality-and-co2.md).

# Air Quality & Co2

<figure><img src="/files/VuSQ0zbsiixMoWhgKltQ" alt=""><figcaption></figcaption></figure>

### Overview

The Air Quality and CO2 dashboard tracks two complementary indoor-air metrics: **CO₂ concentration** (a proxy for ventilation effectiveness and occupant alertness) and the **Air Quality Index / TVOC** (volatile organic compounds and general air quality). Both are measured continuously by your sensors and graded against established health thresholds.

Use this dashboard to:

* Monitor ventilation effectiveness and indoor-air health
* Identify rooms where occupants are likely to experience drowsiness or headaches
* Provide evidence for HVAC tuning and ventilation upgrades
* Demonstrate environmental commitment to staff and visitors

***

### Scoring Bands

#### CO₂ (ppm)

| Band         | Range        | Meaning                                                            |
| ------------ | ------------ | ------------------------------------------------------------------ |
| 🟢 Excellent | < 800 ppm    | Fresh air; full cognitive performance                              |
| 🟡 OK        | 800–1200 ppm | Acceptable; cognitive performance begins to decline above 1000 ppm |
| 🔴 Poor      | ≥ 1200 ppm   | Drowsiness, headaches, reduced concentration                       |

#### Air Quality Index (TVOC)

| Band         | Range | Meaning                                |
| ------------ | ----- | -------------------------------------- |
| 🟢 Excellent | < 0.3 | Clean air                              |
| 🟢 Good      | 0.3–1 | Minor pollutants, no concern           |
| 🟡 OK        | 1–3   | Noticeable; ventilate                  |
| 🟠 Poor      | 3–10  | Headaches and irritation likely        |
| 🔴 Bad       | ≥ 10  | Health risk; immediate action required |

***

### Dashboard Structure

The dashboard is organised into four tabs:

1. **Monitoring**
2. **Data**
3. **Map**
4. **Floor Heatmap**

A metric switcher toggles every chart between **Air Quality** and **CO₂**.

***

### Tab 1 — Monitoring

#### Air Quality Trend

<figure><img src="/files/jaj4p0IdGIFu2Rt8jvgY" alt=""><figcaption></figcaption></figure>

*Line chart with Daily / Weekly granularity tabs.*

Air Quality Index over time, with coloured background bands marking the Excellent / Good / OK / Poor / Bad zones.

#### Average Air Quality by Resource

<figure><img src="/files/czkvaL2BMJZJi50zVV9W" alt=""><figcaption></figcaption></figure>

*Horizontal bar chart, ranked.*

Each resource ranked by its average reading, colour-coded by the band the average falls into.

#### Average Air Quality by Weekday

<figure><img src="/files/xqYuNWXJftuiX9zo5yJd" alt=""><figcaption></figcaption></figure>

*Bar chart.*

Air quality averages per day of the week.

#### CO₂ Trend

<figure><img src="/files/sGXesIsRMhn9Ak3yg1fa" alt=""><figcaption></figcaption></figure>

*Line chart with Daily / Weekly granularity tabs.*

CO₂ concentration (ppm) over time, with background bands at 800 and 1200 ppm.

#### Average CO₂ by Resource

<figure><img src="/files/LFwPt4Zny1rkjr4XNocF" alt=""><figcaption></figcaption></figure>

*Horizontal bar chart, ranked.*

Resources ranked by average CO₂ concentration, colour-coded by band.

*Use it to:* find the rooms whose ventilation is most likely overloaded.

#### Average CO₂ by Weekday

<figure><img src="/files/ZfxAoyDOHBByft45fHab" alt=""><figcaption></figcaption></figure>

*Bar chart.*

CO₂ averages per day of the week.

*Use it to:* validate ventilation behaviour at peak attendance days.

***

### Tab 2 — Data

#### Air Quality Data Table

<figure><img src="/files/cYUK7b6gyhHAWrnct0lI" alt=""><figcaption></figcaption></figure>

*Sortable data grid.*

Minimum, maximum, and average Air Quality Index readings per resource with timestamps.

#### CO₂ Data Table

<figure><img src="/files/dObm0l38LZkKYcOUQX8F" alt=""><figcaption></figcaption></figure>

*Sortable data grid.*

Minimum, maximum, and average CO₂ readings (ppm) per resource.

Both tables support CSV export.

***

### Tab 3 — Map

#### Sensor Map View

<figure><img src="/files/NeMk8UqFnJ9s8NK1dNyJ" alt=""><figcaption></figcaption></figure>

*Interactive geographic map.*

Buildings plotted on a world map, colour-coded by overall air-quality status.

***

### Tab 4 — Floor Heatmap

#### Air Quality Floor Heatmap

<figure><img src="/files/imJgHaPT5zcvfypaAVwy" alt=""><figcaption></figcaption></figure>

*Colour-coded overlay on an interactive 2D floor plan.*

Each monitored resource is shown as a heat point coloured by its current band, allowing you to see at a glance which areas of the floor have ventilation issues.

***

### Filters & Controls

* Building, Floor, Resource, Resource Type
* Date range with presets and custom ranges
* Granularity tabs on trend charts
* Metric switcher: Air Quality / CO₂

***

### Tips

* CO₂ tracks occupancy closely — a room with high CO₂ at low occupancy indicates a real ventilation issue, not a busy room.
* Compare CO₂ peaks against the Reservation Sensor Insights tab in Space Usage to identify specific meetings during which conditions degraded.

### Overview

The Air Quality and CO2 dashboard tracks two complementary indoor-air metrics: **CO₂ concentration** (a proxy for ventilation effectiveness and occupant alertness) and the **Air Quality Index / TVOC** (volatile organic compounds and general air quality). Both are measured continuously by your sensors and graded against established health thresholds.

Use this dashboard to:

* Monitor ventilation effectiveness and indoor-air health
* Identify rooms where occupants are likely to experience drowsiness or headaches
* Provide evidence for HVAC tuning and ventilation upgrades
* Demonstrate environmental commitment to staff and visitors

***

### Scoring Bands

#### CO₂ (ppm)

| Band         | Range        | Meaning                                                            |
| ------------ | ------------ | ------------------------------------------------------------------ |
| 🟢 Excellent | < 800 ppm    | Fresh air; full cognitive performance                              |
| 🟡 OK        | 800–1200 ppm | Acceptable; cognitive performance begins to decline above 1000 ppm |
| 🔴 Poor      | ≥ 1200 ppm   | Drowsiness, headaches, reduced concentration                       |

#### Air Quality Index (TVOC)

| Band         | Range | Meaning                                |
| ------------ | ----- | -------------------------------------- |
| 🟢 Excellent | < 0.3 | Clean air                              |
| 🟢 Good      | 0.3–1 | Minor pollutants, no concern           |
| 🟡 OK        | 1–3   | Noticeable; ventilate                  |
| 🟠 Poor      | 3–10  | Headaches and irritation likely        |
| 🔴 Bad       | ≥ 10  | Health risk; immediate action required |

***

### Dashboard Structure

The dashboard is organised into four tabs:

1. **Monitoring**
2. **Data**
3. **Map**
4. **Floor Heatmap**

A metric switcher toggles every chart between **Air Quality** and **CO₂**.

***

### Tab 1 — Monitoring

#### Air Quality Trend

*Line chart with Daily / Weekly granularity tabs.*

Air Quality Index over time, with coloured background bands marking the Excellent / Good / OK / Poor / Bad zones.

#### Average Air Quality by Resource

*Horizontal bar chart, ranked.*

Each resource ranked by its average reading, colour-coded by the band the average falls into.

#### Average Air Quality by Weekday

*Bar chart.*

Air quality averages per day of the week.

#### CO₂ Trend

*Line chart with Daily / Weekly granularity tabs.*

CO₂ concentration (ppm) over time, with background bands at 800 and 1200 ppm.

#### Average CO₂ by Resource

*Horizontal bar chart, ranked.*

Resources ranked by average CO₂ concentration, colour-coded by band.

*Use it to:* find the rooms whose ventilation is most likely overloaded.

#### Average CO₂ by Weekday

*Bar chart.*

CO₂ averages per day of the week.

*Use it to:* validate ventilation behaviour at peak attendance days.

***

### Tab 2 — Data

#### Air Quality Data Table

*Sortable data grid.*

Minimum, maximum, and average Air Quality Index readings per resource with timestamps.

#### CO₂ Data Table

*Sortable data grid.*

Minimum, maximum, and average CO₂ readings (ppm) per resource.

Both tables support CSV, JSON, and PDF export.

***

### Tab 3 — Map

#### Sensor Map View

*Interactive geographic map.*

Buildings plotted on a world map, colour-coded by overall air-quality status.

***

### Tab 4 — Floor Heatmap

#### Air Quality Floor Heatmap

*Colour-coded overlay on an interactive 2D floor plan.*

Each monitored resource is shown as a heat point coloured by its current band, allowing you to see at a glance which areas of the floor have ventilation issues.

***

### Filters & Controls

* Building, Floor, Resource, Resource Type
* Date range with presets and custom ranges
* Granularity tabs on trend charts
* Metric switcher: Air Quality / CO₂

***

### Tips

* CO₂ tracks occupancy closely — a room with high CO₂ at low occupancy indicates a real ventilation issue, not a busy room.
* Compare CO₂ peaks against the Reservation Sensor Insights tab in Space Usage to identify specific meetings during which conditions degraded.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://support.meetuma.ai/uma-knowledgebase/data-and-reporting/analytics-pro/dashboard/air-quality-and-co2.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.