[GRASS-SVN] r69538 - grass/trunk/raster/r.sim/r.sim.water
svn_grass at osgeo.org
svn_grass at osgeo.org
Tue Sep 20 02:18:44 PDT 2016
Author: martinl
Date: 2016-09-20 02:18:44 -0700 (Tue, 20 Sep 2016)
New Revision: 69538
Modified:
grass/trunk/raster/r.sim/r.sim.water/r.sim.water.html
Log:
r.sim.water: manual syntax clean-up - parameters in bold
Modified: grass/trunk/raster/r.sim/r.sim.water/r.sim.water.html
===================================================================
--- grass/trunk/raster/r.sim/r.sim.water/r.sim.water.html 2016-09-19 21:51:39 UTC (rev 69537)
+++ grass/trunk/raster/r.sim/r.sim.water/r.sim.water.html 2016-09-20 09:18:44 UTC (rev 69538)
@@ -1,6 +1,6 @@
<h2>DESCRIPTION</h2>
-<i>r.sim.water</i> is a landscape scale simulation model
+<em>r.sim.water</em> is a landscape scale simulation model
of overland flow designed for spatially variable terrain, soil, cover
and rainfall excess conditions. A 2D shallow water flow is described by
the bivariate form of Saint Venant equations. The numerical solution is based
@@ -8,15 +8,15 @@
the modeled quantity. Green's function Monte Carlo method, used to solve the equation,
provides robustness necessary for spatially variable conditions and high
resolutions (Mitas and Mitasova 1998). The key inputs of the model include
-elevation (<i>elevation</i> raster map), flow gradient vector given by
-first-order partial derivatives of elevation field (<i>dx</i> and <i>dy</i>
-raster maps), rainfall excess rate (<i>rain</i> raster map or <i>rain_value</i> single
+elevation (<b>elevation</b> raster map), flow gradient vector given by
+first-order partial derivatives of elevation field (<b>dx</b> and <b>dy</b>
+raster maps), rainfall excess rate (<b>rain</b> raster map or <b>rain_value</b> single
value) and a surface roughness coefficient given by Manning's n
-(<i>man</i> raster map or <i>man_value</i> single value). Partial
+(<b>man</b> raster map or <b>man_value</b> single value). Partial
derivatives raster maps can be computed along with interpolation of a DEM using
-the -d option in <a href="v.surf.rst.html">v.surf.rst</a> module. If elevation raster
+the -d option in <em><a href="v.surf.rst.html">v.surf.rst</a></em> module. If elevation raster
map is already provided, partial derivatives can be computed using
-<a href="r.slope.aspect.html">r.slope.aspect</a> module. Partial derivatives are used
+<em><a href="r.slope.aspect.html">r.slope.aspect</a></em> module. Partial derivatives are used
to determine the direction and magnitude of water flow velocity. To include a
predefined direction of flow, map algebra can be used to replace terrain-derived
partial derivatives with pre-defined partial derivatives in selected grid cells such
@@ -39,22 +39,22 @@
saturated hydraulic conductivity rates based on field measurements or using
reference values which can be found in literature.
Optionally, user can provide an overland flow infiltration rate map
-<i>infil</i> or a single value <i>infil_value</i> in [mm/hr] that control the rate of
+<b>infil</b> or a single value <b>infil_value</b> in [mm/hr] that control the rate of
infiltration for the already flowing water, effectively reducing the flow depth and
discharge.
Overland flow can be further controlled by permeable check dams or similar type of structures,
the user can provide a map of these structures and their permeability ratio
-in the map <i>flow_control</i> that defines the probability of particles to pass
+in the map <b>flow_control</b> that defines the probability of particles to pass
through the structure (the values will be 0-1).
<p>
-Output includes a water depth raster map <i>depth</i> in [m], and a water discharge
-raster map <i>discharge</i> in [m3/s]. Error of the numerical solution can be analyzed using
-the <i>error</i> raster map (the resulting water depth is an average, and err is its RMSE).
-The output vector points map <i>output_walkers</i> can be used to analyze and visualize
+Output includes a water depth raster map <b>depth</b> in [m], and a water discharge
+raster map <b>discharge</b> in [m3/s]. Error of the numerical solution can be analyzed using
+the <b>error</b> raster map (the resulting water depth is an average, and err is its RMSE).
+The output vector points map <b>output_walkers</b> can be used to analyze and visualize
spatial distribution of walkers at different simulation times (note that
the resulting water depth is based on the density of these walkers).
-<!--Number of the output walkers is controlled by the <i>density</i> parameter, which controls
+<!--Number of the output walkers is controlled by the <b>density</b> parameter, which controls
how many walkers used in simulation should be written into the output. -->
<!-- from
http://www.ing.unitn.it/~grass/conferences/GRASS2002/proceedings/proceedings/pdfs/Mitasova_Helena_2.pdf
@@ -62,13 +62,13 @@
The spatial distribution of numerical error associated with path sampling solution can be
analysed using the output error raster file [m]. This error is a function of the number
of particles used in the simulation and can be reduced by increasing the number of walkers
-given by parameter <i>nwalkers</i>.
+given by parameter <b>nwalkers</b>.
<!--(<font color="#ff0000"> toto treba upresnit/zmenit, lebo nwalk ide prec</font>). -->
-Duration of simulation is controlled by the <i>niterations</i> parameter. The default value
+Duration of simulation is controlled by the <b>niterations</b> parameter. The default value
is 10 minutes, reaching the steady-state may require much longer time,
depending on the time step, complexity of terrain, land cover and size of the area.
Output walker, water depth and discharge maps can be saved during simulation using
-the time series flag <i>-t</i> and <i>output_step</i> parameter
+the time series flag <b>-t</b> and <b>output_step</b> parameter
defining the time step in minutes for writing output files.
Files are saved with a suffix representing time since the start of simulation in minutes
(e.g. wdepth.05, wdepth.10).
@@ -82,12 +82,12 @@
<p>
Overland flow is routed based on partial derivatives of elevation
field or other landscape features influencing water flow. Simulation
-equations include a diffusion term (<i>diffusion_coeff</i> parameter) which enables
+equations include a diffusion term (<b>diffusion_coeff</b> parameter) which enables
water flow to overcome elevation depressions or obstacles when water depth exceeds
-a threshold water depth value (<i>hmax)</i>, given in [m]. When it is reached,
-diffusion term increases as given by <i>halpha</i> and advection term
+a threshold water depth value (<b>hmax)</b>, given in [m]. When it is reached,
+diffusion term increases as given by <b>halpha</b> and advection term
(direction of flow) is given as "prevailing" direction of flow computed
-as average of flow directions from the previous <i>hbeta</i> number of grid cells.
+as average of flow directions from the previous <b>hbeta</b> number of grid cells.
<h2>NOTES</h2>
@@ -149,15 +149,13 @@
r.mapcalc "infilt = if(elevation.10m, 0.0, null())"
# simulate
-r.sim.water elevation=elevation.10m dx=elev_dx dy=elev_dy \
- rain=rain man=manning infil=infilt \
- nwalkers=5000000 depth=depth
+r.sim.water elevation=elevation.10m dx=elev_dx dy=elev_dy rain=rain man=manning infil=infilt nwalkers=5000000 depth=depth
</pre></div>
<p>
<center>
<img src="r_sim_water.png" alt="r.sim.water generated depth map"><br>
-<i>Water depth map in the Spearfish (SD) area</i>
+<i>Figure: Water depth map in the Spearfish (SD) area</i>
</center>
@@ -169,32 +167,8 @@
ERROR: nwalk (7000001) > maxw (7000000)!
</pre></div>
-then a lower <em>nwalkers</em> parameter value has to be selected.
+then a lower <b>nwalkers</b> parameter value has to be selected.
-<h2>SEE ALSO</h2>
-
-<em>
-<a href="v.surf.rst.html">v.surf.rst</a>,
-<a href="r.slope.aspect.html">r.slope.aspect</a>,
-<a href="r.sim.sediment.html">r.sim.sediment</a>
-</em>
-
-<h2>AUTHORS</h2>
-
-Helena Mitasova, Lubos Mitas<br>
-North Carolina State University<br>
-<i><a href="mailto:hmitaso at unity.ncsu.edu">hmitaso at unity.ncsu.edu</a></i>
-
-<p>
-Jaroslav Hofierka<br>
-GeoModel, s.r.o. Bratislava, Slovakia<br>
-<i><a href="mailto:hofi at geomodel.sk">hofierka at geomodel.sk</a></i>
-
-<p>
-Chris Thaxton<br>
-North Carolina State University<br>
-<i><a href="mailto:csthaxto at unity.ncsu.edu">csthaxto at unity.ncsu.edu</a></i>
-
<h2>REFERENCES</h2>
<ul>
@@ -237,4 +211,28 @@
The International Series in Engineering and Computer Science: Volume 773. Springer New York Inc, p. 406.
</ul>
+<h2>SEE ALSO</h2>
+
+<em>
+<a href="v.surf.rst.html">v.surf.rst</a>,
+<a href="r.slope.aspect.html">r.slope.aspect</a>,
+<a href="r.sim.sediment.html">r.sim.sediment</a>
+</em>
+
+<h2>AUTHORS</h2>
+
+Helena Mitasova, Lubos Mitas<br>
+North Carolina State University<br>
+<i><a href="mailto:hmitaso at unity.ncsu.edu">hmitaso at unity.ncsu.edu</a></i>
+
+<p>
+Jaroslav Hofierka<br>
+GeoModel, s.r.o. Bratislava, Slovakia<br>
+<i><a href="mailto:hofi at geomodel.sk">hofierka at geomodel.sk</a></i>
+
+<p>
+Chris Thaxton<br>
+North Carolina State University<br>
+<i><a href="mailto:csthaxto at unity.ncsu.edu">csthaxto at unity.ncsu.edu</a></i>
+
<p><i>Last changed: $Date$</i>
More information about the grass-commit
mailing list