Awesome
<div align="center"> <img src="man/figures/logo.png" height="200"/>openair
open source tools for air quality data analysis
<!-- badges: start --> <!-- badges: end --> </div>openair is an R package developed for the purpose of analysing air quality data — or more generally atmospheric composition data. The package is extensively used in academia, the public and private sectors. The project was initially funded by the UK Natural Environment Research Council (NERC), with additional funds from the UK Department for Environment Food & Rural Affairs (Defra).
<div align="center">Part of the openair toolkit
</div> <hr>💡 Core Features
openair has developed over many years to form an extensive toolkit of functions for analysing air quality and atmospheric composition data.
-
Access to data from several hundred UK air pollution monitoring sites through the
importUKAQ()
family of functions. -
Time Series & Trend analysis to explore how air quality concentrations vary over time (e.g., through
timePlot()
,timeVariation()
, andcalendarPlot()
). -
Directional analysis to help characterise different sources of pollution, including the creation of bivariate polar plots using
polarPlot()
. -
Trajectory analysis to examine NOAA Hysplit trajectories, with plotting (
trajPlot()
), heatmap (trajLevel()
) and clustering (trajCluster()
) functionality. -
Utility functions, such as
timeAverage()
andselectByDate()
to make it easier to manipulate atmospheric composition data. -
Flexible plot conditioning to easily plot data by hour or the day, day of the week, season of the year, etc., through the
type
option available in most functions.
📖 Documentation
All openair functions are fully documented; access documentation using R in your IDE of choice.
?openair::polarPlot
Documentation is also hosted online on the package website.
A guide to the openair toolkit can be found in the online book, which contains lots of code snippets, demonstrations of functionality, and ideas for the application of openair's various functions.
<hr>🗃️ Installation
openair can be installed from CRAN with:
install.packages("openair")
You can also install the development version of openair from GitHub using {pak}
:
# install.packages("pak")
pak::pak("davidcarslaw/openair")
<hr>
🏛️ openair is primarily maintained by David Carslaw.
📃 openair is licensed under the GNU General Public License.
🧑💻 Contributions are welcome from the wider community. See the contributing guide and code of conduct for more information.