RGISTools (version 1.0.2)

senDownSearch: Search and download Sentinel images

Description

senDownSearch searches and downloads Sentinel images concerning a particular location and time interval from `SciHub's' repository.

Usage

senDownSearch(username, password, AppRoot, verbose = FALSE, ...)

Arguments

username

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

password

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

AppRoot

the directory where the images are saved.

verbose

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

...

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. This argument is mandatory if dates is not defined.

• endDate a Date class object with the ending date of the study period. This argument is mandatory if dates is not defined.

• dates a vector with the capturing dates being considered for searching. This argument is mandatory if startDate and endDate are not defined.

• region a Spatial*, projected raster*, or sf class object defining the area of interest.

• extent an extent, Raster*, or Spatial* object representing the region of interest with longitude/latitude coordinates. This argument is mandatroy when region is not defined.

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

• nattempts the number of attempts to download an image in case it becomes corrupted.

• unzip logical argument. If TRUE, unzips the images.

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

Value

this function does not return anything. It saves the imagery as `zip<U+2019> (and JP2 files) in a folder called `raw<U+2019> (`unzip<U+2019>) in the AppRoot directory.

Details

senDownSearch is a wrapper function of senSearch and senDownload to search and download images in a single step. The function requires ESA<U+2019>s `SciHub' credentials, which can be obtained here.

Examples

# NOT RUN {
# load a spatial polygon object of Navarre
data(ex.navarre)
# Download S2MSI1C products sensed by Sentinel-2 
# between the julian dates 210 and 218, 2018
wdir <- file.path(tempdir(),"Path_for_downloading_folder")
print(wdir)
senDownSearch(startDate = as.Date("2018210", "%Y%j"),
            endDate = as.Date("2018218", "%Y%j"),
            platform = "Sentinel-2",
            extent = ex.navarre,
            product = "S2MSI1C",
            pathrow = c("R094"),
            username = "username",
            password = "password",
            AppRoot = wdir)
            
wdir.sen <- file.path(wdir, "Sentinel-2")
wdir.sen.unzip <- file.path(wdir.sen, "unzip")
                  
files.sen.unzip <- list.files(wdir.sen.unzip,
                              pattern = "\\TCI.jp2$",
                              full.names = TRUE,
                              recursive = TRUE)
img.sen.rgb <- stack(files.sen.unzip[1])
plotRGB(img.sen.rgb)
# }