manual: minor cleanup; v.mkgrid example screenshot added; keyword added

git-svn-id: https://svn.osgeo.org/grass/grass/trunk@62831 15284696-431f-4ddb-bdfa-cd5b030d7da7

vector/v.kcv/main.c

@@ -55,6 +55,7 @@ int main(int argc, char *argv[])
     G_add_keyword(_("vector"));
     G_add_keyword(_("statistics"));
     G_add_keyword(_("points"));
+    G_add_keyword(_("point pattern"));
     module->description =
 	_("Randomly partition points into test/train sets.");
 

vector/v.mkgrid/main.c

@@ -67,6 +67,8 @@ int main(int argc, char *argv[])
     module = G_define_module();
     G_add_keyword(_("vector"));
     G_add_keyword(_("geometry"));
+    G_add_keyword(_("grid"));
+    G_add_keyword(_("point pattern"));
     module->description = _("Creates a vector map of a user-defined grid.");
 
     vectname = G_define_standard_option(G_OPT_V_OUTPUT);

vector/v.mkgrid/v.mkgrid.html

@@ -60,7 +60,7 @@ just use <em>d.grid -w</em> from the projected location for the same effect):
 v.mkgrid map=p2min_grid grid=10,12 position=coor coor=167:52E,47:06S box=0:02,0:02
 </pre></div>
 
-<h3>Creating a point pattern</h3>
+<h3>Creating a simple point pattern</h3>
 
 North Carolina sample dataset example, creating a 1km spaced point grid
 based on the current region extent defined by the "elevation" map:
@@ -70,7 +70,33 @@ g.region rast=elevation -p
 # we use the row/column/resolution information to determine the grid= values:
 v.mkgrid -p map=pointpattern grid=13,15 position=region breaks=1
 </pre></div>
+<p>
+
+<h3>Creating a regular point pattern</h3>
+
+North Carolina sample dataset example, creating a regular spaced point grid
+based on the current region extent defined by the "elevation" map, using
+a two-step approach:
+
+<div class="code"><pre>
+# create first set of points, covering extent of "elevation" raster map
+g.region rast=elevation -p
+v.mkgrid -p map=pointpattern1 grid=13,15 position=region breaks=1
+
+# shift grid by half point distance (map units)
+g.region n=n+500 w=w+500 e=e+500 s=s+500 -p
+
+# create second set of points
+v.mkgrid -p map=pointpattern2 grid=13,15 position=region breaks=1
+
+# merge into final point pattern
+v.patch input=pointpattern1,pointpattern2 output=pointpattern3
+</pre></div>
 
+<center>
+<img src="v_mkgrid_ppattern.png"><br>
+Different point patterns for sampling design
+</center>
 
 <h2>SEE ALSO</h2>
 

vector/v.normal/main.c

@@ -72,6 +72,7 @@ int main(int argc, char **argv)
     G_add_keyword(_("vector"));
     G_add_keyword(_("statistics"));
     G_add_keyword(_("points"));
+    G_add_keyword(_("point pattern"));
     module->description = _("Tests for normality for vector points.");
 
     parm.input = G_define_standard_option(G_OPT_V_MAP);

vector/v.normal/v.normal.html

@@ -29,25 +29,29 @@ giving an index, ranges of indices, or multiple thereof.
 
 <h2>EXAMPLE</h2>
 
-<!-- do a meaning ful example -->
+<!-- do a meaningful example -->
+Compute the sample skewness and kurtosis, Geary's
+a-statistic and an approximate normal transformation,
+extreme normal deviates, and Royston's W for the
+<em>random</em> vector points:
+
 <div class="code"><pre>
+g.region rast=elevation -p
 v.random random n=200
-v.db.addtable random col="elev double precision"
-v.what.rast random rast=elevation.10m col=elev
-v.normal random tests=1-3,14 col=elev
+v.db.addtable random colum="elev double precision"
+v.what.rast random rast=elevation column=elev
+v.normal random tests=1-3,14 column=elev
 </pre></div>
 
