~ubuntu-branches/ubuntu/wily/grass/wily

« back to all changes in this revision

Viewing changes to raster/r.random.cells/r.random.cells.html

Tags: 7.0.0~rc1+ds1-1~exp1
* New upstream release candidate.
* Repack upstream tarball, remove precompiled Python objects.
* Add upstream metadata.
* Update gbp.conf and Vcs-Git URL to use the experimental branch.
* Update watch file for GRASS 7.0.
* Drop build dependencies for Tcl/Tk, add build dependencies:
  python-numpy, libnetcdf-dev, netcdf-bin, libblas-dev, liblapack-dev
* Update Vcs-Browser URL to use cgit instead of gitweb.
* Update paths to use grass70.
* Add configure options: --with-netcdf, --with-blas, --with-lapack,
  remove --with-tcltk-includes.
* Update patches for GRASS 7.
* Update copyright file, changes:
  - Update copyright years
  - Group files by license
  - Remove unused license sections
* Add patches for various typos.
* Fix desktop file with patch instead of d/rules.
* Use minimal dh rules.
* Bump Standards-Version to 3.9.6, no changes.
* Use dpkg-maintscript-helper to replace directories with symlinks.
  (closes: #776349)
* Update my email to use @debian.org address.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<h2>DESCRIPTION</h2>
 
2
 
 
3
<em>r.random.cells</em> generates a random sets of cells that are at
 
4
least <b>distance</b> apart. The cells are numbered from 1 to the
 
5
numbers of cells generated. Random cells will not be generated in
 
6
areas masked off.
 
7
 
 
8
<h3>Detailed parameter description</h3>
 
9
 
 
10
<dl>
 
11
<dt><b>output</b></dt>
 
12
<dd>Random cells. Each random cell has a unique non-zero cell value
 
13
ranging from 1 to the number of cells generated. The heuristic for
 
14
this algorithm is to randomly pick cells until there are no cells
 
15
outside of the chosen cell's buffer of radius <b>distance</b>.</dd>
 
16
 
 
17
<dt><b>distance</b></dt>
 
18
<dd>Determines the minimum distance the centers of the random cells
 
19
will be apart.</dd>
 
20
 
 
21
<dt><b>seed</b></dt>
 
22
<dd>Specifies the random seed that
 
23
<em>r.random.cells</em> will use to generate the cells. If the random seed
 
24
is not given,<em> r.random.cells</em> will get a seed from the process ID
 
25
number.</dd>
 
26
 
 
27
</dl>
 
28
 
 
29
<h2>NOTES</h2>
 
30
 
 
31
The original purpose for this program was to generate independent
 
32
random samples of cells in a study area. The <b>distance</b> value is
 
33
the amount of spatial autocorrelation for the map being studied. 
 
34
 
 
35
<!-- The amount of spatial autocorrelation can be determined by
 
36
using <em>r.2Dcorrelogram</em> with
 
37
<em>r.2Dto1D</em>, or <em>r.1Dcorrelogram</em>. With <b>distance</b> set to
 
38
zero, the <b>output</b> map will number each non-masked cell from 1 to the
 
39
number of non-masked cells in the study region. -->
 
40
 
 
41
<h2>EXAMPLE</h2>
 
42
 
 
43
North Carolina sample dataset example:
 
44
 
 
45
<div class="code"><pre>
 
46
g.region n=228500 s=215000 w=630000 e=645000 res=100 -p
 
47
r.random.cells output=random_500m distance=500
 
48
 
 
49
# optionally set 0 to NULL
 
50
r.null random_500m setnull=0
 
51
</pre></div>
 
52
 
 
53
<h2>REFERENCES</h2>
 
54
Random Field Software for GRASS GIS by Chuck Ehlschlaeger
 
55
 
 
56
<p>  As part of my dissertation, I put together several programs that help
 
57
GRASS (4.1 and beyond) develop uncertainty models of spatial data. I hope
 
58
you find it useful and dependable. The following papers might clarify their
 
59
use:
 
60
 
 
61
<ul>
 
62
<li> Ehlschlaeger, C.R., Shortridge, A.M., Goodchild, M.F., 1997. 
 
63
 Visualizing spatial data uncertainty using animation. 
 
64
 Computers &amp; Geosciences 23, 387-395. doi:10.1016/S0098-3004(97)00005-8</li>
 
65
 
 
66
<li><a href="http://www.geo.hunter.cuny.edu/~chuck/paper.html">Modeling
 
67
Uncertainty in Elevation Data for Geographical Analysis</a>, by
 
68
Charles R. Ehlschlaeger, and Ashton M.  Shortridge. Proceedings of the
 
69
7th International Symposium on Spatial Data Handling, Delft,
 
70
Netherlands, August 1996.</li>
 
71
 
 
72
<li><a href="http://www.geo.hunter.cuny.edu/~chuck/acm/paper.html">Dealing
 
73
with Uncertainty in Categorical Coverage Maps: Defining, Visualizing,
 
74
and Managing Data Errors</a>, by Charles Ehlschlaeger and Michael
 
75
Goodchild.  Proceedings, Workshop on Geographic Information Systems at
 
76
the Conference on Information and Knowledge Management, Gaithersburg
 
77
MD, 1994.</li>
 
78
 
 
79
<li><a href="http://www.geo.hunter.cuny.edu/~chuck/gislis/gislis.html">Uncertainty
 
80
in Spatial Data: Defining, Visualizing, and Managing Data
 
81
Errors</a>, by Charles Ehlschlaeger and Michael
 
82
Goodchild. Proceedings, GIS/LIS'94, pp. 246-253, Phoenix AZ,
 
83
1994.</li>
 
84
</ul>
 
85
 
 
86
<h2>SEE ALSO</h2>
 
87
 
 
88
<em>
 
89
<!--r.1Dcorrelogram, 
 
90
r.2Dcorrelogram, 
 
91
r.2Dto1D, -->
 
92
<a href="r.random.surface.html">r.random.surface</a>,
 
93
<a href="r.random.html">r.random</a>
 
94
</em> 
 
95
 
 
96
<h2>AUTHOR</h2>
 
97
 
 
98
Charles Ehlschlaeger; National Center for Geographic Information and
 
99
Analysis, University of California, Santa Barbara.
 
100
 
 
101
<p><i>Last changed: $Date: 2014-01-10 00:26:55 +0100 (Fri, 10 Jan 2014) $</i>