NC examples added; HTML updated

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

scripts/d.polar/d.polar.html

@@ -49,7 +49,7 @@ g.region rast=aspect -p
 d.polar aspect
 </pre></div>
 
-<H2>SEE ALSO</H2>
+<h2>SEE ALSO</h2>
 
 <em>
 <a href="d.graph.html">d.graph</a>,

scripts/r.colors.stddev/r.colors.stddev.html

@@ -1,8 +1,8 @@
-<H2>DESCRIPTION</H2>
+<h2>DESCRIPTION</h2>
 
-<EM>r.colors.stddev</EM> set raster map color rules based on standard
+<em>r.colors.stddev</em> set raster map color rules based on standard
 deviations from a map's mean value, either as a continuous color gradient
-or in color bands per standard deviation from the mean.
+or in color bands per standard deviation (S.D.) from the mean.
 
 <p>
 With the color band option values less that 1 S.D. from the mean are
@@ -14,25 +14,28 @@ table at zero. Values more than two S.D. below the mean will be colored blue;
 values below the mean but less than 2 S.D. away will transition to white,
 and above the mean the colors will simularly transition to full red at +2 S.D.
 
+<h2>EXAMPLE</h2>
 
-<!--
-<h2>EXAMPLES</h2>
--->
+North Carolina sample dataset location:
 
+<div class="code"><pre>
+g.region rast=elevation -p
+r.colors.stddev elevation
+</pre></div>
 
-<H2>SEE ALSO</H2>
 
-<EM>
-<A HREF="r.colors.html">r.colors</A><BR>
-<A HREF="r.univar.html">r.univar</A><BR>
-<A HREF="v.colors.html">v.colors</A><BR>
-</EM>
+<h2>SEE ALSO</h2>
 
+<em>
+<a href="r.colors.html">r.colors</a>,
+<a href="r.univar.html">r.univar</a>,
+<a href="v.colors.html">v.colors</a>
+</em>
 
-<H2>AUTHOR</H2>
 
-Hamish Bowman<BR>
-<i>Dunedin, New Zealand</i>
+<h2>AUTHOR</h2>
+
+Hamish Bowman, <i>Dunedin, New Zealand</i>
 
 <p>
 <i>Last changed: $Date$</i>

scripts/r.fillnulls/r.fillnulls.html

@@ -1,20 +1,17 @@
-<H2>DESCRIPTION</H2>
+<h2>DESCRIPTION</h2>
 
-
-<EM><b>r.fillnulls</b></EM>  - Fills NULL (no data areas) in input map and
+<em>r.fillnulls</em> fills NULL pixels (no data areas) in input map and
 stores filled map to a new output map. The fill data are interpolated 
-from the no data area boundaries buffer using <EM>v.surf.rst</EM>
-spline interpolation.<br>
-
-<EM>(GRASS Shell Script)</EM>
+from the no data area boundaries buffer using <em>v.surf.rst</em>
+spline interpolation.
 
-<H2>NOTES</H2>
+<h2>NOTES</h2>
 
 Each area boundary buffer is set to three times the map resolution to get nominally
 three points around the edge. This way the algorithm interpolates into the hole with
 a trained slope and curvature at the edges, in order to avoid that such a flat plane
 is generated in a hole.
-<P>
+<p>
 During the interpolation following warning may occur:<p>
 
 <tt>
@@ -28,30 +25,54 @@ As the idea of <em>r.fillnulls</em> is to fill such holes, the user may
 ignore the warning. The interpolation will be continued. However, the user
 may pay attention to below notes.
 
-<H2>ATTENTION</H2>
+<h2>NOTES</h2>
 
-The algorithm is based on <EM><A HREF="v.surf.rst.html">v.surf.rst</A></EM>
+The algorithm is based on <em>v.surf.rst</em>
 regularized splines with tension interpolation module which interpolates the
 raster cell values for NULL data areas from the boundary values of the NULL
 data area. An eventual raster MASK is respected during the NULL data area(s)
 filling. The interpolated values are patched into the NULL data area(s) of
 the input map and saved into a new raster map.
 
