Download deployment media

This function allows the user to download all media related to a Agouti - dataset which matches the given parameters.

download_dep_media(
  dataset,
  depID,
  species = NULL,
  favorite = FALSE,
  outputfolder = NULL
)

Arguments

dataset

character string, path to the folder where a camptraptor datapackage has been unzipped.

depID

character string, ID of the deployment to download media from.

species

character string, latin name of the species to download

favorite

boolean, do you only want the pretty pictures?

outputfolder

character string, path where the function should download the media into

Value

Downloads the specified media files into the outputfolder

Details

If you are getting an Authorization Error (#403), this probably means your Agouti project has Restrict Images on. This needs to be turned off. If depID = "all" and favorite = TRUE, the function will download all favorited pictures in the whole dataset.

See also

Other download: download_gdrive_if_missing(), download_seq_media()

Author

Lynn Pallemaerts

Emma Cartuyvels

Sander Devisscher

Soria Delva

Examples

if (FALSE) { # \dontrun{
drg <- fistools::drg_example

# Situation 1: download whole deployment
download_dep_media(dataset = drg,
                    depID = "96413aa6-5f1f-4dfb-8fab-8f06decc179f")

# Situation 2: download only wanted species
download_dep_media(dataset = drg,
                    depID = "96413aa6-5f1f-4dfb-8fab-8f06decc179f",
                    species = "Dama dama")

# Situation 3: download only favorited species media
download_dep_media(dataset = drg,
                    depID = "96413aa6-5f1f-4dfb-8fab-8f06decc179f",
                    species = "Dama dama",
                    favorite = TRUE)

# Situation 4: download only favorited species media
download_dep_media(dataset = drg,
                    depID = "all",
                    favorite = TRUE)
} # }