lsEspaOrderImages: Make a request to ESPA for pre-processing Landsat images
In RGISTools: Handling Multiplatform Satellite Images

Description Usage Arguments Details Value Examples

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

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

`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.

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.

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

## 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)

## End(Not run)