GRASS logo

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: Monday Jan 30 19:52:26 2023 in commit: cac8d9d848299297977d1315b7e90cc3f7698730


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

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