浏览代码

wildfire manual: cleanup

git-svn-id: https://svn.osgeo.org/grass/grass/trunk@62415 15284696-431f-4ddb-bdfa-cd5b030d7da7
Markus Neteler 10 年之前
父节点
当前提交
19eb08ed0b
共有 5 个文件被更改,包括 89 次插入60 次删除
  1. 24 13
      raster/r.ros/r.ros.html
  2. 35 18
      raster/r.spread/r.spread.html
  3. 30 10
      raster/r.spreadpath/r.spreadpath.html
  4. 0 12
      raster/wildfire/Makefile
  5. 0 7
      raster/wildfire/README

+ 24 - 13
raster/r.ros/r.ros.html

@@ -1,5 +1,12 @@
 <h2>DESCRIPTION</h2>
 
+<em>r.ros</em> is part of the wildfire simulation toolset. Preparational
+steps for the fire simulation are the calculation of the rate of spread (ROS)
+with <em>r.ros</em>, and the creating of spread map with <em>r.spread</em>.
+Eventually, the fire path(s) based on starting point(s) are calculated
+with <em>r.spreadpath</em>.
+<p>
+
 <em>r.ros</em> is used for fire (wildfire) modeling. The input is fuel model
 and moisture and the outputs are rate of spread (ROS) values.
 The module generates the base ROS value, maximum ROS value,
@@ -80,7 +87,7 @@ r.ros -s model=fire_model moisture_1h=1hour_moisture moisture_live=live_moisture
 <h2>NOTES</h2>
 
 <ol>
-  <li>r.ros is supposed to be run before running
+  <li><em>r.ros</em> is supposed to be run before running
     <em><a href="r.spread.html">r.spread</a></em> module.
     The combination of these two modules forms
     a simulation of the spread of wildfires.
@@ -102,37 +109,41 @@ r.ros -s model=fire_model moisture_1h=1hour_moisture moisture_live=live_moisture
 <ul>
   <li><b>Albini,</b> F. A., 1976, Computer-based models of wildland fire behavior:
     a user's manual, USDA Forest Service, Intermountain Forest and Range Experiment
-    Station, Ogden, Utah.
+    Station, Ogden, Utah.</li>
   <li><b>Andrews</b>, P. L., 1986, BEHAVE: fire behavior prediction and fuel
     modeling system -- BURN subsystem, Part 1, USDA Forest Service, Intermountain
-    Research Station, Gen. Tech. Rep. INT-194, Ogden, Utah.
+    Research Station, Gen. Tech. Rep. INT-194, Ogden, Utah.</li>
   <li><b>Chase</b>, Carolyn, H., 1984, Spotting distance from wind-driven
     surface fires -- extensions of equations for pocket calculators, US Forest
-    Service, Res. Note INT-346, Ogden, Utah.
+    Service, Res. Note INT-346, Ogden, Utah.</li>
   <li><b>Lathrop</b>, Richard G. and Jianping Xu, A geographic information
-    system-based approach for calculating spotting distance. (in preparation)
+    system-based approach for calculating spotting distance. (in preparation)</li>
   <li><b>Rothermel</b>, R. E., 1972, A mathematical model for predicting
     fire spread in wildland fuels, USDA Forest Service, Intermountain Forest
-    and Range Experiment Station, Res. Pap. INT-115, Ogden, Utah.
+    and Range Experiment Station, Res. Pap. INT-115, Ogden, Utah.</li>
   <li><b>Rothermel</b>, Richard, 1991, Predicting behavior and size of crown
     fires in the northern Rocky Mountains, US Forest Service, Res. Paper INT-438,
-    Ogden, Utah.
+    Ogden, Utah.</li>
   <li><b>Xu</b>, Jianping, 1994, Simulating the spread of wildfires using
     a geographic information system and remote sensing, Ph. D. Dissertation,
-    Rutgers University, New Brunswick, New Jersey.
+    Rutgers University, New Brunswick, Jersey
+    (<a href="https://dl.acm.org/citation.cfm?id=921466">ref</a>).</li>
 </ul>
 
 <h2>SEE ALSO</h2>
 
 <em>
-  <a href="g.region.html">g.region</a>,
-  <a href="r.slope.aspect.html">r.slope.aspect</a>,
-  <a href="r.spread.html">r.spread</a>,
-  <a href="r.spreadpath.html">r.spreadpath</a>
+<a href="g.region.html">g.region</a>,
+<a href="r.slope.aspect.html">r.slope.aspect</a>,
+<a href="r.spread.html">r.spread</a>,
+<a href="r.spreadpath.html">r.spreadpath</a>
 </em>
 
