README.md

In geomarker-io/schwartzGeohashPM: Add PM2.5, NO2, and O3 Concentrations to Data Based on Geohash

schwartzGeohashPM

The goal of schwartzGeohashPM is to add PM2.5, NO2, and O3 concentrations to your data based on geohashed locations (usually output from the Schwartz Grid Lookup Container)

Installation

You can install addSchwartzGeohashPM from GitHub with:

# install.packages("remotes")
remotes::install_github("degauss-org/schwartzGeohashPM")

s3 downloads

This package utilizes the s3 package. Users can pass arguments for s3::s3_get_files to schwartzGeohashPM::add_schwartz_pollutants. This is especially useful for specifying the local path where s3 files will be downloaded onto the user’s local machine, via the download_folder argument. The download folder can also be specified by setting options.

options(s3.download_folder = /path/to/folder/s3_downloads)

Example

library(schwartzGeohashPM)

d <- tibble::tribble(
      ~id,         ~lat,    ~lon, ~site_index,      ~sitecode,  ~start_date,    ~end_date,
      '55000100280', 39.2, -84.6,   '9607238', 211050640897, '2008-09-09', '2008-09-11',
      '55000100281', 39.2, -84.6,   '9607238', 211050640897, '2007-08-05', '2007-08-08',
      '55000100282', 39.2, -84.6,   '9607238', 211050640897, '2015-08-31', '2015-09-02') %>%
    dplyr::mutate_at(dplyr::vars(start_date, end_date), as.Date)

add_schwartz_pollutants(d)
#> Matching sitecodes to geohashes...
#> ℹ 3 files totaling 197.90 MB will be downloaded to /Users/RASV5G/OneDrive - cchmc/schwartzGeohashPM/s3_downloads
#> → Downloading 3 files.
#> → Got 0 files, downloading 3
#> → Got 1 file, downloading 2
#> → Got 2 files, downloading 1
#> ✓ Downloaded 3 files in 2m 50.9s.
#> Now reading in and joining pollutant data.
#> # A tibble: 10 x 15
#>    id      lat   lon site_index sitecode start_date end_date   date      
#>    <chr> <dbl> <dbl> <chr>         <dbl> <date>     <date>     <date>    
#>  1 5500…  39.2 -84.6 9607238     2.11e11 2007-08-05 2007-08-08 2007-08-05
#>  2 5500…  39.2 -84.6 9607238     2.11e11 2007-08-05 2007-08-08 2007-08-06
#>  3 5500…  39.2 -84.6 9607238     2.11e11 2007-08-05 2007-08-08 2007-08-07
#>  4 5500…  39.2 -84.6 9607238     2.11e11 2007-08-05 2007-08-08 2007-08-08
#>  5 5500…  39.2 -84.6 9607238     2.11e11 2008-09-09 2008-09-11 2008-09-09
#>  6 5500…  39.2 -84.6 9607238     2.11e11 2008-09-09 2008-09-11 2008-09-10
#>  7 5500…  39.2 -84.6 9607238     2.11e11 2008-09-09 2008-09-11 2008-09-11
#>  8 5500…  39.2 -84.6 9607238     2.11e11 2015-08-31 2015-09-02 2015-08-31
#>  9 5500…  39.2 -84.6 9607238     2.11e11 2015-08-31 2015-09-02 2015-09-01
#> 10 5500…  39.2 -84.6 9607238     2.11e11 2015-08-31 2015-09-02 2015-09-02
#> # … with 7 more variables: gh6 <chr>, gh3 <chr>, year <dbl>,
#> #   gh3_combined <chr>, PM25 <dbl>, NO2 <dbl>, O3 <dbl>

geomarker-io/schwartzGeohashPM documentation built on July 22, 2021, 1:10 p.m.