https://github.com/openair-project/openair
🧭 Open source tools for air quality data analysis
https://github.com/openair-project/openair
air-quality air-quality-data meteorology openair package r
Last synced: 6 months ago
JSON representation
🧭 Open source tools for air quality data analysis
- Host: GitHub
- URL: https://github.com/openair-project/openair
- Owner: openair-project
- License: other
- Created: 2015-01-15T16:00:35.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2025-01-14T09:05:20.000Z (9 months ago)
- Last Synced: 2025-01-15T00:16:48.859Z (9 months ago)
- Topics: air-quality, air-quality-data, meteorology, openair, package, r
- Language: R
- Homepage: https://openair-project.github.io/openair/
- Size: 66.3 MB
- Stars: 308
- Watchers: 40
- Forks: 116
- Open Issues: 67
-
Metadata Files:
- Readme: README.md
- Changelog: NEWS.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
## **openair**
### open source tools for air quality data analysis
[](https://github.com/openair-project/openair/actions)
[](https://CRAN.R-project.org/package=openair)
[](https://cran.r-project.org/package=openair)
[](https://github.com/openair-project/openair)
[](https://openair-project.github.io/openair/)
[](https://openair-project.github.io/book/)
**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](https://www.ukri.org/councils/nerc/)), with additional funds from the UK Department for Environment Food & Rural Affairs ([Defra](https://www.gov.uk/government/organisations/department-for-environment-food-rural-affairs)).
*Part of the openair toolkit*
[](https://openair-project.github.io/openair/) |
[](https://openair-project.github.io/worldmet/) |
[](https://openair-project.github.io/openairmaps/) |
[](https://openair-project.github.io/deweather/)
## 💡 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()`, and `calendarPlot()`).
- **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()` and `selectByDate()` 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.
```r
?openair::polarPlot
```
Documentation is also hosted online on the **package website**.
[](https://openair-project.github.io/openair/)
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.
[](https://openair-project.github.io/book/)
## 🗃️ Installation
**openair** can be installed from **CRAN** with:
``` r
install.packages("openair")
```
You can also install the development version of **openair** from GitHub using `{pak}`:
``` r
# install.packages("pak")
pak::pak("openair-project/openair")
```
🏛️ **openair** is primarily maintained by [David Carslaw](https://github.com/davidcarslaw).
📃 **openair** is licensed under the [MIT License](https://openair-project.github.io/openair/LICENSE.html).
🧑💻 Contributions are welcome from the wider community. See the [contributing guide](https://openair-project.github.io/openair/CONTRIBUTING.html) and [code of conduct](https://openair-project.github.io/openair/CODE_OF_CONDUCT.html) for more information.