gaugeIndicator {ecochange}

Gauge Biodiversity Indicator

Description

This function processes ecosystem-change maps from echanges to calculate biodiversity indicators, including ecosystem extent, entropy, fractal dimension, among others. To sample the indicators across fixed-size grids see sampleIndicator.

Usage

gaugeIndicator(ps, ..., 
    metric = "area_ha", 
    smp_lsm = list(), 
    mc.cores = round(detectCores() * 
        0.6, 0))

Arguments

ps

SpatialPolygonsDataFrame or RasterStack. Polygon geometry used to produce ecosystem-change maps via the implementation of echanges or the stack of ecosystem-change maps.

...

If ps is a polygon then additional arguments in echanges or rsp2ebv.

metric

character. The name of an indicator. Default 'area_ha' computes ecosystem areas (ha) at class level. See the argument 'metric' in list_lsm to implement other metrics.

smp_lsm

list. List of arguments in calculate_lsm. This argument is ignored when metric = 'area_ha'.

mc.cores

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

Details

Coordinate reference system of the spatial units must have metric units UTM. Performance in the computation of ecosystem extents is optimized via the implementation of the function tabuleRaster. Indicators other than ecosystem extents are calculated implementing calculate_lsm.

Value

Class Indicator.

Author(s)

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

References

Hesselbarth, M. H., Sciaini, M., With, K. A., Wiegand, K., & Nowosad, J. (2019). landscapemetrics: an open source R tool to calculate landscape metrics. Ecography, 42(10), 1648-1657.

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.

Pereira, H.M., Ferrier, S., Walters, M., Geller, G.N., Jongman, R.H.G., Scholes, R.J., Bruford, M.W., Brummitt, N., Butchart, S.H.M., Cardoso, A.C. and Coops, N.C., 2013. Essential biodiversity variables. Science, 339(6117), pp.277-278.

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

## RasterBrick of structural Essential Biodiversity Variables
## covering the extent of a location in the northern Amazon basin
## (Colombia) is imported:
path. <- system.file('amazon.grd',package = 'ecochange')
amazon <- brick(path.)

## Changes in layers of tree-canopy cover (TC) in the 'amazon'
## brick are computed:
def <- echanges(amazon, eco = 'TC',
                change = 'lossyear',
                eco_range = c(1,80),
                get_unaffected = TRUE,
                binary_output = FALSE,
                mc.cores = 2)

## Function 'gaugeIndicator' is used to compute ecosystem areas
## (default):
am_areas <- gaugeIndicator(def,
                           mc.cores = 2)

plot.Indicator(am_areas)