Note: This document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade, and read the current 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
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.
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
FUTURES,
r.futures.pga,
r.futures.potential,
r.futures.devpressure,
r.futures.demand,
r.futures.calib,
r.sample.category
-
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
Anna Petrasova,
NCSU GeoForAll
SOURCE CODE
Available at:
r.futures.gridvalidation source code
(history)
Latest change: Monday Jan 30 19:52:26 2023 in commit: cac8d9d848299297977d1315b7e90cc3f7698730
Main index |
Raster index |
Topics index |
Keywords index |
Graphical index |
Full index
© 2003-2024
GRASS Development Team,
GRASS GIS 8.3.3dev Reference Manual