Download, untar, and load SpaDES sims from Google Drive

Source: R/download.R

Convenience wrapper around reGet(), reUntar(), and reLoad() – the inverse of outSaveTarUpload(). Operates on a batch: typically called with the multi-row dribble returned by outList() / outScenarios().

reGetUntarLoad(
  gFiles,
  destDir,
  pathRemap = NULL,
  projectPath = getwd(),
  method = c("loadSimList", "readRDS"),
  overwrite = FALSE,
  verbose = TRUE
)

Arguments

gFiles

Either a Google Drive dribble (e.g. the output of outList() / outScenarios()) or a character vector of Drive file IDs or URLs.

destDir

Character scalar. Local directory to write tarballs into. Created if it does not exist.

pathRemap

Optional named character vector of length 2, c(old = "/old/prefix", new = "/new/prefix"), applied to all tarballs. If NULL (default), files are extracted to their original absolute paths (tar --absolute-names).

projectPath

Character scalar. Passed to SpaDES.core::loadSimList() for relative-path resolution. Default getwd().

method

One of "loadSimList" (default) or "readRDS".

overwrite

Logical. Force re-download even if the local file exists. Default FALSE.

verbose

Logical. Print elapsed time per download. Default TRUE.

Value

A named list of simList objects, one per row of gFiles, named by the archive's name (sans .tar.gz).