download_daymet_batch: This function downloads 'Daymet' data for several single...

View source: R/download_daymet_batch.r

download_daymet_batchR Documentation

This function downloads 'Daymet' data for several single pixel location, as specified by a batch file.

Description

This function downloads 'Daymet' data for several single pixel location, as specified by a batch file.

Usage

download_daymet_batch(
  file_location = NULL,
  start = 1980,
  end = as.numeric(format(Sys.time(), "%Y")) - 1,
  internal = TRUE,
  force = FALSE,
  silent = FALSE,
  path = tempdir(),
  simplify = FALSE
)

Arguments

file_location

file with several site locations and coordinates in a comma delimited format: site, latitude, longitude

start

start of the range of years over which to download data

end

end of the range of years over which to download data

internal

assign or FALSE, load data into workspace or save to disc

force

TRUE or FALSE (default), override the conservative end year setting

silent

suppress the verbose output (default = FALSE)

path

set path where to save the data if internal = FALSE (default = tempdir())

simplify

output data to a tibble, logical FALSE or TRUE (default = TRUE)

Value

Daymet data for point locations as a nested list or data written to csv files

Examples


## Not run: 
# The download_daymet_batch() routine is a wrapper around
# the download_daymet() function. It queries a file with
# coordinates to easily download a large batch of daymet
# pixel locations. When internal = TRUE, the data is stored
# in a structured list in an R variable. If FALSE, the data
# is written to disk.

# create demo locations (two sites)
locations <- data.frame(site = c("site1", "site2"),
                      lat = rep(36.0133, 2),
                      lon = rep(-84.2625, 2))

# write data to csv file
write.table(locations, paste0(tempdir(),"/locations.csv"),
           sep = ",",
           col.names = TRUE,
           row.names = FALSE,
           quote = FALSE)

# download data, will return nested list of daymet data
df_batch <- download_daymet_batch(file_location = paste0(tempdir(),
                                                        "/locations.csv"),
                                    start = 1980,
                                    end = 1980,
                                    internal = TRUE,
                                    silent = TRUE)

# For other practical examples consult the included
# vignette. 

## End(Not run)

daymetr documentation built on Sept. 15, 2023, 5:07 p.m.