get_data: Download datasets

View source: R/get_data.R

get_dataR Documentation

Download datasets

Description

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

Usage

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.

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/).

Value

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

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(s)

Jakob Schwalb-Willmann


16EAGLE/getSpatialData documentation built on June 9, 2022, 11:28 a.m.