GRASS logo

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

Table of contents

DESCRIPTION

Module r.futures.gridvalidation allows to validate land change simulation results on a spatial grid. It computes: 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: Mon Nov 1 12:13:58 2021 in commit: 1a9c817b17fa46763fab60da21db214ed9ff6cb1


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.

Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

© 2003-2023 GRASS Development Team, GRASS GIS 7.8.8dev Reference Manual