rsp2ebv: Integrate remote sensing products

Description Usage Arguments Details Value Author(s) References Examples

Description

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

Usage

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

Arguments

ps

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 ps is a GADM unit then additional arguments in getGADM can be specified here.

lyrs

character. Names of the ecosystem earth-observation products. If NULL then a list of products is printed, see listGP. Default NULL.

path

character. Path name indicating where the variables are stored. If missing then a folder named as 'ecochange' located 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 'gdalUtils' so it assumes the user has a working GDAL installation on their system. From the documentation: "If the 'gdalUtils_gdalPath' option has been set (usually by 'gdal_setInstallation'), the GDAL found in that path will be used. If nothing is found, 'gdal_setInstallation' will be executed to attempt to find a working GDAL that has the right drivers as specified with the 'of' (output format) parameter", see example below.

Value

RasterStack or list.

Author(s)

Wilson Lara Henao <wilarhen@gmail.com> [aut, cre], Victor Gutierrez-Velez [aut], Ivan Gonzalez [aut], Maria C. Londono [aut]

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
## First, we'll check to make sure there is a valid GDAL
## installation (from 'gdalUtils):

 
 gdalUtils::gdal_setInstallation()
 valid_install <- !is.null(getOption("gdalUtils_gdalPath"))
 

## Warnings from GDAL/PROJ are suppressed.

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

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

 file.exists(rsp_cchaira)

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

 suppressWarnings(
 plotebv(season_cchaira)
 )
 

ecochange documentation built on Sept. 8, 2021, 5:09 p.m.