Skip to contents

Download gridMET data

Source: R/download.R
download_gridmet.Rd

The download_gridmet function accesses and downloads gridded surface meteorological data from the University of California Merced Climatology Lab's gridMET dataset.

Usage

download_gridmet(
  variables = NULL,
  year = c(2018, 2022),
  directory_to_save = NULL,
  acknowledgement = FALSE,
  download = TRUE,
  remove_command = FALSE,
  show_progress = TRUE,
  hash = FALSE,
  max_tries = 20,
  rate_limit = 2
)

Arguments

variables

character. Variable(s) name(s).

year

integer(1 or 2). Year or start/end years for downloading data.

directory_to_save

character(1). Directory to save data.

acknowledgement

logical(1). Must be TRUE to proceed.

download

logical(1). DEPRECATED. Downloads happen automatically.

remove_command

logical(1). Deprecated, ignored.

show_progress

logical(1). Show download progress (default TRUE)

hash

logical(1). Return hash of downloaded files (default FALSE)

max_tries

integer(1). Maximum retry attempts (default 20)

rate_limit

numeric(1). Minimum seconds between requests (default 2)

Value

invisible list with download results; or hash character if hash=TRUE

Note

gridMET data does not require authentication.

Details

EDDI uses the same native GRIDMET multi-year workflow as SPEI. Use eddi14d, eddi30d, eddi90d, eddi180d, eddi270d, eddi1y, eddi2y, or eddi5y; eddi defaults to eddi30d. Both indices retain the native 1/24-degree grid and five-day observation dates. Select dataset gridmet in the wrapper functions to use these products; the standalone drought source aliases continue to select their separate products. GRIDMET SPEI is available directly from the provider as multi-year files (one file per accumulation period), at native five-day intervals on the approximately 4-km grid. Use "spei14d", "spei30d", "spei90d", "spei180d", "spei270d", "spei1y", "spei2y", or "spei5y"; "spei" aliases "spei30d". For SPEI, year does not subset the download: the complete multi-year file is saved under its resolved code directory (e.g., spei30d/spei30d.nc). Subset dates with process_gridmet(). These files are several GB each. This is distinct from the global CSIC SPEI product in download_drought(). See https://www.northwestknowledge.net/metdata/data/.

References

Abatzoglou JT (2013). “Development of gridded surface meteorological data for ecological applications and modelling.” International journal of climatology, 33(1), 121–131.

Author

Mitchell Manware

Examples

if (FALSE) { # \dontrun{
download_gridmet(
  variables = "pr",
  year = 2023,
  directory_to_save = tempdir(),
  acknowledgement = TRUE
)
} # }