-<H2>WARNING</H2>
+<h2>WARNING</h2>
 
 Depending on the shape of the NULL data area(s) problems may occur due to an
 insufficient number of input cell values for the interpolation process. Most
 problems will occur if a NULL data area reaches a large amount of the map
 boundary. The user will have to carefully check the result using
-<EM><a href="r.mapcalc.html">r.mapcalc</A></EM> (generating a difference map to the
-input map) and/or <EM><A HREF="d.what.rast.html">d.what.rast</A></EM> to
-query individual cell values.<p>
-
-<H2>SEE ALSO</H2>
-
-<EM><A HREF="r.fill.dir.html">r.fill.dir</A>, 
-<A HREF="v.surf.rst.html">v.surf.rst</A></EM>
-
+<em>r.mapcalc</em> (generating a difference map to the
+input map) and/or <em>d.what.rast</em> to query individual cell values.
+
+<h2>EXAMPLE</h2>
+
+In this example, the SRTM elevation map in the
+North Carolina sample dataset location is filtered for outlier
+elevation values; missing pixels are then re-interpolated to obtain
+a complete elevation map:
+
+<div class="code"><pre>
+g.region rast=elev_srtm_30m -p
+d.mon wx0
+d.histogram elev_srtm_30m
+# remove too low elevations (esp. lakes)
+r.mapcalc "elev_srtm_30m_filt = if(elev_srtm_30m &lt; 50.0, null(), elev_srtm_30m)"
+d.histogram elev_srtm_30m_filt
+d.rast elev_srtm_30m_filt
+r.fillnulls input=elev_srtm_30m_filt output=elev_srtm_30m_complete tension=20
+d.histogram elev_srtm_30m_complete
+d.rast elev_srtm_30m_complete
+</pre></div>
+
+
+<h2>SEE ALSO</h2>
+
+<em>
+<a href="r.fill.dir.html">r.fill.dir</a>, 
+<a href="r.mapcalc.html">r.mapcalc</a>, 
+<a href="v.surf.rst.html">v.surf.rst</a>
+</em>
+
+<h2>REFERENCES</h2>
 <P> Mitas, L., Mitasova, H., 1999, Spatial Interpolation. In: P.Longley,
 M.F. Goodchild, D.J. Maguire, D.W.Rhind (Eds.), Geographical Information
 Systems: Principles, Techniques, Management and Applications, Wiley,

scripts/r.grow/r.grow.html

@@ -1,6 +1,5 @@
 <h2>DESCRIPTION</h2>
 
-
 <em>r.grow</em> adds cells around the perimeters of all areas
 in a user-specified raster map layer and stores the output in
 a new raster map layer. The user can use it to grow by one or
@@ -16,7 +15,6 @@ the <b>metric</b> parameter): <i>Euclidean</i>, <i>Manhattan</i>, and
 <i>Maximum</i>. 
 
 <p>
-
 The <i>Euclidean distance</i> or <i>Euclidean metric</i> is the "ordinary" distance 
 between two points that one would measure with a ruler, which can be 
 proven by repeated application of the Pythagorean theorem. 
@@ -28,7 +26,6 @@ Cells grown using this metric would form isolines of distance that are
 circular from a given point, with the distance given by the <b>radius</b>.
 
 <p>
-
 The <i>Manhattan metric</i>, or <i>Taxicab geometry</i>, is a form of geometry in 
 which the usual metric of Euclidean geometry is replaced by a new 
 metric in which the distance between two points is the sum of the (absolute) 
@@ -44,7 +41,6 @@ where cells grown using this metric would form isolines of distance that are
 rhombus-shaped from a given point. 
 
 <p>
-
 The <i>Maximum metric</i> is given by the formula
 
 <div class="code"><pre>d(dx,dy) = max(abs(dx),abs(dy))</pre></div>
@@ -52,18 +48,28 @@ The <i>Maximum metric</i> is given by the formula
 where the isolines of distance from a point are squares.
 
 <p>
