Download datasets

get_data downloads the full datasets per records. File paths are added to the records data frame.

get_data(
  records,
  dir_out = NULL,
  md5_check = TRUE,
  force = FALSE,
  as_sf = TRUE,
  ...,
  verbose = TRUE
)

getSentinel_data(
  records,
  dir_out = NULL,
  md5_check = TRUE,
  force = FALSE,
  as_sf = TRUE,
  ...,
  verbose = TRUE
)

getLandsat_data(
  records,
  dir_out = NULL,
  md5_check = TRUE,
  force = FALSE,
  as_sf = TRUE,
  ...,
  verbose = TRUE
)

getMODIS_data(
  records,
  dir_out = NULL,
  md5_check = TRUE,
  force = FALSE,
  as_sf = TRUE,
  ...,
  verbose = TRUE
)

Arguments

records

records data frame, containing one or multiple records (each represented by one row), as returned by get_records

dir_out

character, a directory, to which the downloaded file(s) should be saved. By default, these are saved to the archive directory defined with set_archive.

md5_check

logical, whether to check md5 checksums (if available) or not.

force

logical, whether to force download of files already existing or not.

as_sf

logical, whether records should be returned as sf data.frame or a simple data.frame. In both cases, spatial geometries are stored in column footprint.

...

additional, sensor-specific arguments:

• hub, character, Copernicus Hub selection for Sentinel queries. Either

  • "auto" (default) to automatically select a suitable Copernicus hub depending on the selected products

  • "dhus" to look for operational Open Hub records only,

  • "s5p" to look for Sentinel-5P precursor pre-operational records only,

  • "GNSS" to look for GNSS RINEX records only,

  • or a valid API URL.

verbose

logical, whether to display details on the function's progress or output on the console.

Value

A data frame of records (as defined with argument records), extended by additional columns.

Details

Sentinel data are downloaded from the *ESA Copernicus Open Access Hubs*.

Landsat data are downloaded from *USGS-EROS ESPA* (on-demand higher-level data) and *Amazon Web Services* (Landsat-8 Level 1 data).

MODIS data are downloaded from the Level-1 and Atmosphere Archive & Distribution System (LAADS) of NASA's Distributed Active Archive Center (DAAC) at the Goddard Space Flight Center in Greenbelt, Maryland (https://ladsweb.modaps.eosdis.nasa.gov/).

Note

To use this function, you must be logged in at the services required for your request. See the examples and login for details.

Author

Jakob Schwalb-Willmann