Data

Tools

Indexes

Applications

Experiments

Open Source Science

openair

🧭 Open source tools for air quality data analysis

https://github.com/openair-project/openair

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ✓
    Committers with academic emails
    3 of 16 committers (18.8%) from academic institutions
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (13.9%) to scientific vocabulary

Keywords

air-quality air-quality-data meteorology openair package r
Last synced: 6 months ago · JSON representation

Repository

🧭 Open source tools for air quality data analysis

Basic Info
Statistics
  • Stars: 329
  • Watchers: 38
  • Forks: 122
  • Open Issues: 70
  • Releases: 1
Topics
air-quality air-quality-data meteorology openair package r
Created about 11 years ago · Last pushed 6 months ago
Metadata Files
Readme Changelog Contributing License Code of conduct

README.md

## **openair** ### open source tools for air quality data analysis [![R-CMD-check](https://github.com/openair-project/openair/workflows/R-CMD-check/badge.svg)](https://github.com/openair-project/openair/actions) [![CRAN status](https://www.r-pkg.org/badges/version/openair)](https://CRAN.R-project.org/package=openair) [![metacran downloads](https://cranlogs.r-pkg.org/badges/grand-total/openair)](https://cran.r-project.org/package=openair)
[![github](https://img.shields.io/badge/CODE-github-black?logo=github)](https://github.com/openair-project/openair) [![website](https://img.shields.io/badge/DOCS-website-black)](https://openair-project.github.io/openair/) [![book](https://img.shields.io/badge/DOCS-book-black)](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), with additional funds from the UK Department for Environment Food & Rural Affairs (Defra).

*Part of the openair toolkit* [![openair](https://img.shields.io/badge/openair_core-06D6A0?style=flat-square)](https://openair-project.github.io/openair/) | [![worldmet](https://img.shields.io/badge/worldmet-26547C?style=flat-square)](https://openair-project.github.io/worldmet/) | [![openairmaps](https://img.shields.io/badge/openairmaps-FFD166?style=flat-square)](https://openair-project.github.io/openairmaps/) | [![deweather](https://img.shields.io/badge/deweather-EF476F?style=flat-square)](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.

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.

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.

📃 openair is licensed under the MIT License.

🧑‍💻 Contributions are welcome from the wider community. See the contributing guide and code of conduct for more information.

Owner

  • Name: The Openair Project
  • Login: openair-project
  • Kind: organization

Open Source Tools for Air Quality Data Analysis

GitHub Events

Total
  • Create event: 33
  • Release event: 1
  • Issues event: 33
  • Watch event: 20
  • Delete event: 17
  • Issue comment event: 27
  • Push event: 180
  • Pull request review event: 3
  • Pull request review comment event: 1
  • Pull request event: 36
  • Fork event: 6
Last Year
  • Create event: 33
  • Release event: 1
  • Issues event: 33
  • Watch event: 20
  • Delete event: 17
  • Issue comment event: 27
  • Push event: 180
  • Pull request review event: 3
  • Pull request review comment event: 1
  • Pull request event: 36
  • Fork event: 6

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 1,401
  • Total Committers: 16
  • Avg Commits per committer: 87.563
  • Development Distribution Score (DDS): 0.392
Past Year
  • Commits: 175
  • Committers: 3
  • Avg Commits per committer: 58.333
  • Development Distribution Score (DDS): 0.074
Top Committers
Name Email Commits
davidcarslaw d****w@y****k 852
jack-davison d****d@g****m 348
DCCKC d****w@k****k 170
Jack Davison j****n@r****m 11
David Carslaw d****d@d****e 4
karlropkins k****s@i****k 3
Jerry Martin A****t 2
jobonaf m****e@g****m 2
skgrange s****e@g****m 2
Claudia Vitolo c****o@g****m 1
Danielle Dempsey d****y@p****a 1
Gertjan van den Burg g****g@g****m 1
Manning Young m****g@g****m 1
Panda Rushwood p****a@e****g 1
Wu H****u@r****m 1
skgrange s****e@g****m 1
Committer Domains (Top 20 + Academic)
ricardo.com: 2 energyandcleanair.org: 1 perennia.ca: 1 its.leeds.ac.uk: 1 david-linux.home: 1 kcl.ac.uk: 1 york.ac.uk: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 219
  • Total pull requests: 57
  • Average time to close issues: over 2 years
  • Average time to close pull requests: about 1 month
  • Total issue authors: 130
  • Total pull request authors: 8
  • Average comments per issue: 2.42
  • Average comments per pull request: 0.56
  • Merged pull requests: 44
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 29
  • Pull requests: 41
  • Average time to close issues: 22 days
  • Average time to close pull requests: about 1 month
  • Issue authors: 12
  • Pull request authors: 3
  • Average comments per issue: 0.52
  • Average comments per pull request: 0.46
  • Merged pull requests: 33
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
  • jack-davison (25)
  • lyggd (16)
  • davidcarslaw (5)
  • JulioCM (5)
  • mooibroekd (5)
  • Anuragsahucuraj (4)
  • optimsari (4)
  • ClauGro (4)
  • jobonaf (4)
  • dpinxter (3)
  • MohoWu (3)
  • MatthiasKetzel (3)
  • rs028 (3)
  • AlanMcDonaldSEPA (3)
  • e-larry (2)
Pull Request Authors
  • jack-davison (47)
  • skgrange (2)
  • TickleThePanda (2)
  • davidcarslaw (2)
  • anxorl (1)
  • marcelooyaneder (1)
  • cvitolo (1)
  • MaggieAlx (1)
Top Labels
Issue Labels
question (38) bug (34) hysplit 🌐 (31) enhancement (30) trends 📉 (21) directional 🧭 (15) utilities 🛠 (10) data 🗃 (6) models 📊 (5) refactor (1)
Pull Request Labels
enhancement (28) utilities 🛠 (18) data 🗃 (9) refactor (9) directional 🧭 (4) bug (2) trends 📉 (2)

Packages

  • Total packages: 1
  • Total downloads:
    • cran 7,079 last-month
  • Total docker downloads: 132,056
  • Total dependent packages: 18
  • Total dependent repositories: 51
  • Total versions: 79
  • Total maintainers: 1
cran.r-project.org: openair

Tools for the Analysis of Air Pollution Data

  • Versions: 79
  • Dependent Packages: 18
  • Dependent Repositories: 51
  • Downloads: 7,079 Last month
  • Docker Downloads: 132,056
Rankings
Forks count: 0.6%
Stargazers count: 1.5%
Average: 3.1%
Dependent repos count: 3.5%
Dependent packages count: 3.6%
Downloads: 6.4%
Maintainers (1)
david.carslaw@york.ac.uk
Last synced: 6 months ago

Dependencies

DESCRIPTION cran
  • R >= 3.2.0 depends
  • MASS * imports
  • Rcpp * imports
  • cluster * imports
  • dplyr >= 1.0 imports
  • grDevices * imports
  • graphics * imports
  • grid * imports
  • hexbin * imports
  • lattice * imports
  • latticeExtra * imports
  • lubridate * imports
  • mapproj * imports
  • methods * imports
  • mgcv * imports
  • purrr * imports
  • readr * imports
  • stats * imports
  • tidyr * imports
  • utils * imports
  • KernSmooth * suggests
  • mapdata * suggests
  • maps * suggests
  • quantreg * suggests
.github/workflows/R-CMD-check.yaml actions
  • actions/checkout v2 composite
  • r-lib/actions/setup-r v1 composite
.github/workflows/pkgdown.yaml actions
  • JamesIves/github-pages-deploy-action v4.4.1 composite
  • actions/checkout v3 composite
  • r-lib/actions/setup-pandoc v2 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-r-dependencies v2 composite