Skip to content

r.futures.gridvalidation

Module for validating land change simulation on a grid

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] [--verbose] [--quiet] [--qq] [--ui]

Example:

r.futures.gridvalidation simulated=name reference=name allocation_disagreement=name region=name nprocs=1

grass.script.run_command("r.futures.gridvalidation", simulated, reference, original=None, allocation_disagreement=None, allocation_disagreement_basename=None, quantity_disagreement=None, quantity_disagreement_basename=None, kappa=None, kappasimulation=None, region, nprocs=1, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("r.futures.gridvalidation", simulated="name", reference="name", allocation_disagreement="name", region="name", nprocs=1)

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
--overwrite
    Allow output files to overwrite existing files
--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
allocation_disagreement : str, optional
    Output total allocation disagreement raster
    Used as: output, raster, name
allocation_disagreement_basename : str, optional
    Basename for per class allocation disagreement raster
    Used as: output, raster, basename
quantity_disagreement : str, optional
    Output total quantity disagreement raster
    Used as: output, raster, name
quantity_disagreement_basename : str, optional
    Basename for per class quantity disagreement raster
    Used as: output, raster, basename
kappa : str, optional
    Output Cohen's kappa raster
    Used as: output, raster, name
kappasimulation : str, optional
    Output kappa simulation raster
    Used as: output, raster, name
region : str, required
    Name of saved region
    Used as: input, region, name
nprocs : int, required
    Number of parallel processes
    Default: 1
overwrite: bool, optional
    Allow output files to overwrite existing files
    Default: False
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.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

SEE ALSO

FUTURES, r.futures.pga, r.futures.potential, r.futures.devpressure, r.futures.demand, r.futures.calib, r.sample.category

REFERENCES

AUTHOR

Anna Petrasova, NCSU GeoForAll

SOURCE CODE

Available at: r.futures.gridvalidation source code (history)
Latest change: Thursday Mar 20 21:36:57 2025 in commit 7286ecf