RGISTools (version 1.0.2)

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.

Value

this function does not return anything. It makes a petition to process level-1 images before doing the download.

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 {
wdir <- file.path(tempdir(),"Path_for_downloading_folder")
# search Landsat 7 level-1
sres <- 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 = wdir)
# request to ESPA the pre-pocessing of level-1 images 
# to get the surface reflectance
order <- lsEspaOrderImages(search.res = sres,
                           username = "username", 
                           password = "password", 
                           product = 'sr',
                           verbose = FALSE)
# }