Agent reference
Atmospheric agents
Every agent the BXP schema defines, with its canonical unit and the WHO guideline value it is measured against.
Extending the schema
The agent list is not closed. A deployment may carry additional agents under the
ext namespace without changing the major version, and existing
implementations must ignore-and-preserve fields they do not recognise. A new
natively specified agent requires an RFC.Units
The canonical unit for an agent is fixed by this table. Every reading states
its own unit, and implementations normalise to the canonical form
during the INTERPRET stage. A reading whose unit cannot be converted is rejected
rather than guessed at.
Complete reference
| Agent ID | Full Name | Category | Unit | WHO Limit |
|---|---|---|---|---|
| PM1 | Particulate Matter <1μm | Particulates | μg/m³ | — |
| PM2_5 | Particulate Matter <2.5μm | Particulates | μg/m³ | 5 annual |
| PM10 | Particulate Matter <10μm | Particulates | μg/m³ | 15 annual |
| BC | Black Carbon | Particulates | μg/m³ | — |
| CO | Carbon Monoxide | Gas | ppm | 4 mg/m³ 24h |
| CO2 | Carbon Dioxide | Gas | ppm | 1000 indoor |
| NO2 | Nitrogen Dioxide | Gas | ppb | 10 μg/m³ annual |
| NO | Nitric Oxide | Gas | ppb | — |
| SO2 | Sulphur Dioxide | Gas | ppb | 40 μg/m³ 24h |
| O3 | Ground-level Ozone | Gas | ppb | 100 μg/m³ 8h |
| H2S | Hydrogen Sulphide | Gas | ppb | 7 ppb |
| NH3 | Ammonia | Gas | ppm | 25 ppm |
| TVOC | Total VOC | VOC | ppb | 500 ppb |
| BENZ | Benzene | VOC | ppb | No safe level |
| FORM | Formaldehyde | VOC | ppb | 8 ppb |
| TOLU | Toluene | VOC | ppm | 50 ppm |
| XYLE | Xylene | VOC | ppm | 100 ppm |
| NAPH | Naphthalene | VOC | ppb | 9.4 ppb |
| MOLD_S | Mold Spores | Biological | spores/m³ | 500 indoor |
| POLL_G | Grass Pollen | Biological | grains/m³ | 50 moderate |
| POLL_T | Tree Pollen | Biological | grains/m³ | 100 high |
| BACT_T | Total Airborne Bacteria | Biological | CFU/m³ | 500 indoor |
| DUST_M | Dust Mite Allergen | Biological | ng/m³ | 2 ng/m³ |
| PB | Lead | Heavy Metal | μg/m³ | 0.5 annual |
| HG | Mercury | Heavy Metal | μg/m³ | 1 annual |
| AS | Arsenic | Heavy Metal | ng/m³ | 6.6 annual |
| TEMP | Temperature | Environmental | °C | — |
| RH | Relative Humidity | Environmental | % | — |
| PRESS | Atmospheric Pressure | Environmental | hPa | — |
| UV | UV Index | Environmental | index | — |
| AQI_US | US Air Quality Index | Derived | 0–500 | — |
| BXP_HRI_EXP | BXP Health Risk Index (experimental) | Derived | 0–100 | — |
Which agents feed BXP-HRI
Only the eight weighted agents contribute to the composite health risk index: PM2.5, PM10, NO₂, O₃, CO, SO₂, and TVOC, with weights derived from WHO disability-adjusted life-year burden data. Other agents are carried in the record and are available to applications, but they do not move the index.
BXP-HRI is experimental
It is not clinically or epidemiologically validated and must not be used for
medical decisions, diagnosis, or clinical guidance.
Generated from Appendix A of the specification. Errors in either are worth reporting.