Data

BXP sample dataset

Ten atmospheric exposure records in the BXP format, covering different agent combinations and quality flags. Published so integrators have concrete input to test against, and so the format is legible to people who work from data rather than from specifications.

These are not measurements Every record carries source: "simulated" and quality.flag: "UNVALIDATED". They exist to demonstrate the record structure. Do not use them for analysis, reporting, or any health decision. The classification is not decoration: SPEC.md 6.8 requires that provenance travel with the data, and a demonstration fixture presented as observational data is exactly what that rule exists to prevent.

Download

File	Format	Records	Size
`sample_readings.bxp.json`	BXP JSON (application/json)	10	15,406 B
Repository copy	BXP JSON	10	—

Machine-readable metadata for this dataset is published separately as dataset.json (schema.org Dataset), which is what data catalogues and harvesters read.

Use it with the validator to confirm your own records parse, or with the Python SDK:

from bxp_sdk import read_bxp
doc = read_bxp("sample_readings.bxp.json")   # keys ending _ are verification helpers

Geohash	Coordinates	Agents	HRI	Quality
s1v0g	5.6037, -0.187	PM2_5, PM10, NO2, O3, TEMP, RH	61.2	UNVALIDATED
s172h	6.5244, 3.3792	PM2_5, PM10, NO2, O3, TEMP, RH	79.8	UNVALIDATED
ttneq	28.6139, 77.209	PM2_5, PM10, NO2, O3, TEMP, RH	100.0	UNVALIDATED
wx4g0	39.9042, 116.4074	PM2_5, PM10, NO2, O3, TEMP, RH	94.2	UNVALIDATED
gcpvh	51.5074, -0.1278	PM2_5, PM10, NO2, O3, TEMP, RH	38.4	UNVALIDATED
6gyf4	-23.5505, -46.6333	PM2_5, PM10, NO2, O3, TEMP, RH	62.7	UNVALIDATED
dr5re	40.7128, -74.006	PM2_5, PM10, NO2, O3, TEMP, RH	29.1	UNVALIDATED
kznfu	-1.2921, 36.8219	PM2_5, PM10, NO2, O3, TEMP, RH	51.4	UNVALIDATED
qqgx4	-6.2088, 106.8456	PM2_5, PM10, NO2, O3, TEMP, RH	82.1	UNVALIDATED
stq4q	30.0444, 31.2357	PM2_5, PM10, NO2, O3, TEMP, RH	97.3	UNVALIDATED

Agents present

Agents marked HRI contribute to the composite index; the others are carried in the record and available to applications.

Agent ID	Unit	HRI	Records
NO2	ppb	yes	10
O3	ppb	yes	10
PM10	ug/m3	yes	10
PM2_5	ug/m3	yes	10
RH	%	no	10
TEMP	C	no	10

Record structure

The first record, abbreviated:

Field	Value
bxpVersion	2.0
source	simulated
deviceUuid	00000000-0000-0000-0000-000000000001
geohash	s1v0g
latitude	5.6037
longitude	-0.187
timestampUs	1741342800000000
durationS	600
indoorOutdoor	outdoor
agents	list (6)
context	dict (3)
quality	dict (4)
bxpHri	61.2
bxpHriLevel	HIGH

Field dictionary

Agent identifiers used in this dataset, with their full names from Appendix A of the specification. The complete reference for all 31 agents is on the agent reference page.

Agent ID	Name
PM2_5	Fine Particulate Matter <2.5μm
PM10	Coarse Particulate Matter <10μm
NO2	Nitrogen Dioxide
O3	Ground-level Ozone
TEMP	Temperature
RH	Relative Humidity
PM10	0.15
NO2	0.15
O3	0.12
PM2_5	Particulate Matter <2.5μm
PM10	Particulate Matter <10μm
NO2	Nitrogen Dioxide
O3	Ground-level Ozone
TEMP	Temperature
RH	Relative Humidity

Converting from other formats

If your data is not already in BXP, start from the integration guide rather than hand-mapping fields:

OpenAQ v3 importer — included in the repository, converts OpenAQ locations and measurements to valid BXP records while preserving source provenance.
MQTT bridge — subscribes to a broker topic and emits BXP records, for live sensor output.
Postman collection — ready-to-use requests against any BXP node.

Licence and citation

The dataset is released under Apache 2.0, the same licence as the specification. Cite it via the specification DOI:

doi:10.5281/zenodo.18906812

Full citation formats are on the versions and citation page.