CluesModel {lulcc}

Create a CluesModel object

Description

Methods to create a CluesModel object to supply to allocate.

Usage

CluesModel(obs, ef, models, ...)


  ## S4 method for signature 
## 'ObsLulcRasterStack,ExpVarRasterList,PredictiveModelList'
CluesModel(obs,
  ef, models, time, demand, hist, mask, neighb = NULL, elas, rules = NULL,
  nb.rules = NULL, params, output = NULL, ...)

Arguments

obs

an ObsLulcRasterStack

ef

an ExpVarRasterList object

models

a PredictiveModelList object

...

additional arguments (none)

time

numeric vector containing timesteps over which simulation will occur

demand

matrix with demand for each land use category in terms of number of cells to be allocated. The first row should be the number of cells allocated to the initial observed land use map (i.e. the land use map for time 0)

hist

RasterLayer containing land use history (values represent the number of years the cell has contained the current land use category)

mask

RasterLayer containing binary values where 0 indicates cells that are not allowed to change

neighb

an object of class NeighbRasterStack

elas

numeric indicating the elasticity of each land use category to change. Elasticity varies between 0 and 1, with 0 indicating a low resistance to change and 1 indicating a high resistance to change

rules

matrix with land use change decision rules

nb.rules

numeric with neighbourhood decision rules

params

list with model parameters

output

either a RasterStack containing output maps or NULL

Details

The params argument is a list of parameter values which should contain the following components:

jitter.f

Parameter controlling the amount of perturbation applied to the probability surface prior to running the CLUE-S iterative algorithm. Higher values result in more perturbation. Default is 0.0001

scale.f

Scale factor which controls the amount by which suitability is increased if demand is not met. Default is 0.0005

max.iter

The maximum number of iterations in the simulation

max.diff

The maximum allowed difference between allocated and demanded area of any land use type. Default is 5

ave.diff

The average allowed difference between allocated and demanded area. Default is 5

Note that, in order to achieve convergence, it is likely that some adjustment of these parameters will be required.

Value

A CluesModel object.

References

Verburg, P.H., Soepboer, W., Veldkamp, A., Limpiada, R., Espaldon, V., Mastura, S.S. (2002). Modeling the spatial dynamics of regional land use: the CLUE-S model. Environmental management, 30(3):391-405.

See Also

CluesModel-class, allocate

Examples

## see lulcc-package examples