R: Evaluate allocation performance with three maps

ThreeMapComparison {lulcc}

R Documentation

Evaluate allocation performance with three maps

Description

An implementation of the method described by Pontius et al. (2011), which compares a reference map at time 1, a reference map at time 2 and a simulated map at time 2 to evaluate allocation performance at multiple resolutions while taking into account persistence. The method quantifies disagreement within coarse squares (minor allocation disagreement), disagreement between coarse squares (major allocation disagreement), disagreement about the quantity of land use change and agreement.

Usage

ThreeMapComparison(x, x1, y1, ...)

## S4 method for signature 'Model,ANY,ANY'
ThreeMapComparison(x, x1, y1, factors, timestep, ...)

## S4 method for signature 'RasterLayer,RasterLayer,RasterLayer'
ThreeMapComparison(x, x1, y1,
  factors, categories, labels, ...)

Arguments

`x`	either a RasterLayer of observed land use at time 0 or an object inheriting from class `Model`
`x1`	a RasterLayer of observed land use at a subsequent time. Only required if `x` is also a RasterLayer
`y1`	a RasterLayer of simulated land use corresponding to `x1`. Only required if `x` is also a RasterLayer
`...`	additional arguments to `raster::aggregate`
`factors`	numeric vector of aggregation factors (equivalent to the 'fact' argument to `raster::aggregate` representing the resolutions at which model performance should be tested
`timestep`	numeric value indicating the timestep of the simulated land use map. Only required if `x` is a `Model` object
`categories`	numeric vector of land use categories in observed maps. Only required if `x` is a RasterLayer
`labels`	character vector (optional) with labels corresponding to `categories`. Only required if `x` is a RasterLayer

Value

A ThreeMapComparison object.

References

Pontius Jr, R.G., Peethambaram, S., Castella, J.C. (2011). Comparison of three maps at multiple resol utions: a case study of land change simulation in Cho Don District, Vietnam. Annals of the Association of American Geographers 101(1): 45-62.

Examples


## see lulcc-package examples

[Package lulcc version 1.0.4 Index]