In ASRCsoft/atmoschem.datasets: ASRC Atmospheric Chemistry Data Processing

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-"
)

ASRC Atmospheric Chemistry Data Processing

knitr::include_graphics('man/figures/whiteface-station.jpg')

The atmoschem.process R package processes atmospheric chemistry data from ASRC sites in New York State. It provides tools to generate reports and processed datasets from the ASRC's atmospheric chemistry data, and tools to visualize the data.

Table of contents

readme = readLines('README.Rmd')
headers = readme[grepl('^## ', readme)][-1] # remove first header (toc)
titles = sub('^## ', '', headers)
links = paste0('#', gsub(' ', '-', tolower(titles)))
md_lines = paste0('- [', titles, '](', links, ')')
cat(paste(md_lines, collapse = '\n'))

Overview

The atmospheric chemistry group at the ASRC, run by Dr. Jim Schwab, collects data from instruments at 4 sites across the state of New York: Whiteface Mountain (summit and base), Pinnacle State Park, and Queens College. We maintain a variety of instruments measuring ozone and ozone precursors, airborne particulate matter, sulfur dioxide, and meteorology.

The data undergoes a variety of adjustments and quality assurance checks before being released to the public, where it is used by government agencies and atmospheric science researchers, among others. Users can access the datasets online via our website at http://atmoschem.asrc.cestm.albany.edu/.

This software, which generates the processed datasets, synthesizes advice from atmospheric monitoring, statistical programming, and data management. In terms of data processing, we tend to follow guidelines from NARSTO [@christensen_narsto_2000], and we also work regularly with EPA standards. The code is organized as an R package [@marwick_packaging_2018], and we use GitHub for project management [@bryan_excuse_2018]. For data management, we tend to follow @briney_data_2015, and we try to make the data convenient to use [@white_nine_2013].

The data collection at Whiteface Mountain is described in detail in a series of publications [@schwab_atmospheric_2016; @brandt_atmospheric_2016; @schwab_atmospheric_2016-1], and another paper describes the measurements at Pinnacle State Park [@schwab_ozone_2009].

Installation

To install the package, run (from within R)

install.packages('remotes')
remotes::install_github('ASRCsoft/atmoschem.process')

To generate the processed dataset, additional dependencies are requried:

remotes::install_github('ASRCsoft/atmoschem.process', dependencies = TRUE)

Reproducing the routine chemistry dataset

Requirements

• R and R package dependencies
• GNU Make
• 15GB of disk space and 8GB of RAM
• An Air Quality System API key (get one here)
• A user/password for the ASRC's atmoschem server (sign up here)

Creating the dataset

Download or clone the repository. The dataset package can be generated by running, from a terminal,

cd /path/to/atmoschem.process
make routine asrc_user=youruser asrc_pass=yourpassword aqs_email=youremail aqs_key=yourkey

(replacing the values with your information).

Run make help to see more make options.

Viewing the data

The R package comes with a Shiny app for viewing the processing steps. After data has been processed, it can be launched with make:

make view

Citation

Please cite this package using the citation available from Zenodo:

License

atmoschem.process is released under the open source MIT license.

References

ASRCsoft/atmoschem.datasets documentation built on Feb. 15, 2023, 9:26 a.m.