airsis_createMonitorObject: Obain AIRSIS data and create ws_monitor object

In PWFSLSmoke: Utilities for Working with Air Quality Monitoring Data

Description

Obtains monitor data from an AIRSIS webservice and converts it into a quality controlled, metadata enhanced ws_monitor object ready for use with all monitor_~ functions.

Steps involved include:

1. download CSV text

2. parse CSV text

3. apply quality control

4. apply clustering to determine unique deployments

5. enhance metadata to include: elevation, timezone, state, country, site name

6. reshape AIRSIS data into deployment-by-property meta and and time-by-deployment data dataframes

QC parameters that can be passed in the ... include the following valid data ranges as taken from airsis_EBAMQualityControl():

• valid_Longitude=c(-180,180)

• valid_Latitude=c(-90,90)

• remove_Lon_zero = TRUE

• remove_Lat_zero = TRUE

• valid_Flow = c(16.7*0.95,16.7*1.05)

• valid_AT = c(-Inf,45)

• valid_RHi = c(-Inf,50)

• valid_Conc = c(-Inf,5.000)

Note that appropriate values for QC thresholds will depend on the type of monitor.

Usage

airsis_createMonitorObject(
  startdate = strftime(lubridate::now(tzone = "UTC"), "%Y010100", tz = "UTC"),
  enddate = strftime(lubridate::now(tzone = "UTC"), "%Y%m%d23", tz = "UTC"),
  provider = NULL,
  unitID = NULL,
  clusterDiameter = 1000,
  zeroMinimum = TRUE,
  baseUrl = "http://xxxx.airsis.com/vision/common/CSVExport.aspx?",
  saveFile = NULL,
  existingMeta = NULL,
  addGoogleMeta = FALSE,
  addEsriMeta = FALSE,
  ...
)

Arguments

startdate	desired start date (integer or character representing YYYYMMDD[HH])
enddate	desired end date (integer or character representing YYYYMMDD[HH])
provider	identifier used to modify baseURL ['APCD'|'USFS']
unitID	character or numeric AIRSIS unit identifier
clusterDiameter	diameter in meters used to determine the number of clusters (see addClustering())
zeroMinimum	logical specifying whether to convert negative values to zero
baseUrl	base URL for data queries
saveFile	optional filename where raw CSV will be written
existingMeta	existing 'meta' dataframe from which to obtain metadata for known monitor deployments
addGoogleMeta	logicial specifying wheter to use Google elevation and reverse geocoding services
addEsriMeta	logicial specifying wheter to use ESRI elevation and reverse geocoding services
...	additional parameters are passed to type-specific QC functions

Value

A ws_monitor object with AIRSIS data.

Note

The downloaded CSV may be saved to a local file by providing an argument to the saveFile parameter.

See Also

airsis_downloadData

airsis_parseData

airsis_qualityControl

addClustering

airsis_createMetaDataframe

airsis_createDataDataframe

Examples

## Not run: 
# Fail gracefully if any resources are not available
try({

library(PWFSLSmoke)
initializeMazamaSpatialUtils()

usfs_1072 <- airsis_createMonitorObject(20200601, 20200620, 'USFS', unitID='1072')
monitor_timeseriesPlot(usfs_1072)

}, silent = FALSE)

## End(Not run)

PWFSLSmoke documentation built on Nov. 23, 2021, 5:06 p.m.