← Back to branch summary

~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

Viewing changes to raster/r.univar/r3.univar.html

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
raster/r.univar/r3.univar.html
 
1
<h2>DESCRIPTION</h2>
 
2
 
 
3
<em>r3.univar</em> calculates the univariate statistics for a 3D raster map.
 
4
This includes the number of cells counted, minimum and maximum cell values,
 
5
range, arithmetic mean, population variance, standard deviation,
 
6
coefficient of variation, and sum. Statistics are calculated separately for every
 
7
category/zone found in the <b>zones</b> input map if given.
 
8
If the <b>-e</b> extended statistics flag is given the 1st quartile, median,
 
9
3rd quartile, and given <b>percentile</b> are calculated.
 
10
If the <b>-g</b> flag is given the results are presented in a format suitable
 
11
for use in a shell script.
 
12
If the <b>-t</b> flag is given the results are presented in tabular format
 
13
with the given field separator. The table can immediately be converted to a
 
14
vector attribute table which can then be linked to a vector, e.g. the vector
 
15
that was rasterized to create the <b>zones</b> input raster.
 
16
 
 
17
<h2>NOTES</h2>
 
18
 
 
19
As with most GRASS raster3d modules, <em>r3.univar</em> operates on the voxel
 
20
array defined by the current 3d region settings, not the original extent and
 
21
resolution of the input map. See <em><a href="g.region.html">g.region</a></em>.
 
22
<p>
 
23
This module can use large amounts of system memory when the <b>-e</b>
 
24
extended statistics flag is used with a very large region setting. If the
 
25
region is too large the module should exit gracefully with a memory allocation
 
26
error. Basic statistics can be calculated using any size input region.
 
27
 
 
28
<!-- no rast3D support?
 
29
<p>
 
30
The <em>r.quantile</em> module will be significantly more efficient for
 
31
calculating percentiles with large maps.
 
32
-->
 
33
 
 
34
<h2>EXAMPLE</h2>
 
35
 
 
36
Computing univariate statistics of a 3D raster with randomly generated values:
 
37
 
 
38
<div class="code"><pre>
 
39
# generate random map
 
40
r3.mapcalc "random_0_1 = rand(0., 1)" -s
 
41
 
 
42
# compute univariate statistics
 
43
r3.univar map=random_0_1
 
44
</pre></div>
 
45
 
 
46
 
 
47
<h2>TODO</h2>
 
48
 
 
49
<i>mode, skewness, kurtosis</i>
 
50
 
 
51
 
 
52
 
 
53
<h2>SEE ALSO</h2>
 
54
 
 
55
<em>
 
56
<a href="g.region.html">g.region</a>,
 
57
<a href="r.univar.html">r.univar</a>,
 
58
<a href="r.mode.html">r.mode</a>,
 
59
<a href="r.quantile.html">r.quantile</a>,
 
60
<a href="r.series.html">r.series</a>,
 
61
<a href="r3.stats.html">r3.stats</a>,
 
62
<a href="r.statistics.html">r.statistics</a>,
 
63
<a href="v.rast.stats.html">v.rast.stats</a>,
 
64
<a href="v.univar.html">v.univar</a>
 
65
</em>
 
66
 
 
67
 
 
68
<h2>AUTHORS</h2>
 
69
 
 
70
Soeren Gebbert<br>
 
71
Code is based on r.univar from<br>
 
72
Hamish Bowman, Otago University, New Zealand<br>
 
73
and Martin Landa<br>
 
74
Zonal loop by Markus Metz
 
75
 
 
76
 
 
77
<p><i>Last changed: $Date: 2014-10-14 04:57:21 +0200 (Tue, 14 Oct 2014) $</i>