+Sample data download: <a href="http://grass.osgeo.org/download/sample-data/">firedemo.sh</a>
+(run this script within the "Fire simulation data set" location.
+
 <h2> AUTHOR</h2>
 
 Jianping Xu, Center for Remote Sensing and Spatial Analysis, Rutgers University.
 
-<p><i>Last changed: $Date$</i>
+<p><em>Last changed: $Date$</em>

+ 35 - 18
raster/r.spread/r.spread.html

@@ -1,5 +1,12 @@
 <h2>DESCRIPTION</h2>
 
+<em>r.spread</em> is part of the wildfire simulation toolset. Preparational
+steps for the fire simulation are the calculation of the rate of spread (ROS)
+with <em>r.ros</em>, and the creating of spread map with <em>r.spread</em>.
+Eventually, the fire path(s) based on starting point(s) are calculated
+with <em>r.spreadpath</em>.
+<p>
+
 Spread phenomena usually show uneven movement over space. Such unevenness
 is due to two reasons:
 
@@ -21,7 +28,7 @@ ellipses, and the spread phenomenon moves fastest toward apogees and slowest
 to perigees. The sizes and shapes of spread ellipses may vary cell by cell.
 So the overall spread shape is commonly not an ellipse.
 
-<p><I>r.spread </I>simulates elliptically anisotropic spread phenomena,
+<p><em>r.spread</em>simulates elliptically anisotropic spread phenomena,
 given three raster map layers about ROS (base ROS, maximum ROS and direction
 of the maximum ROS) plus a raster map layer showing the starting sources.
 These ROS layers define unique ellipses for all cell locations in the current
@@ -30,14 +37,15 @@ For some wildfire spread, these ROS layers can be generated by another
 GRASS raster program r.ros. The actual locations reached by a spread event
 are constrained by the actual spread origins and the elapsed spread time.
 
-<p><I>r.spread </I>optionally produces raster maps to contain backlink
+<p><em>r.spread</em>optionally produces raster maps to contain backlink
 UTM coordinates for each raster cell of the spread time map. The spread
 paths can be accurately traced based on the backlink information by
 <em><a href="r.spreadpath.html">r.spreadpath</a></em> module.
 
 <p>Part of the spotting function in r.spread is based on Chase (1984)
-and Rothermel (1983). More information on <I>r.spread</I>, <I><a href="r.ros.html">r.ros</a></I>
-and <I><a href="r.spreadpath.html">r.spreadpath</a></I> can be found in
+and Rothermel (1983). More information on <em>r.spread</em>,
+<em><a href="r.ros.html">r.ros</a></em> and
+<em><a href="r.spreadpath.html">r.spreadpath</a></em> can be found in
 Xu (1994).
 
 <p>Options <tt>spot_dist</tt>, <tt>w_speed</tt> and <tt>f_mois</tt> must all
@@ -97,28 +105,37 @@ accuracy for elliptical simulation significantly, without adding significantly
 extra running time. Further increasing the sample density will not gain
 much accuracy while requiring greatly additional running time.
 
-<h2>SEE ALSO</h2>
-
-<em><a href="r.cost.html">r.cost</a></em>,
-<!-- <em><a href="r.mask.html">r.mask</a></em>, -->
-<em><a href="r.spreadpath.html">r.spreadpath</a></em>,
-<em><a href="r.ros.html">r.ros</a></em>
-
 <h2>REFERENCES</h2>
-Chase, Carolyn, H., 1984, Spotting distance from wind-driven surface fires
+
+<ul>
+<li>Chase, Carolyn, H., 1984, Spotting distance from wind-driven surface fires
 -- extensions of equations for pocket calculators, US Forest Service, Res.
-Note INT-346, Ogden, Utah.
+Note INT-346, Ogden, Utah.</li>
 
-<p>Rothermel, R. C., 1983, How to predict the spread and intensity
+<li>Rothermel, R. C., 1983, How to predict the spread and intensity
 of forest and range fires. US Forest Service, Gen. Tech. Rep. INT-143.
-Ogden, Utah.
+Ogden, Utah.</li>
 
-<p>Xu, Jianping, 1994, Simulating the spread of wildfires using a
+<li>Xu, Jianping, 1994, Simulating the spread of wildfires using a
 geographic information system and remote sensing, Ph. D. Dissertation,
-Rutgers University, New Brunswick, New Jersey.
+Rutgers University, New Brunswick, New Jersey
+(<a href="https://dl.acm.org/citation.cfm?id=921466">ref</a>).</li>
+</ul>
+
+<h2>SEE ALSO</h2>
+
+<em>
+<a href="r.cost.html">r.cost</a>,
+<a href="r.mask.html">r.mask</a>,
+<a href="r.ros.html">r.ros</a>,
+<a href="r.spreadpath.html">r.spreadpath</a>
+</em>
+
+Sample data download: <a href="http://grass.osgeo.org/download/sample-data/">firedemo.sh</a>
+(run this script within the "Fire simulation data set" location.
 
 <h2>AUTHOR</h2>
 Jianping Xu and Richard G. Lathrop, Jr., Center for Remote Sensing and
 Spatial Analysis, Rutgers University.
 
-<p><i>Last changed: $Date$</i>
+<p><em>Last changed: $Date$</em>

+ 30 - 10
raster/r.spreadpath/r.spreadpath.html

@@ -1,5 +1,12 @@
 <h2>DESCRIPTION</h2>
 
+<em>r.spreadpath</em> is part of the wildfire simulation toolset. Preparational
+steps for the fire simulation are the calculation of the rate of spread (ROS)
+with <em>r.ros</em>, and the creating of spread map with <em>r.spread</em>.
+Eventually, the fire path(s) based on starting point(s) are calculated
+with <em>r.spreadpath</em>.
+<p>
+
 <em>r.spreadpath</em> recursively traces the least cost path backwards to
 the origin, given backlink information input map layers and target locations
 from where paths are to be traced. The backlink information map layers
@@ -23,25 +30,38 @@ coordinates.
 <dd>Name of input raster map layer containing backlink UTM northing coordinates.
 
 <dt><b>coordinate=</b><em>x,y[,x,y,x,y, ...]</em>
-<dd>Each x,y coordinate pair gives the easting and northing (respectively) geographic coordinates of a target point from which to backwards trace the least cost path. As many
-points as desired can be entered by the user.
+<dd>Each x,y coordinate pair gives the easting and northing 
+(respectively) geographic coordinates of a target point from which to 
+backwards trace the least cost path. As many points as desired can be 
+entered by the user.
 
 <dt><b>output=</b><em>name</em>
-<dd>Name of raster map layer to contain output. Also can be used as the map layer of the input target points. If so used, the input target point map will be overwritten by the output.
+<dd>Name of raster map layer to contain output. Also can be used as the 
+map layer of the input target points. If so used, the input target 
+point map will be overwritten by the output.
 </dl>
 
+<h2>REFERENCES</h2>
+
+<ul>
+<li>Xu, Jianping, 1994, Simulating the spread of wildfires using a
+geographic information system and remote sensing, Ph. D. Dissertation,
+Rutgers University, New Brunswick, New Jersey
+(<a href="https://dl.acm.org/citation.cfm?id=921466">ref</a>).</li>
+</ul>
+
 <h2>SEE ALSO</h2>
-<em><a href="r.spread.html">r.spread</a></em>,
-<em><a href="r.ros.html">r.ros</a></em>
 
+<em>
+<a href="r.spread.html">r.spread</a>,
+<a href="r.ros.html">r.ros</a>
+</em>
 
-<h2>REFERENCES</h2>
-Xu, Jianping, 1994, Simulating the spread of wildfires using a geographic
-information system and remote sensing, Ph. D. Dissertation, Rutgers University,
-New Brunswick, New Jersey.
+Sample data download: <a href="http://grass.osgeo.org/download/sample-data/">firedemo.sh</a>
+(run this script within the "Fire simulation data set" location.
 
 <h2>AUTHOR</h2>
 Jianping Xu and Richard G. Lathrop, Jr., Center for Remote Sensing and
 Spatial Analysis, Rutgers University.
 
-<p><i>Last changed: $Date$</i>
+<p><em>Last changed: $Date$</em>

+ 0 - 12
raster/wildfire/Makefile

@@ -1,12 +0,0 @@
-
-MODULE_TOPDIR = ../..
-
-SUBDIRS = \
-	r.ros \
-	r.spread \
-	r.spreadpath
-
-include $(MODULE_TOPDIR)/include/Make/Dir.make
-
-default: parsubdirs
-

+ 0 - 7
raster/wildfire/README

@@ -1,7 +0,0 @@
-A sample location is available from
-
-http://grass.osgeo.org/download/sample-data/
-
- Fire simulation data set:
- - sample data for r.ros, r.spread, and r.spreadpath fire simulation modules.
- - demo script: firedemo.sh (run within fire simulation data set)