byTileAOP: Download AOP tiles overlapping specified coordinates for a...

View source: R/byTileAOP.R

byTileAOPR Documentation

Download AOP tiles overlapping specified coordinates for a given site, year, and product

Description

Query the API for AOP data by site, year, product, and tile location, and download all files found. Downloads serially to avoid overload; may take a very long time.

Usage

byTileAOP(
  dpID,
  site,
  year,
  easting,
  northing,
  buffer = 0,
  include.provisional = FALSE,
  check.size = TRUE,
  savepath = NA,
  token = NA_character_
)

Arguments

dpID

The identifier of the NEON data product to pull, in the form DPL.PRNUM.REV, e.g. DP1.10023.001

site

The four-letter code of a single NEON site, e.g. 'CLBJ'.

year

The four-digit year to search for data. Defaults to 2017.

easting

A vector containing the easting UTM coordinates of the locations to download.

northing

A vector containing the northing UTM coordinates of the locations to download.

buffer

Size, in meters, of the buffer to be included around the coordinates when determining which tiles to download. Defaults to 0. If easting and northing coordinates are the centroids of NEON TOS plots, use buffer=20.

include.provisional

T or F, should provisional data be included in downloaded files? Defaults to F. See https://www.neonscience.org/data-samples/data-management/data-revisions-releases for details on the difference between provisional and released data.

check.size

T or F, should the user approve the total file size before downloading? Defaults to T. When working in batch mode, or other non-interactive workflow, use check.size=F.

savepath

The file path to download to. Defaults to NA, in which case the working directory is used.

token

User specific API token (generated within neon.datascience user accounts)

Value

A folder in the working directory, containing all files meeting query criteria.

Author(s)

Claire Lunch clunch@battelleecology.org Christine Laney claney@battelleecology.org

References

License: GNU AFFERO GENERAL PUBLIC LICENSE Version 3, 19 November 2007


neonUtilities documentation built on Oct. 18, 2023, 9:09 a.m.