[GRASS-SVN] r48097 - in grass/trunk/scripts: d.polar
r.colors.stddev r.fillnulls r.grow r.mask r.out.xyz
r.reclass.area r.tileset
svn_grass at osgeo.org
svn_grass at osgeo.org
Sat Sep 3 12:25:02 EDT 2011
Author: neteler
Date: 2011-09-03 09:25:01 -0700 (Sat, 03 Sep 2011)
New Revision: 48097
Modified:
grass/trunk/scripts/d.polar/d.polar.html
grass/trunk/scripts/r.colors.stddev/r.colors.stddev.html
grass/trunk/scripts/r.fillnulls/r.fillnulls.html
grass/trunk/scripts/r.grow/r.grow.html
grass/trunk/scripts/r.mask/r.mask.html
grass/trunk/scripts/r.out.xyz/r.out.xyz.html
grass/trunk/scripts/r.reclass.area/r.reclass.area.html
grass/trunk/scripts/r.tileset/r.tileset.html
Log:
NC examples added; HTML updated
Modified: grass/trunk/scripts/d.polar/d.polar.html
===================================================================
--- grass/trunk/scripts/d.polar/d.polar.html 2011-09-03 15:49:02 UTC (rev 48096)
+++ grass/trunk/scripts/d.polar/d.polar.html 2011-09-03 16:25:01 UTC (rev 48097)
@@ -49,7 +49,7 @@
d.polar aspect
</pre></div>
-<H2>SEE ALSO</H2>
+<h2>SEE ALSO</h2>
<em>
<a href="d.graph.html">d.graph</a>,
Modified: grass/trunk/scripts/r.colors.stddev/r.colors.stddev.html
===================================================================
--- grass/trunk/scripts/r.colors.stddev/r.colors.stddev.html 2011-09-03 15:49:02 UTC (rev 48096)
+++ grass/trunk/scripts/r.colors.stddev/r.colors.stddev.html 2011-09-03 16:25:01 UTC (rev 48097)
@@ -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 @@
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>
Modified: grass/trunk/scripts/r.fillnulls/r.fillnulls.html
===================================================================
--- grass/trunk/scripts/r.fillnulls/r.fillnulls.html 2011-09-03 15:49:02 UTC (rev 48096)
+++ grass/trunk/scripts/r.fillnulls/r.fillnulls.html 2011-09-03 16:25:01 UTC (rev 48097)
@@ -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>
+from the no data area boundaries buffer using <em>v.surf.rst</em>
+spline interpolation.
-<EM>(GRASS Shell Script)</EM>
+<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 @@
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>
+<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>SEE ALSO</H2>
+<h2>EXAMPLE</h2>
-<EM><A HREF="r.fill.dir.html">r.fill.dir</A>,
-<A HREF="v.surf.rst.html">v.surf.rst</A></EM>
+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 < 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,
Modified: grass/trunk/scripts/r.grow/r.grow.html
===================================================================
--- grass/trunk/scripts/r.grow/r.grow.html 2011-09-03 15:49:02 UTC (rev 48096)
+++ grass/trunk/scripts/r.grow/r.grow.html 2011-09-03 16:25:01 UTC (rev 48097)
@@ -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 @@
<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 @@
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 @@
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 @@
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>
Modified: grass/trunk/scripts/r.mask/r.mask.html
===================================================================
--- grass/trunk/scripts/r.mask/r.mask.html 2011-09-03 15:49:02 UTC (rev 48096)
+++ grass/trunk/scripts/r.mask/r.mask.html 2011-09-03 16:25:01 UTC (rev 48097)
@@ -7,16 +7,16 @@
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 @@
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 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 @@
<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.
+<em>r.mask</em> can be done using <em>r.mapcalc</em>,
+<em>g.region</em>, and other commands.
-<p>
-<em>(GRASS Shell Script)</em>
-
<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 <MASK>
-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>
Modified: grass/trunk/scripts/r.out.xyz/r.out.xyz.html
===================================================================
--- grass/trunk/scripts/r.out.xyz/r.out.xyz.html 2011-09-03 15:49:02 UTC (rev 48096)
+++ grass/trunk/scripts/r.out.xyz/r.out.xyz.html 2011-09-03 16:25:01 UTC (rev 48097)
@@ -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>
Modified: grass/trunk/scripts/r.reclass.area/r.reclass.area.html
===================================================================
--- grass/trunk/scripts/r.reclass.area/r.reclass.area.html 2011-09-03 15:49:02 UTC (rev 48096)
+++ grass/trunk/scripts/r.reclass.area/r.reclass.area.html 2011-09-03 16:25:01 UTC (rev 48097)
@@ -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 > 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>
Modified: grass/trunk/scripts/r.tileset/r.tileset.html
===================================================================
--- grass/trunk/scripts/r.tileset/r.tileset.html 2011-09-03 15:49:02 UTC (rev 48096)
+++ grass/trunk/scripts/r.tileset/r.tileset.html 2011-09-03 16:25:01 UTC (rev 48097)
@@ -60,39 +60,33 @@
<h2>EXAMPLES</h2>
-<dl>
-<dt>
-<span class="code"><tt>
+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 | (pipe):
+<p></p>
+<div class="code"><pre>
r.tileset sourceproj=+init=epsg:4326 maxrows=1024 maxcols=2048
-</tt></span>
+</pre></div>
-<dd>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>
+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:
+<p>
+<div class="code"><pre>
r.tileset sourceproj=+init=epsg:4326 overlap=2 -w region=ne-rio
-</tt></span>
+</pre></div>
-<dd>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>
-
-<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>
<ul>
More information about the grass-commit
mailing list