[GRASS-SVN] r59001 - grass/trunk/raster/r.report

[svn_grass at osgeo.org]

Author: annakrat
Date: 2014-02-11 07:15:05 -0800 (Tue, 11 Feb 2014)
New Revision: 59001

Modified:
   grass/trunk/raster/r.report/r.report.html
Log:
r.report: document undocumented feature of r.report - multiple maps report

Modified: grass/trunk/raster/r.report/r.report.html
===================================================================
--- grass/trunk/raster/r.report/r.report.html	2014-02-11 14:58:58 UTC (rev 59000)
+++ grass/trunk/raster/r.report/r.report.html	2014-02-11 15:15:05 UTC (rev 59001)
@@ -22,6 +22,11 @@
 column. Note that the statistics is always computed in the current
 geographical region.
 
+<p>
+When multiple (typically two) raster maps are specified, cross-tabulation
+table for each combination of categories in the raster maps will be computed
+and formatted in a human-readable way (see example).
+
 <h2>NOTES</h2>
 
 <!--
@@ -50,7 +55,8 @@
 
 <div class="code"><pre>
 r.report -n map=geology_30m units=mi,a sort=desc
-
+</pre></div>
+<div class="code"><pre>
 +-----------------------------------------------------------------------------+
 |                         RASTER MAP CATEGORY REPORT                          |
 |LOCATION: nc_spm_08_grass7                           Fri Dec  6 17:00:21 2013|
@@ -81,8 +87,51 @@
 |-----------------------------------------------------------------------------|
 |TOTAL                                                  | 77.606534|49,668.182|
 +-----------------------------------------------------------------------------+
-</div>
+</pre></div>
+Report areas for each category of land use for each zipcode (included only part of the table):
 
+<div class="code"><pre>
+r.report map=zipcodes at PERMANENT,landclass96 at PERMANENT units=h,p
+</pre></div>
+<div class="code"><pre>
++-----------------------------------------------------------------------------+
+|                         RASTER MAP CATEGORY REPORT                          |
+|LOCATION: nc_spm_08_latest                           Tue Feb 11 10:10:46 2014|
+|-----------------------------------------------------------------------------|
+|          north: 228527.25    east: 644971                                   |
+|REGION    south: 215018.25    west: 629980                                   |
+|          res:        28.5    res:    28.5                                   |
+|-----------------------------------------------------------------------------|
+|MASK: none                                                                   |
+|-----------------------------------------------------------------------------|
+|MAPS: South West Wake: Zipcode areas derived from vector map (zipcodes at PERMAN|
+|        South-West Wake county: Simplified landuse classes (landclass96 at PERMA|
+|-----------------------------------------------------------------------------|
+|                   Category Information                    |          |   %  |
+|    #|description                                          |  hectares| cover|
+|-----------------------------------------------------------------------------|
+|27511|CARY                                                 |  1053.813|  5.20|
+|     |-----------------------------------------------------|----------|------|
+|     |1|developed. . . . . . . . . . . . . . . . . . . . . |   197.214| 18.71|
+|     |3|herbaceous . . . . . . . . . . . . . . . . . . . . |    25.017|  2.37|
+|     |4|shrubland. . . . . . . . . . . . . . . . . . . . . |    58.563|  5.56|
+|     |5|forest . . . . . . . . . . . . . . . . . . . . . . |   771.313| 73.19|
+|     |6|water. . . . . . . . . . . . . . . . . . . . . . . |     1.625|  0.15|
+|     |*|no data. . . . . . . . . . . . . . . . . . . . . . |     0.081|  0.01|
+|-----------------------------------------------------------|----------|------|
+|27513|CARY                                                 |   204.525|  1.01|
+|     |-----------------------------------------------------|----------|------|
+|     |1|developed. . . . . . . . . . . . . . . . . . . . . |    32.571| 15.93|
+|     |3|herbaceous . . . . . . . . . . . . . . . . . . . . |     6.011|  2.94|
+|     |4|shrubland. . . . . . . . . . . . . . . . . . . . . |    51.659| 25.26|
+|     |5|forest . . . . . . . . . . . . . . . . . . . . . . |   114.284| 55.88|
+|-----------------------------------------------------------|----------|------|
+...
+|-----------------------------------------------------------------------------|
+|TOTAL                                                      |22,968.900|100.00|
++-----------------------------------------------------------------------------+
+</pre></div>
+
 <h2>SEE ALSO</h2>
 
 <em>