The openair project

R
openair
software
Open-source tools for air quality data analysis in R, used by thousands of researchers worldwide
Published

June 20, 2026

Many of the receptor modelling and time series approaches we develop are made available through open-source software called openair. The project began as a knowledge exchange initiative funded by the Natural Environment Research Council (NERC), with subsequent support from the Department for Environment, Food & Rural Affairs (Defra). Its aim is to put innovative, well-documented analysis techniques for air pollution and wider atmospheric composition data into the hands of as many researchers as possible. openair is written in the R programming language and is openly and freely available to anyone.

Since the original 2012 publication, openair has grown from a single package into a coordinated family of complementary tools, developed and maintained by David Carslaw together with Jack Davison. Together these give researchers a reproducible, end-to-end workflow — from importing data through to source characterisation, trend detection, and the robust quantification of intervention effects.

The package is used extensively throughout the world across academia and the public and private sectors. The original software paper has been cited well over 2,000 times, and the core package alone has been downloaded more than 650,000 times from CRAN, making it one of the most widely used tools in air quality science. Comprehensive documentation, worked examples, and guidance are maintained in the freely available openair book.


The package family

The openair project (github.com/openair-project) currently comprises four main packages:

openair

The core package provides trend and time series analysis, directional analysis tools including bivariate polar plots and conditional probability functions, temporal component extraction,wind and pollution roses, calendar plots, back-trajectory analysis, and model evaluation methods. It includes direct import of data from several hundred UK air quality monitoring sites and international networks.

GitHub Documentation

openairmaps

Provides interactive and publication-quality mapping of air quality data, including network maps, directional analysis maps (polar plots on a map background), and trajectory frequency maps. Built on {leaflet} and {ggplot2}, it makes it straightforward to place openair-style analyses in geographic context.

GitHub Documentation

worldmet

Provides ready access to global surface meteorological observations from the NOAA Global Historical Climatology Network (GHCN) — tens of thousands of sites worldwide. Meteorological data (wind speed and direction, temperature, humidity, and more) are essential for most openair analyses, and worldmet makes importing them straightforward for any location and time period.

GitHub Documentation

deweather

Implements machine-learning-based meteorological normalisation to remove the influence of weather variability from atmospheric composition time series. This allows underlying emission trends and the effect of policy interventions to be isolated from the noise introduced by year-to-year meteorological variation.

GitHub Documentation


Examples

Example bivariate polar plots showing wind-direction-dependent source contributions.

Calculation of a Whittaker-Eilers baseline.

Resources