nneo_wrangle: Download and wrangle NEON's sensor-based data products

In ropenscilabs/nneo: 'NEON' 'API' Client

Download and wrangle NEON's sensor-based data products

Description

Retrieve related, sensor-based datasets at a given NEON site for a custom time period, merged per measurement level and/or variable

Usage

nneo_wrangle(site_code = "CPER", time_start = "2017-06-20",
  time_end = NULL, data_var = "temperature", time_agr = 30,
  package = "basic", ...)

Arguments

site_code	(character) a site code. Required.
time_start	(character) YYYY-MM-DD start day to check for files. Required if time_end=NULL
time_end	(character) YYYY-MM-DD end day to check for files. Required if time_start=NULL
data_var	(character) NEON data product(s) to be downloaded. The user may enter a specific, controlled, NEON data product or they may enter a generic term if wanting multiple, similar, NEON data products. For instance, defining data_var as "Photosythetically Active Radiation (Quantum Line)" would satisfy the former, and defining data_var as "Active Radiation" or just "Radiation" would satisfy the latter. Required
time_agr	(numeric) Aggregation period, given in minutes, of NEON data product(s) to be downloaded (e.g. 1 corresponds to a 1-minute data product). Required.
package	(character) Package type to return, basic or expanded. 'Expanded' datasets are only available for the smallest time_agr of each NEON data product. NOTE: 'expanded' datasets are much larger than 'basic' and will take considerably more time to download. Required
...	named curl options passed on to HttpClient, e.g., list(verbose = TRUE) or list(timeout_ms = 1000)

Value

Returns a tibble of relevant data products from all spatial locations at a NEON site for the custom time period. Data products are displayed via 'productName.spatialLocation', e.g., 'difRadMean.000.060' is mean, diffuse, shortwave radiation as measured on the 6th measurement level of a NEON tower (000.060), while 'linePARMean.005.000' is mean, photosynthetically Active Radiation (PAR) as measured at the 5th soil plot (005.000) of a NEON site. More information regarding spatial location and identifiers can be found at the references below.

Author(s)

Josh Roberti [e-mail]
Dave Durden
Robert Lee

References

NEON Data Portal
NEON Data Availability

See Also

Currently none

Examples

## Not run: 
#download 30-minute, radiation data from NEON's Bartlett site for Summer 2016
nneo_wrangle(site_code="BART", time_start="2016-06-20",
  time_end="2016-09-21", data_var="radiation")
#download 30-minute, temperature data from NEON's Sterling (STER) site for 2017-03-04
nneo_wrangle(site_code="STER",time_start="2017-03-04",
  data_var="temperature",time_agr=30)

## End(Not run)

ropenscilabs/nneo documentation built on May 18, 2022, 7:40 p.m.