RGISTools (version 0.9.7)

senSearch: Search Sentinel images

Description

senSearch searches Sentinel images through ESA's powered application programming interface (API), called `SciHub', that concern a particular location and date interval. The function returns a data.frame with the names of the images and their uniform resource locators (URLs).

Usage

senSearch(username, password, ...)

Arguments

username

ESA<U+2019>s `SciHub' username.

password

ESA<U+2019>s `SciHub' password.

...

arguments for nested functions:

• product the type of Sentinel product. Ex. "S2MSI1C", "S2MSI2A", "S2MSI2Ap", ...

• startDate a Date class object with the starting date of the study period.

• endDate a Date class object with the ending date of the study period.

• extent an extent, Raster*, or Spatial* object representing the region of interest with longitude/latitude coordinates.

• lonlat a vector with the longitude/latitude coordinates of the point of interest.

• platform the name of the Sentinel mission ("Sentinel-1", "Sentinel-2", ...).

• qformat the format of the response.

• verbose logical argument. If TRUE, the function prints the running steps and warnings.

Details

senSearch uses the ESA's powered API (`SciHub').The catalogue of Sentinel-2 products can be found here. Images are searched within a range of dates and a region of interest. Dates must be provided as a Date class object. Credentials from ESA<U+2019>s `SciHub' are needed and they can be obtained here.

Examples

# NOT RUN {
# load a spatial polygon object of Navarre
data(ex.navarre)
# perform the search query
searchres <- senSearch(startDate = as.Date("2018210", "%Y%j"),
                       endDate = as.Date("2018218", "%Y%j"),
                       platform = "Sentinel-2",
                       extent = ex.navarre,
                       product = "S2MSI1C",
                       username = "username",
                       password = "password")
head(searchres)
# }