CluesModel: Create a CluesModel object
In lulcc: Land Use Change Modelling in R

Description Usage Arguments Details Value References See Also Examples

Methods to create a CluesModel object to supply to allocate.

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, ...)

`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

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.

A CluesModel object.

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.

CluesModel-class, allocate