-
 If there are two cells which are equal candidates to grow into an empty space, 
 <em>r.grow</em> will choose the northernmost candidate; if there are multiple 
 candidates with the same northing, the westernmost is chosen. 
 
+<h2>EXAMPLE</h2>
+
+In this example, the lakes map in the
+North Carolina sample dataset location is buffered:
+
+<div class="code"><pre>
+g.region rast=lakes -p
+r.grow input=lakes output=lakes_grown_50m radius=10
+</pre></div>
+
 <h2>SEE ALSO</h2>
 
-<em><a href="r.buffer.html">r.buffer</a></em><br>
-<em><a href="r.patch.html">r.patch</a></em>
+<em>
+<a href="r.buffer.html">r.buffer</a>,
+<a href="r.patch.html">r.patch</a>
+</em>
 
 <p>
-
 <em><a href="http://en.wikipedia.org/wiki/Euclidean_metric">Wikipedia Entry: Euclidean Metric</a></em><br>
 <em><a href="http://en.wikipedia.org/wiki/Manhattan_metric">Wikipedia Entry: Manhattan Metric</a></em>
 

scripts/r.mask/r.mask.html

@@ -7,16 +7,16 @@ control raster operations.
 The MASK is only applied when <em>reading</em> an existing GRASS raster map,
 for example when used in a module as an input map.
 
-The MASK will block out certain areas of a raster map from analysis and/or display, by
-"hiding" them from sight of other GRASS modules. Data falling within the bounaries of the MASK 
-can be modified and operated upon by other GRASS raster modules; data
-falling outside the MASK is treated as if it were NULL.
+The MASK will block out certain areas of a raster map from analysis and/or
+display, by "hiding" them from sight of other GRASS modules. Data falling
+within the bounaries of the MASK can be modified and operated upon by other
+GRASS raster modules; data falling outside the MASK is treated as if it were NULL.
 <p>
 Because the MASK is actually only a reclass map named "MASK", it can be
 copied, renamed, removed, and used in analyses, just like other GRASS
 raster map layers.  The user should be aware that a MASK remains in
 place until a user renames it to something other than "MASK", or removes
-it using "<tt>r.mask -r</tt>" or <em><a HREF="g.remove.html">g.remove</a></em>.
+it using "<tt>r.mask -r</tt>" or <em>g.remove</em>.
 
 <p>
 Grid cells in the MASK map containing <tt>0</tt> or <tt>NULL</tt>
@@ -27,8 +27,8 @@ data to pass through unaltered.
 To restore raster operations to normal (i.e., all cells of the current region),
 remove the MASK file by setting the <b>-r</b> remove MASK flag. In this case, a
 dummy value must also be given for the input parameter.
-A MASK also can&nbsp;be removed by using <em><a href="g.remove.html">g.remove</a></em>
-or by renaming it to any other name with <em><a href="g.rename.html">g.rename</a></em>.
+A MASK also can be removed by using <em>g.remove</em>
+or by renaming it to any other name with <em>g.rename</em>.
 
 
 <h2>NOTES</h2>
@@ -47,55 +47,49 @@ be changed with r.quant).
 
 <em>r.mask</em> uses <em>r.reclass</em> to create a reclassification of an
 existing raster map and name it MASK. A reclass map takes up less space, but
-is affected by any changes to the underlying map from which it was created. The user 
-can select category values from the input raster to use in the MASK with the <em>maskcats</em> parameter; 
-if <em>r.mask</em> is run from the command line, the category values listed in <em>maskcats</em> 
-must be quoted (see example below).
+is affected by any changes to the underlying map from which it was created.
+The user can select category values from the input raster to use in the MASK
+with the <em>maskcats</em> parameter; if <em>r.mask</em> is run from the
+command line, the category values listed in <em>maskcats</em> must be quoted
+(see example below).
 <p>
 
 Somewhat similar program functions to those performed by
