getSentinel_query queries the Copernicus Open Access Hubs for Sentinel data by some basic input search parameters. The function returns a data frame that can be further filtered.

getSentinel_query(time_range, platform, aoi = NULL, username = NULL,
  password = NULL, hub = "auto", verbose = TRUE)

Arguments

time_range

character, containing two elements: the query's starting date and stopping date, formatted "YYYY-MM-DD", e.g. "2017-05-15"

platform

character, identifies the platform. Either "Sentinel-1", "Sentinel-2" or "Sentinel-3".

aoi

sfc_POLYGON or SpatialPolygons or matrix, representing a single multi-point (at least three points) polygon of your area-of-interest (AOI). If it is a matrix, it has to have two columns (longitude and latitude) and at least three rows (each row representing one corner coordinate). If its projection is not +proj=longlat +datum=WGS84 +no_defs, it is reprojected to the latter. Use set_aoi instead to once define an AOI globally for all queries within the running session. If aoi is undefined, the AOI that has been set using set_aoi is used.

username

character, a valid user name to the ESA Copernicus Open Access Hub. If NULL (default), the session-wide login credentials are used (see login_CopHub for details on registration).

password

character, the password to the specified user account. If NULL (default) and no seesion-wide password is defined, it is asked interactively ((see login_CopHub for details on registration).

hub

character, either "auto" to access the Copernicus Open Access Hubs by platform input, "operational" to look for ESA's operational products from the Open Hub, "pre-ops" to look for pre-operational products from the Pre-Ops Hub (e.g. currently all Sentinel-3 products), or an valid API URL. Default is "auto".

verbose

logical, if TRUE, details on the function's progress will be visibile on the console. Default is TRUE.

Value

A data frame of records. Each row represents one record. The data frame can be further filtered by its columnwise attributes. Records can be handed to the other getSentinel functions for previewing and downloading.

See also

Examples

## Load packages library(getSpatialData) library(raster) library(sf) library(sp) ## Define an AOI (either matrix, sf or sp object) data("aoi_data") # example aoi aoi <- aoi_data[[3]] # AOI as matrix object, or better: aoi <- aoi_data[[2]] # AOI as sp object, or: aoi <- aoi_data[[1]] # AOI as sf object ## set AOI for this session set_aoi(aoi) view_aoi() #view AOI in viewer # or, simply call set_aoi() without argument to interactively draw an AOI ## Define time range and platform time_range <- c("2017-08-01", "2017-08-30") platform <- "Sentinel-2" ## set login credentials and an archive directory
# NOT RUN { login_CopHub(username = "username") #asks for password or define 'password' set_archive("/path/to/archive/") ## Use getSentinel_query to search for data (using the session AOI) records <- getSentinel_query(time_range = time_range, platform = platform) ## Get an overview of the records View(records) #get an overview about the search records colnames(records) #see all available filter attributes unique(records$processinglevel) #use one of the, e.g. to see available processing levels ## Filter the records records_filtered <- records[which(records$processinglevel == "Level-1C"),] #filter by Level ## Preview a single record getSentinel_preview(record = records_filtered[5,]) ## Download some datasets datasets <- getSentinel_data(records = records_filtered[c(4,5,6),]) ## Make them ready to use datasets_prep <- prepSentinel(datasets, format = "tiff") ## Load them to R r <- stack(datasets_prep[[1]][[1]][1]) #first dataset, first tile, 10m resoultion # }