RGISTools (version 0.9.7)

lsEspaOrderImages: Make a request to ESPA for pre-processing Landsat images

Description

lsEspaOrder makes a request to the EROS Centre Science Processing Architecture (ESPA) to further process level-1 Landsat scenes.

Usage

lsEspaOrderImages(search.res, username, password, product = c("sr",
  "source_metadata"), verbose = FALSE)

Arguments

search.res

the results from ls7Search or ls8Search.

username

USGS's `EarthExplorer' username.

password

USGS's `EarthExplorer' password.

product

the acronym of the requested product (see the details).

verbose

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

Details

Landsat Level-1 images are pre-processed on demand by the EROS Centre Science Processing Architecture (ESPA). An order is placed to ESPA with the level-1 images that must be pre-processed (search.res and the requested final product (product). The products are identified by the following short-names:

• toa: for top of atmosphere reflectance.

• bt: for brightness temperature (thermal band TOA processing).

• sr: for surface reflectance.

• sr_ndvi: the normalized difference vegetation index from surface reflectance imagery.

• sr_evi: the enhanced vegetation index from surface reflectance imagery.

• sr_savi: the soil adjusted vegetation index from surface reflectance imagery.

• sr_msavi: the modified soil adjusted vegetation index from surface reflectance imagery.

• sr_ndmi: the normalized difference moisture index from surface reflectance imagery.

• sr_nbr: the normalized burn ratio from surface reflectance imagery.

• sr_nbr2: the normalized burn ratio 2 index from surface reflectance imagery.

• prixel_qa: for pixel quality assurance.

Examples

# NOT RUN {
src <- paste0(tempdir(),"/Path_for_downloading_folder")
# search Landsat 7 level-1
search.res <- ls7Search(startDate = as.Date("01-01-2017", "%d-%m-%Y"),
                        endDate = as.Date("07-01-2017", "%d-%m-%Y"),
                        lonlat = c(-1.64323, 42.81687),
                        AppRoot = src)
# request to ESPA the pre-pocessing of level-1 images 
# to get the surface reflectance
order <- lsEspaOrderImages(search.res = search.res,
                           username = "username", 
                           password = "password", 
                           product = 'sr',
                           verbose = FALSE)
# }