NeighbRasterStack: Create a NeighbRasterStack object

In simonmoulds/lulcc2: Land Use Change Modelling in R

Description

Methods to calculate neighbourhood values for cells in raster maps using raster::focal. By default the fraction of non-NA cells within the moving window (i.e. the size of the weights matrix) devoted to each land use category is calculated. This behaviour can be changed by altering the weights matrix or providing an alternative function. The resulting object can be used as the basis of neighbourhood decision rules.

Usage

NeighbRasterStack(x, weights, neighb, ...)

## S4 method for signature 'RasterLayer,list,ANY'
NeighbRasterStack(x, weights, neighb,
  categories, fun = mean, ...)

## S4 method for signature 'RasterLayer,matrix,ANY'
NeighbRasterStack(x, weights, neighb,
  categories, fun = mean, ...)

## S4 method for signature 'RasterLayer,ANY,NeighbRasterStack'
NeighbRasterStack(x, weights,
  neighb)

Arguments

x	RasterLayer containing categorical data
weights	list containing a matrix of weights (the w argument in raster::focal) for each land use category. The order of list or vector elements should correspond to the order of land use categories in categories
neighb	NeighbRasterStack object. Only used if categories and weights are not provided. This option can be useful when existing NeighbRasterStack objects need to be updated because a new land use map is available, such as during the allocation procedure.
...	additional arguments to raster::focal
categories	numeric vector containing land use categories for which neighbourhood values should be calculated
fun	function. Input argument to focal. Default is mean

Value

A NeighbRasterStack object.

See Also

NeighbRasterStack-class, allowNeighb, raster::focal

Examples

## Plum Island Ecosystems

lu <- DiscreteLulcRasterStack(x=stack(pie[1:3]),
                              categories=c(1,2,3),
                              labels=c("Forest","Built","Other"),
                              t=c(0,6,14))

## create a NeighbRasterStack object for 1985 land use map
w1 <- matrix(data=1, nrow=3, ncol=3, byrow=TRUE)
w2 <- w1
w3 <- w1

nb1 <- NeighbRasterStack(x=lu[[1]],
                         categories=c(1,2,3),
                         weights=list(w1,w2,w3))

## update nb2 for 1991
nb2 <- NeighbRasterStack(x=lu[[2]],
                         neighb=nb1)

## plot neighbourhood map for forest
plot(nb2[[1]])

simonmoulds/lulcc2 documentation built on Dec. 23, 2021, 2:24 a.m.