|
|
@@ -5,17 +5,18 @@ a raster map only for the parts covered by the specified vector map.
|
|
|
The vector map will be rasterized according to the raster map resolution.
|
|
|
Then univariate statistics are calculated per vector category (cat) from
|
|
|
the raster map and the results uploaded to the vector map attribute table.
|
|
|
-A new column is generated in the attribute table for each statistic requested
|
|
|
+A new column is generated in the attribute table for each statistic requested
|
|
|
in <b>method</b> (if not already present).
|
|
|
<p>
|
|
|
-The univariate statistics include the number of raster cells counted, minimum
|
|
|
+The univariate statistics include the number of raster cells counted,
|
|
|
+the number of raster NULL cells counted, minimum
|
|
|
and maximum cell values, range, average, <!-- r.univar: arithmetic mean -->
|
|
|
standard deviation, variance, coefficient of variation, sum, first quartile,
|
|
|
median, third quartile, and percentile.
|
|
|
|
|
|
<h2>NOTES</h2>
|
|
|
<em>v.rast.stats</em> is only meaningful for lines or polygons.
|
|
|
-<p>
|
|
|
+<p>
|
|
|
The module may take a long time to run if the raster region contains a large
|
|
|
number of cells. In this case the <b>--verbose</b> flag may be used to track
|
|
|
progress.
|
|
|
@@ -31,10 +32,10 @@ will be chopped off.
|
|
|
<p>If a MASK is present, it will be restored after the script finished.
|
|
|
The script changes temporarily to the resolution of the given raster map.
|
|
|
<p><!-- r.univar limitation -->
|
|
|
-Large amounts of system memory can be used when extended statistics
|
|
|
-(<em>first_quartile,median,third_quartile,percentile </em>) are being requested
|
|
|
-with a very large region setting. If the region is too large the module
|
|
|
-should display memory allocation errors. Basic statistics can be calculated
|
|
|
+Large amounts of system memory can be used when extended statistics
|
|
|
+(<em>first_quartile,median,third_quartile,percentile </em>) are being requested
|
|
|
+with a very large region setting. If the region is too large the module
|
|
|
+should display memory allocation errors. Basic statistics can be calculated
|
|
|
using any size input region.
|
|
|
|
|
|
<h2>EXAMPLES</h2>
|
|
|
@@ -46,7 +47,7 @@ Example to upload DEM statistics to ZIP codes vector map
|
|
|
g.copy vect=zipcodes_wake,myzipcodes_wake
|
|
|
# set computational region to DEM:
|
|
|
g.region raster=elevation -p
|
|
|
-# calculate DEM statistics, upload to vector map table:
|
|
|
+# calculate selected DEM statistics, upload to vector map table:
|
|
|
v.rast.stats myzipcodes_wake raster=elevation \
|
|
|
column_prefix=elev method=minimum,maximum,average,range,stddev,percentile \
|
|
|
percentile=95
|
|
|
@@ -59,7 +60,7 @@ v.univar myzipcodes_wake column=elev_range type=centroid
|
|
|
<h2>SEE ALSO</h2>
|
|
|
|
|
|
<em>
|
|
|
-<a href="r.univar.html">r.univar</a>,
|
|
|
+<a href="r.univar.html">r.univar</a>,
|
|
|
<a href="v.univar.html">v.univar</a>,
|
|
|
<a href="v.vect.stats.html">v.vect.stats</a>,
|
|
|
<a href="v.what.rast.html">v.what.rast</a>,
|
Markus Metz