AirMonitor
Utilities for working with air quality monitoring data
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
Links to: zenodo.org -
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (15.1%) to scientific vocabulary
Repository
Utilities for working with air quality monitoring data
Basic Info
- Host: GitHub
- Owner: MazamaScience
- License: gpl-3.0
- Language: HTML
- Default Branch: main
- Homepage: https://MazamaScience.github.io/AirMonitor
- Size: 16.9 MB
Statistics
- Stars: 7
- Watchers: 2
- Forks: 1
- Open Issues: 1
- Releases: 21
Metadata Files
README.md
<!-- badges: end -->
A dedicated Slack channel has been created for announcements, support and to help build a community of practice around this open source package. You may request an invitation to join from jonathan.callahan@dri.com.
AirMonitor
Utilities for working with hourly air quality monitoring data
with a focus on small particulates (PM2.5). A compact data model is
structured as a list with two dataframes. A 'meta' dataframe contains
spatial and measuring device metadata associated with deployments at known
locations. A 'data' dataframe contains a 'datetime' column followed by
columns of measurements associated with each "device-deployment".
Background
The USFS AirFire group works with air quality measurements associated with wildfire smoke and maintains both historical and real-time databases of PM2.5 monitoring data obtained from stationary monitors. This data is used in operational displays and for retrospective analysis. Data ingest and management of air quality “stationary time series” are important ongoing activities.
Related Packages
The AirMonitor package contains data access functions to easily download harmonized data files as well as data manipulation functions that make it easy to create "recipe style" analysis pipelines. This combination allows analysts to work efficiently with short, readable R scripts. Interactive and base R plotting functions allow for visual review of the data.
The AirMonitorPlots package contains ggplot2 based plotting functions for advanced plots.
Installation
Install from CRAN with:
install.packages('AirMonitor')
Install the latest version from GitHub with:
devtools::install_github('mazamascience/AirMonitor')
Data Model
The AirMonitor package uses the mts data model defined in MazamaTimeSeries.
In this data model, each unique time series is referred to as a "device-deployment" -- a timeseries collected by a particular device at a specific location. Multiple device-deployments are stored in memory as a monitor object -- an R list with two dataframes:
monitor$meta -- rows = unique device-deployments; cols = device/location metadata
monitor$data -- rows = UTC times; cols = device-deployments (plus an additional datetime column)
A key feature of this data model is the use of the deviceDeploymentID as a
"foreign key" that allows data columns to be mapped onto the associated
spatial and device metadata in a meta row. The following will always be true:
identical(names(monitor$data), c('datetime', monitor$meta$deviceDeploymentID))
Each column of monitor$data represents a timeseries associated with a particular
ID while each row of monitor$data represents a synoptic snapshot of all
measurements made at a particular time.
In this manner, both timeseries plots and maps can be created from a single
monitor object in memory.
Note: The monitor object time axis specified in data$datetime is
guaranteed to be a regular hourly axis with no gaps.
This project is supported by the USFS AirFire team.
Owner
- Name: Mazama Science
- Login: MazamaScience
- Kind: organization
- Email: info@mazamascience.com
- Location: Seattle, WA
- Website: mazamascience.com
- Repositories: 15
- Profile: https://github.com/MazamaScience
SEE YOUR DATA
GitHub Events
Total
- Release event: 1
- Watch event: 2
- Push event: 7
- Create event: 3
Last Year
- Release event: 1
- Watch event: 2
- Push event: 7
- Create event: 3
Committers
Last synced: 11 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Jonathan Callahan | j****n@g****m | 125 |
| Jonathan Callahan | j****n@S****l | 2 |
Issues and Pull Requests
Last synced: 11 months ago
All Time
- Total issues: 6
- Total pull requests: 0
- Average time to close issues: 5 months
- Average time to close pull requests: N/A
- Total issue authors: 1
- Total pull request authors: 0
- Average comments per issue: 0.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- jonathancallahan (6)
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- cran 637 last-month
- Total dependent packages: 0
- Total dependent repositories: 1
- Total versions: 7
- Total maintainers: 1
cran.r-project.org: AirMonitor
Air Quality Data Analysis
- Homepage: https://github.com/MazamaScience/AirMonitor
- Documentation: http://cran.r-project.org/web/packages/AirMonitor/AirMonitor.pdf
- License: GPL-3
-
Latest release: 0.4.3
published about 1 year ago
Rankings
Maintainers (1)
Dependencies
- R >= 4.0.0 depends
- MazamaCoreUtils >= 0.4.13 imports
- MazamaRollUtils >= 0.1.3 imports
- MazamaTimeSeries >= 0.2.10 imports
- dplyr * imports
- dygraphs * imports
- leaflet * imports
- lubridate * imports
- magrittr * imports
- readr * imports
- rlang >= 1.0.0 imports
- stringr * imports
- tidyselect * imports
- xts * imports
- knitr * suggests
- markdown * suggests
- rmarkdown * suggests
- roxygen2 * suggests
- testthat * suggests
- rocker/geospatial 4.2.3 build