1v.perturb(1)                GRASS GIS User's Manual               v.perturb(1)
2
3
4

NAME

6       v.perturb  - Random location perturbations of vector points.
7

KEYWORDS

9       vector, geometry, statistics, random, point pattern, level1
10

SYNOPSIS

12       v.perturb
13       v.perturb --help
14       v.perturb  [-sb]  input=name   [layer=string]   output=name  [distribu‐
15       tion=string]  parameters=float[,float,...]  [minimum=float]   [seed=in‐
16       teger]   [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]
17
18   Flags:
19       -s
20           Generate random seed (result is non-deterministic)
21
22       -b
23           Do not build topology
24           Advantageous when handling a large number of points
25
26       --overwrite
27           Allow output files to overwrite existing files
28
29       --help
30           Print usage summary
31
32       --verbose
33           Verbose module output
34
35       --quiet
36           Quiet module output
37
38       --ui
39           Force launching GUI dialog
40
41   Parameters:
42       input=name [required]
43           Name of input vector map
44           Or data source for direct OGR access
45
46       layer=string
47           Layer number or name (’-1’ for all layers)
48           A  single  vector map can be connected to multiple database tables.
49           This number determines which table to use. When  used  with  direct
50           OGR access this is the layer name.
51           Default: -1
52
53       output=name [required]
54           Name for output vector map
55
56       distribution=string
57           Distribution of perturbation
58           Options: uniform, normal
59           Default: uniform
60
61       parameters=float[,float,...] [required]
62           Parameter(s) of distribution
63           If the distribution is uniform, only one parameter, the maximum, is
64           needed. For a normal distribution, two  parameters,  the  mean  and
65           standard deviation, are required.
66
67       minimum=float
68           Minimum deviation in map units
69           Default: 0.0
70
71       seed=integer
72           Seed for random number generation
73

DESCRIPTION

75       v.perturb  reads  a vector map of points and writes the same points but
76       perturbs the eastings and northings by adding either a uniform or  nor‐
77       mal  delta value. Perturbation means that a variating spatial deviation
78       is added to the coordinates.
79

NOTES

81       The uniform distribution is always centered about zero.  The associated
82       parameter  is  constrained  to be positive and specifies the maximum of
83       the distribution; the minimum is the negation  of  that  parameter.  Do
84       perturb  into  a  ring  around the center, the minimum parameter can be
85       used.
86
87       Usually, the mean (first parameter) of the normal distribution is  zero
88       (i.e.,  the  distribution  is centered at zero). The standard deviation
89       (second parameter) is naturally constrained to be positive.
90
91       Output vector points are not guaranteed to be contained within the cur‐
92       rent geographic region.
93

EXAMPLES

95   Random, uniformly distributed selection
96       To  create  a  random,  uniformly distributed selection of possible new
97       points with a radius of 100,000 map units, use the following command:
98       v.perturb input=comm_colleges output=uniform_perturb parameters=100000
99       Your map should look similar to this figure:
100       Figure: Map showing the actual community college points  and  uniformly
101       random chosen points.
102
103   Normal distributed selection
104       For a normal distribution with a mean of 5000 and standard deviation of
105       2000, use the following command:
106       v.perturb input=comm_colleges output=normal_perturb distribution=normal parameters=5000,2000
107       Figure: Map showing the actual community college  points  and  normally
108       random  chosen  and colored points. Notice that each point is closer to
109       the original point.
110
111   Normal distributed selection with a minimum value
112       In order to include a minimum value of 500, use the following command:
113       v.perturb input=comm_colleges output=min_perturb distribution=normal parameters=100000,1000 minimum=500
114

SEE ALSO

116        v.random, v.univar
117

AUTHORS

119       James Darrell McCauley
120       when he was at: Agricultural Engineering Purdue University
121
122       Random number generators originally written in FORTRAN by Wes  Peterson
123       and translated to C using f2c.
124

SOURCE CODE

126       Available at: v.perturb source code (history)
127
128       Accessed: Mon Jun 20 16:47:12 2022
129
130       Main  index  | Vector index | Topics index | Keywords index | Graphical
131       index | Full index
132
133       © 2003-2022 GRASS Development Team, GRASS GIS 8.2.0 Reference Manual
134
135
136
137GRASS 8.2.0                                                       v.perturb(1)