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

In spatialstatisticsupna/RGISTools: Handling Multiplatform Satellite Images

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.

Value

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

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)

## End(Not run)

spatialstatisticsupna/RGISTools documentation built on Feb. 21, 2023, 12:01 a.m.