-computes the sample skewness and kurtosis, Geary's
-a-statistic and an approximate normal transformation,
-extreme normal deviates, and Royston's W for the
-<em>random</em> vector points.
-
 <!-- TODO: find references , e.g.
      http://www.itl.nist.gov/div898/handbook/eda/section3/eda35.htm
 -->
 
 <h2>SEE ALSO</h2>
+
+<em>
 <a href="v.univar.html">v.univar</a>
+</em>
 
 <h2>AUTHOR</h2>
 
@@ -56,4 +60,5 @@ extreme normal deviates, and Royston's W for the
 <br>when he was at:
 <a href="https://engineering.purdue.edu/ABE/">Agricultural Engineering</a>
 <a href="http://www.purdue.edu/">Purdue University</a>
+
 <p><i>Last changed: $Date$</i>

vector/v.perturb/main.c

@@ -1,10 +1,11 @@
 
 /****************************************************************************
  *
- * MODULE:       v.pertrub
+ * MODULE:       v.perturb
  * AUTHOR(S):    James Darrell McCauley darrell@mccauley-usa.com
  * 	         http://mccauley-usa.com/
- * PURPOSE:      
+ * PURPOSE:      Random location perturbations of vector points
+ *
  * COPYRIGHT:    (C) 1994-2009 by James Darrell McCauley and the GRASS Development Team
  *
  * Modification History:
@@ -62,6 +63,7 @@ int main(int argc, char **argv)
     G_add_keyword(_("geometry"));
     G_add_keyword(_("statistics"));
     G_add_keyword(_("random"));
+    G_add_keyword(_("point pattern"));
  
     module->description =
 	_("Random location perturbations of vector points.");

vector/v.qcount/main.c

@@ -59,7 +59,8 @@ int main(int argc, char **argv)
     module = G_define_module();
     G_add_keyword(_("vector"));
     G_add_keyword(_("statistics"));
-    module->description = _("Indices for quadrat counts of sites lists.");
+    G_add_keyword(_("point pattern"));
+    module->description = _("Indices for quadrat counts of vector point lists.");
 
     parm.input = G_define_standard_option(G_OPT_V_INPUT);
 

vector/v.qcount/v.qcount.html

@@ -13,59 +13,57 @@ This program may not work properly with lat-long data. It uses
 <em>hypot()</em> in two files: <em>count.c</em> and
 <em>findquads.c</em>.
 
+<!-- TODO: add example -->
+
 <h2>SEE ALSO</h2>
 
 <em><a href="v.random.html">v.random</a></em> 
 
-<p><em>Complete Spatial Randomness and Quadrat Methods</em>  - 
-GRASS Tutorial on <em>v.qcount</em>
-(only available as older file s.qcount-tutorial.ps),
+<h2>REFERENCES</h2>
 
-<p>General references include:
+<ul>
+<li><em>Complete Spatial Randomness and Quadrat Methods</em>  - GRASS 
+Tutorial on <em>v.qcount</em> (only available as older file 
+s.qcount-tutorial.ps)</li>
+</ul>
 
-<br>
-Noel A. C. Cressie.
-<em>Statistics for Spatial Data</em>.
+<p>
+General references include:
+
+<ul>
+<li>Noel A. C. Cressie. <em>Statistics for Spatial Data</em>.
 Wiley Series in Probability and Mathematical Statistics. John Wiley
-&amp; Sons, New York, NY, 1st edition, 1991.
+&amp; Sons, New York, NY, 1st edition, 1991.</li>
+<li>Brian D. Ripley. <em>Spatial Statistics</em>.
+John Wiley \&amp; Sons, New York, NY, 1981.</li>
+</ul>
 
-<br>
-Brian D. Ripley.
-<em>Spatial Statistics</em>.
-John Wiley \&amp; Sons, New York, NY, 1981.
+<p>
+References to the indices include:
 
-<p>References to the indices include:
-<br>
-F. N. David and P. G. Moore.
-Notes on contagious distributions in plant populations.
-<em>Annals of Botany</em>, 18:47-53, 1954.
+<ul>
+<li>F. N. David and P. G. Moore. Notes on contagious distributions in
+plant populations. <em>Annals of Botany</em>, 18:47-53, 1954.</li>
 
-<br>
-J. B. Douglas.  Clustering and aggregation.
-<em>Sankhya B</em>, 37:398-417, 1975.
+<li>J. B. Douglas.  Clustering and aggregation.
+<em>Sankhya B</em>, 37:398-417, 1975.</li>
 
-<br>
-R. A. Fisher, H. G. Thornton, and W. A. Mackenzie.
+<li>R. A. Fisher, H. G. Thornton, and W. A. Mackenzie.
 The accuracy of the plating method of estimating the density of
 bacterial populations.
-<em>Annals of Applied Biology</em>, 9:325-359, 1922.
-
-<br>
+<em>Annals of Applied Biology</em>, 9:325-359, 1922.</li>
 
-M. Lloyd. Mean crowding.
-<em>Journal of Animal Ecology</em>, 36:1-30, 1967.
+<li>M. Lloyd. Mean crowding.
+<em>Journal of Animal Ecology</em>, 36:1-30, 1967.</li>
 
-<br>
-M. Morista.
-Measuring the dispersion and analysis of distribution patterns.
+<li>M. Morista. Measuring the dispersion and analysis of distribution patterns.
 <em>Memoires of the Faculty of Science, Kyushu University, Series E.
-Biology</em>, 2:215-235, 1959.
+Biology</em>, 2:215-235, 1959.</li>
+</ul>
 
 <h2>BUGS</h2>
-<p>Timestamp not working for header part of counts output. (2000-10-28)
-<p>Please send all bug fixes and comments to the author
-or the GRASS development team. <br>
-<a href="http://grass.osgeo.org"><tt>http://grass.osgeo.org</tt></a>.
+
+Timestamp not working for header part of counts output. (2000-10-28)
 
 <h2>AUTHORS</h2>
 

vector/v.random/main.c

@@ -97,6 +97,7 @@ int main(int argc, char *argv[])
     G_add_keyword(_("sampling"));
     G_add_keyword(_("statistics"));
     G_add_keyword(_("random"));
+    G_add_keyword(_("point pattern"));
     module->description = _("Generates random 2D/3D vector points.");
 
     parm.output = G_define_standard_option(G_OPT_V_OUTPUT);

vector/v.random/v.random.html

@@ -6,7 +6,7 @@ current region using the selected random number generator.
 <p><em>v.random</em> can generate also 3D vector points or
 write random value to attribute table. Point height range or
 attribute value range is controlled by specifying zmin and zmax values.
-Both z values are included in range (<em>zmin <= z <= zmax</em>).
+Both z values are included in range (<em>zmin &lt;= z &lt;= zmax</em>).
 Generated random attribute value type can be controlled by column
 data type. Use <b>INTEGER</b> column type for integers and 
 <b>DOUBLE PRECISION</b> for floating point numbers. Integer values are
@@ -73,22 +73,15 @@ v.random input=landclass96 output=random_samples n=20 where="label = 'forest'" -
 
 <h2>SEE ALSO</h2>
 
-UNIX man pages for <em>rand(3)</em> and <em>drand48(3)</em>.
-<p><em>
+<em>
 <a href="g.region.html">g.region</a>,
 <a href="r.random.html">r.random</a>,
 <a href="v.perturb.html">v.perturb</a>,
-<a href="v.sample.html">v.sample</a>
-<a href="v.what.rast.html">v.what.rast</a>
+<a href="v.sample.html">v.sample</a>,
+<a href="v.what.rast.html">v.what.rast</a>,
 <a href="v.what.vect.html">v.what.vect</a>
 </em>
 
-<h2>BUGS</h2>
-
-The RNG used by 
-<em><a href="v.perturb.html">v.perturb</a></em>
-should probably be added to this program.<br>
-
 <h2>AUTHOR</h2>
 
 <a href="http://mccauley-usa.com/">James Darrell McCauley</a>