GRASS logo


r.futures.devpressure - Module for computing development pressure


raster, filter, statistics


r.futures.devpressure --help
r.futures.devpressure [-n] input=name output=name method=string size=integer [gamma=float] [scaling_factor=float] [nprocs=integer] [--overwrite] [--help] [--verbose] [--quiet] [--ui]


Do not propagate nulls
Allow output files to overwrite existing files
Print usage summary
Verbose module output
Quiet module output
Force launching GUI dialog


input=name [required]
Name of input binary raster map representing development
output=name [required]
Name of the output development pressure raster
method=string [required]
Method for computing development pressure
Options: occurrence, gravity, kernel
Default: gravity
occurrence: number of developed cells in window
gravity: scaling_factor / pow(distance, gamma)
kernel: scaling_factor * exp (-2*distance / gamma)
size=integer [required]
Half of neighborhood size
Default: 8
Coefficient controlling the influence of distance, needed for method gravity and kernel
Default: 1.5
Scaling factor needed for method gravity and kernel
Default: 1
Number of threads for parallel computing
Default: 1

Table of contents


Module r.futures.devpressure is part of FUTURES, land change model. It computes development pressure, a predictor based on the number of neighboring developed cells within search distance, weighted by distance. The development pressure variable plays a special role in the model, allowing for a feedback between predicted change and change in subsequent steps.

There are multiple options for calculating development pressure in the model.

Coefficient gamma is the coefficient controlling the influence of distance. The best value for gamma is chosen during the model selection process (TODO).

The input raster is binary, value 1 represents development, value 0 no development. The neighborhood size describes the size of the moving window in cells (2 * size + 1).

Figure: Effect of parameters size and gamma: a) initial development, b) gamma = 2, size = 10, c) gamma = 1.5, size = 10, d) gamma = 1.5, size = 20.


By default NULL values are propagated. This means that the edges of the resulting map will be NULLs. To avoid that, flag n internally enlarges the computational region, converts NULLs to zeros, performs the computation and then patches back the original NULL values.

Module r.futures.devpressure, although written for FUTURES model, is general enough to be used for different applications where distance pressure can be described with the functions above.


r.futures.devpressure input=developed output=pressure gamma=1.5 size=10 method=gravity


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



Anna Petrasova, NCSU GeoForAll


Available at: r.futures.devpressure source code (history)

Latest change: Wednesday Mar 16 11:48:02 2022 in commit: 240e15b24997e1aa5cd10e62682178f4d2bf63d7

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

© 2003-2024 GRASS Development Team, GRASS GIS 8.3.3dev Reference Manual