ecochange: getrsp – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

getrsp

Get remote sensing product

Description

This function processes the extent of a predefined region of interest (polygon geometry or GADM unit) to download remote sensing products (RSP). Downloadable RSP include Global Surface Water, Forest Change, and Continuous Tree Cover data. See listGP.

Usage

getrsp(roi = NULL, ..., 
    lyrs = NULL, path, 
    verify.web = FALSE, 
    mc.cores = round(detectCores() * 
        0.6, 0))

Arguments

`roi`	`SpatialPolygonsDataFrame`; or `character`; or `NULL`. Region of interest. This can be whether 1) a polygon geometry; or 2) the name of a `GADM` unit (see `getGADM`); or 3) a `NULL` value. Default `NULL` makes the function to print a list of `GADM` units.
`...`	If `roi` is a `GADM` unit then additional arguments in `getGADM`.
`lyrs`	`character`. Remote sensing products. Default `NULL` makes the function to print a list of Downloadable RSPs, see `listGP`.
`path`	`character`. Path name indicating where the variables will be stored. Default uses a folder named as `'ecochange'` located in a current temporary directory.
`verify.web`	`logical`. Verify in the web whether the `URL`s used to download the `rsp` are available. See `getOption('webs')`. Default `FALSE`.
`mc.cores`	`numeric`. The number of cores. Default uses around 60 percent of the cores.

Details

Downloads of Continuous Tree Cover data require user authentication through the NASA Earth data Login. To obtain a NASA Earth data Login account, please visit: https://urs.earthdata.nasa.gov/users/new.

Value

Path names of the remote sensing products just retrieved, or character lists suggesting GADM units/Global Products that can be used to download rsp (see NULL defaults in arguments 'roi' and 'lyrs').

Author(s)

Wilson Lara Henao <wilarhen@temple.edu> [aut, cre], Victor Gutierrez-Velez [aut]

References

Pekel, J. F., Cottam, A., Gorelick, N., & Belward, A. S. (2016). High-resolution mapping of global surface water and its long-term changes. Nature, 540(7633), 418-422.

Hansen, M. C., Potapov, P. V., Moore, R., Hancher, M., Turubanova, S. A., Tyukavina, A., ... & Kommareddy, A. (2013). High-resolution global maps of 21st-century forest cover change. science, 342(6160), 850-853.

Sexton, J. O., Song, X. P., Feng, M., Noojipady, P., Anand, A., Huang, C., ... & Townshend, J. R. (2013). Global, 30-m resolution continuous fields of tree cover: Landsat-based rescaling of MODIS vegetation continuous fields with lidar-based estimates of error. International Journal of Digital Earth, 6(5), 427-448.

Examples

## Warnings from GDAL/PROJ are suppressed.

## A Global Surface Water layer ('seasonality') covering the extent of a
## Colombian municipality Cartagena del ChairÃ¡ is retrieved:
    load(system.file('cchaira_roi.RData',package = 'ecochange'))

 
 suppressWarnings(
 rsp_cchaira <- getrsp(roi = cchaira_roi,
   lyrs = 'seasonality', mc.cores = 2, path = tempdir())
)
 file.exists(rsp_cchaira) #TRUE

ecochange

Integrating Ecological Remote Sensing Data to Derive EBV Metrics

v1.3

GPL-3

Authors

Wilson Lara Henao [aut, cre], Victor Gutierrez-Velez [aut]

Initial release

2020-10-06