[GRASS-SVN] r65543 - in grass-addons/grass7/raster/r.futures: . r.futures.calib r.futures.devpressure r.futures.pga
svn_grass at osgeo.org
svn_grass at osgeo.org
Mon Jul 6 13:30:45 PDT 2015
Author: annakrat
Date: 2015-07-06 13:30:45 -0700 (Mon, 06 Jul 2015)
New Revision: 65543
Modified:
grass-addons/grass7/raster/r.futures/r.futures.calib/r.futures.calib.html
grass-addons/grass7/raster/r.futures/r.futures.calib/r.futures.calib.py
grass-addons/grass7/raster/r.futures/r.futures.devpressure/r.futures.devpressure.py
grass-addons/grass7/raster/r.futures/r.futures.html
grass-addons/grass7/raster/r.futures/r.futures.pga/r.futures.pga.html
Log:
r.futures: small improvements to the manual
Modified: grass-addons/grass7/raster/r.futures/r.futures.calib/r.futures.calib.html
===================================================================
--- grass-addons/grass7/raster/r.futures/r.futures.calib/r.futures.calib.html 2015-07-06 20:13:21 UTC (rev 65542)
+++ grass-addons/grass7/raster/r.futures/r.futures.calib/r.futures.calib.html 2015-07-06 20:30:45 UTC (rev 65543)
@@ -36,7 +36,8 @@
As the value of the parameter increases, patches become more compact.
Calibration is achieved by varying the values specified in <b>compactness_mean</b>
and <b>compactness_range</b> and comparing the distribution
-of the simulated patch compactness (computed as patch perimeter / (2 * sqrt(pi * area)))
+of the simulated patch compactness (computed as
+<em>patch perimeter / (2 * sqrt(pi * area))</em>)
to those observed for the reference period.
Meentemeyer et al. 2013 used mean 0.4 and range 0.08.
@@ -54,7 +55,7 @@
and an error (histogram distance) is computed.
Since <em>r.futures.pga</em> is a stochastic module, multiple
runs (specified in <b>repeat</b>) are recommended, the error is then averaged.
-Calibration results are saved in a csv file specified in <b>calibration_results</b>:
+Calibration results are saved in a CSV file specified in <b>calibration_results</b>:
<pre>
input_discount_factor area_distance input_compactness_mean input_compactness_range compactness_distance
Modified: grass-addons/grass7/raster/r.futures/r.futures.calib/r.futures.calib.py
===================================================================
--- grass-addons/grass7/raster/r.futures/r.futures.calib/r.futures.calib.py 2015-07-06 20:13:21 UTC (rev 65542)
+++ grass-addons/grass7/raster/r.futures/r.futures.calib/r.futures.calib.py 2015-07-06 20:30:45 UTC (rev 65543)
@@ -11,14 +11,14 @@
#
# COPYRIGHT: (C) 2015 by the GRASS Development Team
#
-# This program is free software under the GNU General Public
-# License (>=v2). Read the file COPYING that comes with GRASS
-# for details.
+# This program is free software under the GNU General Public
+# License (>=v2). Read the file COPYING that comes with GRASS
+# for details.
#
##############################################################################
#%module
-#% description: Script for calibrating patch characteristics used as input to r.futures.pga
+#% description: Module for calibrating patch characteristics used as input to r.futures.pga
#% keyword: raster
#% keyword: patch
#%end
Modified: grass-addons/grass7/raster/r.futures/r.futures.devpressure/r.futures.devpressure.py
===================================================================
--- grass-addons/grass7/raster/r.futures/r.futures.devpressure/r.futures.devpressure.py 2015-07-06 20:13:21 UTC (rev 65542)
+++ grass-addons/grass7/raster/r.futures/r.futures.devpressure/r.futures.devpressure.py 2015-07-06 20:30:45 UTC (rev 65543)
@@ -11,14 +11,14 @@
#
# COPYRIGHT: (C) 2015 by the GRASS Development Team
#
-# This program is free software under the GNU General Public
-# License (>=v2). Read the file COPYING that comes with GRASS
-# for details.
+# This program is free software under the GNU General Public
+# License (>=v2). Read the file COPYING that comes with GRASS
+# for details.
#
##############################################################################
#%module
-#% description: Script for computing development pressure
+#% description: Module for computing development pressure
#% keyword: raster
#% keyword: filter
#% keyword: statistics
Modified: grass-addons/grass7/raster/r.futures/r.futures.html
===================================================================
--- grass-addons/grass7/raster/r.futures/r.futures.html 2015-07-06 20:13:21 UTC (rev 65542)
+++ grass-addons/grass7/raster/r.futures/r.futures.html 2015-07-06 20:30:45 UTC (rev 65543)
@@ -1,14 +1,13 @@
<h2>DESCRIPTION</h2>
-<em>r.futures.*</em> is an implementation of
-FUTure Urban-Regional Environment Simulation (FUTURES)
-which is a model for multilevel simulations of emerging urban-rural
-landscape structure.
+<em>r.futures.*</em> is an implementation of FUTure Urban-Regional
+Environment Simulation (FUTURES) which is a model for multilevel
+simulations of emerging urban-rural landscape structure. FUTURES
+produces regional projections of landscape patterns using coupled
+submodels that integrate nonstationary drivers of land change: per
+capita demand (DEMAND submodel), site suitability (POTENTIAL submodel),
+and the spatial structure of conversion events (PGA submodel).
-The FUTure Urban-Regional Environment Simulation (FUTURES) produces
-regional projections of landscape patterns using coupled submodels
-that integrate nonstationary drivers of land change: per capita demand (DEMAND submodel),
-site suitability (POTENTIAL submodel), and the spatial structure of conversion events (PGA submodel).
<h3>Submodels</h3>
<dl>
@@ -19,10 +18,10 @@
and land conversion based on scenarios of future population growth.
How to construct the per capita demand relationship for subregions depends
on user's preferences and data availability.
- Land area conversion over time can be derived for the USA e.g.
+ Land area conversion over time can be derived for the USA, e.g.
from National Land Cover Dataset.
A possible implementation of the DEMAND submodel will be available as module
- r.futures.demand.</dd>
+ <em>r.futures.demand</em>.</dd>
<dt><em>POTENTIAL</em></dt>
<dd>The POTENTIAL submodel uses site suitability modeling approaches
@@ -33,12 +32,13 @@
account for divergent relationships between predictor and response variables.
To generate a binary, developed-undeveloped response variable
using a stratified-random sample,
- see module <a href="r.sample.category.html">r.sample.category</a>.
+ see module <em><a href="r.sample.category.html">r.sample.category</a></em>.
The coefficients for the statistical model that are used to
calculate the value of development potential can be derived in different ways,
- one possible implementation using R will be available as module r.futures.potential.
+ one possible implementation using R will be available
+ as module <em>r.futures.potential</em>.
One of the predictor variables is development pressure (computed using
- <a href="r.futures.devpressure.html">r.futures.devpressure</a>)
+ <em><a href="r.futures.devpressure.html">r.futures.devpressure</a></em>)
which is updated each step and thus creates positive feedback
resulting in new development attracting even more development.
</dd>
@@ -63,7 +63,7 @@
We need to collect the following data:
<dl>
<dt><em>Study extent and resolution</em></dt>
- <dd>Specified with <a href="g.region.html">g.region</a> command.</dd>
+ <dd>Specified with <em><a href="g.region.html">g.region</a></em> command.</dd>
<dt><em>Subregions</em></dt>
<dd>FUTURES is designed to capture variation across specified subregions
within the full study extent. Subregions can be for example counties.
@@ -80,7 +80,7 @@
end of the reference period, and the population data,
DEMAND computes how many cells to convert for each region at each time step.
Development change is also used for deriving the patch sizes and shape in calibration step
- (see <a href="r.futures.calib.html">r.futures.calib</a>) to be used in PGA submodel.
+ (see <em><a href="r.futures.calib.html">r.futures.calib</a></em>) to be used in PGA submodel.
DEMAND and PGA require a raster map representing the starting state
of the landscape at the beginning of the simulation (developed = 1,
available for development = 0, excluded from development as NULLs).</dd>
@@ -92,7 +92,7 @@
<dd>The development pressure variable is one of the predictors,
but it is recalculated at each time step to allow for positive feedback
(new development attracts more development). For computing development pressure,
- see <a href="r.futures.devpressure.html">r.futures.devpressure.</a></dd>
+ see <em><a href="r.futures.devpressure.html">r.futures.devpressure.</a></em></dd>
</dl>
<p>
Modified: grass-addons/grass7/raster/r.futures/r.futures.pga/r.futures.pga.html
===================================================================
--- grass-addons/grass7/raster/r.futures/r.futures.pga/r.futures.pga.html 2015-07-06 20:13:21 UTC (rev 65542)
+++ grass-addons/grass7/raster/r.futures/r.futures.pga/r.futures.pga.html 2015-07-06 20:30:45 UTC (rev 65543)
@@ -23,7 +23,8 @@
by compactness parameter given in <b>compactness_mean</b> and <b>compactness_range</b>.
The size of the patch is determined by randomly selecting a patch size from <b>patch sizes</b> file
and multiplied by <b>discount_factor</b>. To find optimal values
-for patch sizes and compactness, use module <a href="r.futures.calib.html">r.futures.calib</a>.
+for patch sizes and compactness, use module
+<em><a href="r.futures.calib.html">r.futures.calib</a></em>.
Once a cell is converted, it remains developed.
PGA continues to grow patches until the per capita land demand is satisfied.
@@ -32,11 +33,12 @@
derived from the patch-building process of PGA and associated with the POTENTIAL submodel.
At each time step, PGA updates the POTENTIAL probability surface based on land change,
and the new development pressure then affects future land change.
-The initial development pressure is computed using module <a href="r.futures.devpressure.html">
-r.futures.devpressure</a>. The same input parameters of this module
+The initial development pressure is computed using module
+<em><a href="r.futures.devpressure.html">r.futures.devpressure</a></em>.
+The same input parameters of this module
(<b>gamma</b>, <b>scaling factor</b> and <b>n_dev_neighbourhood</b>)
-are then used as input for <a href="r.futures.pga.html">
-r.futures.pga</a>.
+are then used as input for
+<em><a href="r.futures.pga.html">r.futures.pga</a></em>.
<h3>Scenarios</h3>
Scenarios involving policies that encourage infill versus sprawl
More information about the grass-commit
mailing list