-<em>r.mask</em> can be done using
-<em><a HREF="r.mapcalc.html">r.mapcalc</a></em>, 
-<em><a HREF="g.region.html">g.region</a></em>,
-and other programs.
-
-<p>
-<em>(GRASS Shell Script)</em>
+<em>r.mask</em> can be done using <em>r.mapcalc</em>, 
+<em>g.region</em>, and other commands.
 
 <h2>EXAMPLES</h2>
-Creating a raster mask:
+
+Creating a raster mask, for showing only elevations of lakes:
 <div class="code"><pre>
-<b>r.mask input=</b>geology
-MASK created. All subsequent raster operations
-will be limited to MASK area
-Removing or renaming raster file named MASK will
-restore raster operations to normal
-[Raster MASK present]
+r.mask input=lakes
+# statistics only for elevation pixels in the lakes:
+r.univar elevation
 </pre></div>
 
 Removing a raster mask with the -r flag:
 <div class="code"><pre>
-<b>r.mask -r input=</b>anything_you_wish
-Removing raster &lt;MASK&gt;
-Raster MASK removed
+r.mask -r
 </pre></div>
 
-Creating a mask from categories 3 through 6 in the spearfish 'geology' raster map:
+Creating a mask from categories 3 through 6 in the North Carolina
+'geology_30m' raster map:
 <div class="code"><pre>
-<b>r.mask input=</b>geology <b>maskcats=</b>"3 thru 6"
-MASK created. All subsequent raster operations
-will be limited to MASK area
-Removing or renaming raster file named MASK will
-restore raster operations to normal
-[Raster MASK present]
+g.region rast=geology_30m -p
+r.category geology_30m
+d.mon wx0
+d.rast geology_30m
+r.mask input=geology_30m maskcats="217 thru 720"
+d.erase
+d.rast geology_30m
 </pre></div>
 
 <h2>SEE ALSO</h2>
 <em>
 <a HREF="g.region.html">g.region</a>,
 <a HREF="r.mapcalc.html">r.mapcalc</a>,
-<a href="r.reclass.html">r.reclass</a>
-<a href="g.remove.html">g.remove</a>
+<a href="r.reclass.html">r.reclass</a>,
+<a href="g.remove.html">g.remove</a>,
 <a href="g.rename.html">g.rename</a>
 </em>
 

scripts/r.out.xyz/r.out.xyz.html

@@ -1,42 +1,51 @@
-<H2>DESCRIPTION</H2>
+<h2>DESCRIPTION</h2>
 
-The <EM>r.out.xyz</EM> module will export a raster map as a list of x,y,z
+The <em>r.out.xyz</em> module exports a raster map as a list of x,y,z
 values into an ASCII text file.
-<P>
-<EM>(GRASS Shell Script)</EM>
+<p>
 
-<H2>NOTES</H2>
+<h2>NOTES</h2>
 
 This module will not export x,y coordinates for raster cells containing
 a NULL value. This includes cells masked by a raster MASK.
-<P>
+<p>
 This module, as all GRASS raster modules, will export cells based on the
