rsp2ebv {ecochange}

Integrate remote sensing products

Description

This function integrates ecosystem remote sensing products and produces raster-data sections with the cell values enclosed in a region of interest.

Usage

rsp2ebv(ps = NULL, ..., 
    lyrs = NULL, path, 
    sr, ofr = c(30, 30), 
    mc.cores = round(detectCores() * 
        0.6, 0))

Arguments

ps

SpatialPolygonsDataFrame; or sf; 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.

...

Additional arguments in getGADM and getrsp.

lyrs

character. Remote-sensing products. Default NULL makes the function to print a list of Downloadable data, see listGP.

path

character. Path name indicating where the variables are stored. If missing then a folder named as 'ecochange' created in a current temporary directory is used.

sr

character. PROJ.4 description of the target coordinate reference system. If missing then the target layers are projected to metric system UTM.

ofr

numeric. c(xres,yres). Output file resolution (in target georeferenced units). Default c(30,30) m2.

mc.cores

numeric. The number of cores. Default uses around 60 percent of the cores.

Details

This function implements 'sf::gdal_utils' so it assumes the user's machine has a valid GDAL installation.

Value

Class echanges.

Author(s)

Wilson Lara Henao <[e-mail]> [aut, cre], Victor Gutierrez-Velez [aut], Ivan Gonzalez [ctb], Maria C. Londono [ctb]

References

Jetz, W., McGeoch, M. A., Guralnick, R., Ferrier, S., Beck, J., Costello, M. J., ... & Meyer, C. (2019). Essential biodiversity variables for mapping and monitoring species populations. Nature Ecology & Evolution, 3(4), 539-551.

O'Connor, B., Secades, C., Penner, J., Sonnenschein, R., Skidmore, A., Burgess, N. D., & Hutton, J. M. (2015). Earth observation as a tool for tracking progress towards the Aichi Biodiversity Targets. Remote sensing in ecology and conservation, 1(1), 19-28.

Skidmore, A. K., & Pettorelli, N. (2015). Agree on biodiversity metrics to track from space: Ecologists and space agencies must forge a global monitoring strategy. Nature, 523(7561), 403-406.

Examples

## A Global Surface Water layer ('seasonality') covering the extent of a
## Colombian municipality Cartagena del Chaira is formated into an
## spatial EBV:
        load(system.file('cchaira_roi.RData',package = 'ecochange'))

 
 rsp_cchaira <- getrsp(cchaira_roi,
   lyrs = 'seasonality', mc.cores = 2, path = tempdir())

 file.exists(rsp_cchaira)

 season_cchaira <- rsp2ebv(cchaira_roi,
                               lyrs = 'seasonality', path = tempdir())