[GRASS-SVN] r72362 - grass-addons/grass7/imagery/i.segment.uspo

[svn_grass at osgeo.org]

Author: mlennert
Date: 2018-03-13 06:35:20 -0700 (Tue, 13 Mar 2018)
New Revision: 72362

Modified:
   grass-addons/grass7/imagery/i.segment.uspo/i.segment.uspo.html
Log:
i.segment.uspo: clarify weighting of components when using the f-function


Modified: grass-addons/grass7/imagery/i.segment.uspo/i.segment.uspo.html
===================================================================
--- grass-addons/grass7/imagery/i.segment.uspo/i.segment.uspo.html	2018-03-13 11:42:29 UTC (rev 72361)
+++ grass-addons/grass7/imagery/i.segment.uspo/i.segment.uspo.html	2018-03-13 13:35:20 UTC (rev 72362)
@@ -1,12 +1,17 @@
 <h2>DESCRIPTION</h2>
 
 <p><em>i.segment.uspo</em> provides unsupervised segmentation parameter
-optimization for <em><a href="i.segment.html">i.segment</a></em>. It runs
-segmentation across a user defined set of thresholds and minimum segment sizes,
-as well, for the mean shift algorithm, a set of spectral and spatial bandwiths. 
-For the mean shift algorithm, you can also activate adaptive bandwidth using
-the <em>-a</em> flag.
+optimization for <em><a href="i.segment.html">i.segment</a></em> determined
+by the compromise between intra-segment variance and inter-segment spatial 
+autocorrelation.
 
+
+<p>
+The module runs segmentation across a user defined set of thresholds and minimum
+segment sizes, as well, for the mean shift algorithm, a set of spectral and 
+spatial bandwiths. For the mean shift algorithm, you can also activate adaptive 
+bandwidth using the <em>-a</em> flag.
+
 <p>The user provides an imagery <b>group</b> and the name of an <b>output</b>
 text file where parameter and optimization values for all tested segmentations
 are stored. The user can either give a list of thresholds and minimum sizes, or
@@ -21,12 +26,18 @@
 
 <p>Two optimization functions are available via the <b>optimization_function</b>
 parameter: A simple sum of the normalized criteria values as defined by
-Espindola et al (2006), or the F-function as defined by Johnson et al (2015).
-
+Espindola et al (2006), or the F-function as defined by Johnson et al (2015). 
+When using the F-function, the user can determine the <b>f_function_alpha</b> 
+value which determines the relative weight of the intra-segment variance as
+compared to the inter-segment spatial autocorrelation. A value of 0.5 gives
+the former half weight of the latter, A value of 2 gives the former double
+weight than the latter.
+	
+<p>
 The optimization functions use intra-segment variance and inter-segment spatial
 autocorrelation. For the latter, the user can chose to use either <a
 href="https://en.wikipedia.org/wiki/Moran%27s_I">Moran's I</a> or <a
-href="https://en.wikipedia.org/wiki/Geary%27s_C">Geary's C</a>.
+href="https://en.wikipedia.org/wiki/Geary%27s_C">Geary's C</a>. 
 
 <p>The user can chose between non-hierarchical (default) and hierarchical 
 segmentation using the <b>h</b> flag. The latter uses each segmentation at a