-current region settings. See the <EM>g.region</EM> module for details.
-<P>
-The <EM>r.out.ascii</EM> module should be used to export an array (of
+current region settings. See the <em>g.region</em> module for details.
+<p>
+The <em>r.out.ascii</em> module should be used to export an array (of
 size row x column) containing z values.
-<P>
-<EM>r.out.xyz</EM> is simply a front-end to "<tt>r.stats -1gn</tt>".
+<p>
+<em>r.out.xyz</em> is simply a front-end to "<tt>r.stats -1gn</tt>".
 
-<H2>TODO</H2>
+<h2>EXAMPLE</h2>
+
+In this example, a LiDAR elevation map in the
+North Carolina sample dataset location is exported to CSV format.
+
+<div class="code"><pre>
+g.region rast=elev_lid792_1m -p
+r.out.xyz input=elev_lid792_1m output=elev_lid792_1m.csv fs=","
+</pre></div>
+
+<h2>TODO</h2>
 
 Implement this script as a <EM>r.out.ascii</EM> option?
 
 
-<H2>SEE ALSO</H2>
+<h2>SEE ALSO</h2>
 
-<EM>
-<A HREF="g.region.html">g.region</A>,
-<A HREF="r.mask.html">r.mask</A>
-<A HREF="r.out.ascii.html">r.out.ascii</A>,
-<A HREF="r.stats.html">r.stats</A>
-</EM>
+<em>
+<a href="g.region.html">g.region</a>,
+<a href="r.mask.html">r.mask</a>
+<a href="r.out.ascii.html">r.out.ascii</a>,
+<a href="r.stats.html">r.stats</a>
+</em>
 
-<H2>AUTHOR</H2>
+<h2>AUTHOR</h2>
 
-M. Hamish Bowman<BR>
-<i>Dept. Marine Science<BR>
+M. Hamish Bowman<br>
+<i>Dept. Marine Science<br>
 Otago University, New Zealand</i>
 
-<P>
+<p>
 <i>Last changed: $Date$</i>

scripts/r.reclass.area/r.reclass.area.html

@@ -3,6 +3,18 @@
 <em>r.reclass.area</em> reclasses a raster map greater or
 less than a user specified area size (in hectares).
 
+<h2>EXAMPLE</h2>
+
+In this example, the ZIP code map in the
+North Carolina sample dataset location is filtered for large areas:
+
+<div class="code"><pre>
+g.region rast=zipcodes -p
+r.report zipcodes unit=h
+# extract only areas &gt; 2000 ha:
+r.reclass.area input=zipcodes output=zipcodes_larger2000ha greater=2000
+</pre></div>
+
 <h2>SEE ALSO</h2>
 
 <em><a HREF="r.reclass.html">r.reclass</a></em><br>

scripts/r.tileset/r.tileset.html

@@ -60,38 +60,32 @@ http services.
 
 <h2>EXAMPLES</h2>
 
-<dl>
-<dt>
-<span class="code"><tt>
-r.tileset sourceproj=+init=epsg:4326 maxrows=1024 maxcols=2048
-</tt></span>
-
-<dd>Generates tiles in latitude longitude that cover the current
+Generates tiles in latitude longitude that cover the current
 region, each tile will be less than 1024 cells high and 2048 cells
-across. The bounds and sizes of tiles in the output are separated by |
-
-<dt>
-<span class="code"><tt>
-r.tileset sourceproj=+init=epsg:4326 overlap=2 -w region=ne-rio
-</tt></span>
+across. The bounds and sizes of tiles in the output are separated by | (pipe):
+<p></p>
+<div class="code"><pre>
+r.tileset sourceproj=+init=epsg:4326 maxrows=1024 maxcols=2048
+</pre></div>
 
-<dd>Generates tiles in latitude longitude projection that cover the
+Generates tiles in latitude longitude projection that cover the
 named region "ne-rio". The tiles will have 2 cells of overlap. The
-output format will be strings like the bbox requests for WMS servers.
-
-<dt>
-<span class="code"><tt>
-r.tileset sourceproj=`g.proj -j location=IrishGrid` maxrows=400 maxcols=300 overlap=3 -g
-</tt></span>
+output format will be strings like the bbox requests for WMS servers:
+<p>
+<div class="code"><pre>
+r.tileset sourceproj=+init=epsg:4326 overlap=2 -w region=ne-rio
+</pre></div>
 
-<dd>Generates tiles in the projection of the location
+Generates tiles in the projection of the location
 "IrishGrid". Each tile will be less than 300x400 cells in size, with 3
 cells of overlap in the top and right sides of each tile. The output
 is in a format where each line is in shell script style. The
 substitution <code>`g.proj -j location=IrishGrid`</code> will only
-work in a unix style shell.
-</dl>
-
+work in a unix style shell:
+<p>
+<div class="code"><pre>
+r.tileset sourceproj=`g.proj -j location=IrishGrid` maxrows=400 maxcols=300 overlap=3 -g
+</pre></div>
 
 <h2>BUGS</h2>