| zipsByURI {neonUtilities} | R Documentation |
Get files from NEON ECS Bucket using URLs in stacked data
Description
Read in a set of URLs from NEON data tables and then download the data from the NEON ECS buckets. Assumes data tables are in the format resulting from merging files using stackByTable(). File downloads from ECS can be extremely large; be prepared for long download times and large file storage.
Usage
zipsByURI(
filepath,
savepath = paste0(filepath, "/ECS_zipFiles"),
pick.files = FALSE,
check.size = TRUE,
unzip = TRUE,
saveZippedFiles = FALSE,
token = NA_character_
)
Arguments
filepath |
The location of the NEON data containing URIs. Can be either a local directory containing NEON tabular data or a list object containing tabular data. |
savepath |
The location to save the output files from the ECS bucket, optional. Defaults to creating a "ECS_zipFiles" folder in the filepath directory. |
pick.files |
T or F, should the user be told the name of each file before downloading? Defaults to F. When working in batch mode, or other non-interactive workflow, use pick.files=F. |
check.size |
T or F, should the user be told the total file size before downloading? Defaults to T. When working in batch mode, or other non-interactive workflow, use check.size=F. |
unzip |
T or F, indicates if the downloaded zip files from ECS buckets should be unzipped into the same directory, defaults to T. Supports .zip and .tar.gz files currently. |
saveZippedFiles |
T or F: should the zip files be retained after unzipping? Defaults to F. |
token |
User specific API token (generated within neon.datascience user accounts). Optional. |
Value
A folder in the working directory (or in savepath, if specified), containing all files meeting query criteria.
Author(s)
Kaelin Cawley kcawley@battelleecology.org
References
License: GNU AFFERO GENERAL PUBLIC LICENSE Version 3, 19 November 2007
Examples
## Not run:
# To download stream morphology data from stacked data:
zipsByURI(filepath="~/filesToStack00131/stackedFiles")
## End(Not run)