r.futures.validation

Module for land change simulation validation and accuracy assessment

r.futures.validation simulated=name reference=name [original=name] [format=string] [--verbose] [--quiet] [--qq] [--ui]

Example:

r.futures.validation simulated=name reference=name

grass.script.parse_command("r.futures.validation", simulated, reference, original=None, format="plain", verbose=False, quiet=False, superquiet=False)

Example:

gs.parse_command("r.futures.validation", simulated="name", reference="name")

Parameters

Command linePython (grass.script)

simulated=name [required]
    Simulated land use raster
reference=name [required]
    Reference land use raster
original=name
    Original land use raster
    Required for kappa simulation
format=string
    Output format
    Allowed values: plain, shell, json
    Default: plain
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

simulated : str, required
    Simulated land use raster
    Used as: input, raster, name
reference : str, required
    Reference land use raster
    Used as: input, raster, name
original : str, optional
    Original land use raster
    Required for kappa simulation
    Used as: input, raster, name
format : str, optional
    Output format
    Allowed values: plain, shell, json
    Default: plain
verbose: bool, optional
    Verbose module output
    Default: False
quiet: bool, optional
    Quiet module output
    Default: False
superquiet: bool, optional
    Very quiet module output
    Default: False

DESCRIPTION

Module r.futures.validation allows to validate land change simulation results. 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

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 land change simulation output by computing quantity and allocation disagreement.

r.reclass input=simulated_2016 output=simulated_2016_reclass rules=rules.txt
r.futures.validation simulated=simulated_2016_reclass reference=reference_2016 original=orig_2001

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.validation source code (history)
Latest change: Friday Feb 21 10:10:05 2025 in commit 7d78fe3