r.futures.gridvalidation - GRASS GIS manual

Note: This addon document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade your GRASS GIS installation, and read the current addon manual page.

NAME

r.futures.gridvalidation - Module for validating land change simulation on a grid

KEYWORDS

raster, statistics, accuracy, validation

SYNOPSIS

r.futures.gridvalidation

r.futures.gridvalidation --help

r.futures.gridvalidation simulated=name reference=name [original=name] [allocation_disagreement=name] [allocation_disagreement_basename=basename] [quantity_disagreement=name] [quantity_disagreement_basename=basename] [kappa=name] [kappasimulation=name] region=name nprocs=integer [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

--overwrite: Allow output files to overwrite existing files
--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

simulated=name [required]: Simulated land use raster
reference=name [required]: Reference land use raster
original=name: Original land use raster; Required for kappa simulation
allocation_disagreement=name: Output total allocation disagreement raster
allocation_disagreement_basename=basename: Basename for per class allocation disagreement raster
quantity_disagreement=name: Output total quantity disagreement raster
quantity_disagreement_basename=basename: Basename for per class quantity disagreement raster
kappa=name: Output Cohen's kappa raster
kappasimulation=name: Output kappa simulation raster
region=name [required]: Name of saved region
nprocs=integer [required]: Number of parallel processes; Default: 1

DESCRIPTION
EXAMPLES
SEE ALSO
REFERENCES
AUTHOR

DESCRIPTION

Module r.futures.gridvalidation allows to validate land change simulation results on a spatial grid. It computes:

Allocation disagreement (total and per class), see Pontius et al, 2011
Quantity disagreement (total and per class), see Pontius et al, 2011
Cohen's Kappa
Kappa simulation, see van Vliet et al, 2011

These metrics are computed for each cell of a region provided in region option resulting in spatially variable validation results. Cell size of the region should be larger than the cell size of the current region.

This module can be used for any number of classes. Input raster original represents the initial conditions and is needed only for Kappa simulation.

EXAMPLES

Validate FUTURES output by computing quantity and allocation disagreement on a 5km grid. First reclassify FUTURES output to 0 (undeveloped) and 1 (developed) by creating a text file "rules.txt" with the following content:

-1 = 0
0 thru 100 = 1

Then save a region used as a grid:

g.region res=5000 -a save=grid

Reclass FUTURES output:

r.reclass input=simulated_2016 output=simulated_2016_reclass rules=rules.txt

Validate FUTURES output by computing kappa simulation on a 5km grid:

r.futures.gridvalidation simulated=simulated_2016_reclass reference=reference_2016 original=orig_2001 kappasimulation=kappasim

REFERENCES

Robert Gilmore Pontius Jr & Marco Millones (2011). Death to Kappa: birth of quantity disagreement and allocation disagreement for accuracy assessment. International Journal of Remote Sensing, 32:15, 4407-4429
Jasper van Vliet, Arnold K. Bregt, Alex Hagen-Zanker (2011) Revisiting Kappa to account for change in the accuracy assessment of land-use change models. Ecological Modelling, Volume 222, Issue 8.
Meentemeyer, R. K., Tang, W., Dorning, M. A., Vogler, J. B., Cunniffe, N. J., & Shoemaker, D. A. (2013). FUTURES: Multilevel Simulations of Emerging Urban-Rural Landscape Structure Using a Stochastic Patch-Growing Algorithm. Annals of the Association of American Geographers, 103(4), 785-807. DOI: 10.1080/00045608.2012.707591
Dorning, M. A., Koch, J., Shoemaker, D. A., & Meentemeyer, R. K. (2015). Simulating urbanization scenarios reveals tradeoffs between conservation planning strategies. Landscape and Urban Planning, 136, 28-39. DOI: 10.1016/j.landurbplan.2014.11.011
Petrasova, A., Petras, V., Van Berkel, D., Harmon, B. A., Mitasova, H., & Meentemeyer, R. K. (2016). Open Source Approach to Urban Growth Simulation. Int. Arch. Photogramm. Remote Sens. Spatial Inf. Sci., XLI-B7, 953-959. DOI: 10.5194/isprsarchives-XLI-B7-953-2016

AUTHOR

Anna Petrasova, NCSU GeoForAll

SOURCE CODE

Available at: r.futures.gridvalidation source code (history)

Latest change: Mon Nov 1 12:13:58 2021 in commit: 1a9c817b17fa46763fab60da21db214ed9ff6cb1