Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages
v.random(1) Grass User's Manual v.random(1)

v.random - Generates random 2D/3D vector points.

vector, sampling, statistics, random, point pattern, stratified random sampling, level1

v.random --help
v.random [-zab] output=name npoints=integer [ restrict=name] [layer=string] [ cats=range] [where=sql_query] [ zmin=float] [zmax=float] [ seed=integer] [column=name] [ column_type=string] [--overwrite] [-- help] [--verbose] [--quiet] [--ui]

Create 3D output
Generate n points for each individual area (requires restrict parameter)
Do not build topology
Advantageous when handling a large number of points
Allow output files to overwrite existing files
Print usage summary
Verbose module output
Quiet module output
Force launching GUI dialog

output=name [required]
Name for output vector map
npoints=integer [required]
Number of points to be created
Name of input vector map
Restrict points to areas in input vector
Layer number or name (’-1’ for all layers)
A single vector map can be connected to multiple database tables. This number determines which table to use. When used with direct OGR access this is the layer name.
Default: -1
Category values
Example: 1,3,7-9,13
WHERE conditions of SQL statement without ’where’ keyword
Example: income < 1000 and population >= 10000
Minimum z height (needs -z flag or column name)
Default: 0.0
Maximum z height (needs -z flag or column name)
Default: 0.0
The seed to initialize the random generator. If not set the process ID is used
Name of column for z values
Writes z values to column
Type of column for z values
Options: integer, double precision
Default: double precision

v.random randomly generates vector points within the current region using the selected random number generator.
v.random can generate also 3D vector points or write random value to attribute table. Point height range or attribute value range is controlled by specifying zmin and zmax options. Both z values are included in range ( zmin <= z <= zmax). Generated random attribute value type can be controlled by column_type. Use integer column type for integers and double precision for floating point numbers. Integer values are calculated by rounding random floating point number.
To produce repeatable results a random seed can be set using the option seed.

If an restrict vector map with areas is specified, the location of random points is restricted to the selected areas. By default, the requested number of points are distributed across all areas.
If the -a flag is given, the requested number of points is generated for each individual area. For example, if 20 points should be generated and the input map has 100 individual areas, 2000 points will be generated in total.

All examples are based on the North Carolina sample dataset.

Generate 20 random points with binary attributes (only 0 or 1):
v.random output=binary_random npoints=20 zmin=0 zmax=1 column=’binary’ binary_random
v.univar -d binary_random
Calculating geometric distances between 20 primitives...
minimum: 148.515
maximum: 16572.8

Generate 20 random points with binary attributes (only 0 or 1):
v.random output=binary_random npoints=20 zmin=0 zmax=1 column=’binary’ column_type=integer binary_random

Generate 20 random 3D points using a specific random seed:
v.random seed=52 output=height_random npoints=40 zmin=110 zmax=170 -z
v.univar -d height_random
Calculating geometric distances between 40 primitives...
minimum: 334.889
maximum: 18351.9
range: 18017
sum: 5.38425e+06
mean: 7266.2
mean of absolute values: 7266.2
population standard deviation: 3563.95
skewness: 0.34703
Random points with different X, Y, and Z coordinates

Generate 3 random points only in selected polygons ("RALEIGH" related ZIP code areas):
v.random restrict=zipcodes_wake output=zipcodes_local_random_n3 npoints=3 where="ZIPNAME = ’RALEIGH’" -a
# visualization
d.mon wx0
d.vect zipcodes_wake
d.vect zipcodes_wake fcolor=yellow where="ZIPNAME = ’RALEIGH’"
d.vect zipcodes_local_random_n3 color=red icon=basic/circle
Fixed number of random points generated in selected polygons

To generate random adjacent polygons, first the centroids are generated as points, then a triangulation is run (North Carolina sample dataset:
g.region vector=nc_state
v.random output=randpoints6k npoints=6000
v.voronoi input=randpoints6k output=randareas6k -t randareas6k
v.category randareas6k option=print
# plot vector polygons
d.mon wx0
d.vect randareas6k -c
Random adjacent polygons from random points (here: used as centroids)
To eventually obtain isolated polygons, selected polygons can be extracted with v.extract.
These vector polygons can also be rasterized:
# rasterize polygons
# note: rastermaps must result in at least 6k pixel in this example
g.region vector=nc_state res=500 -p -a randareas6k out=randareas6k use=cat
r.colors randareas6k color=random
d.rast randareas6k

Generate 20 random samples from a raster map:
g.region -p raster=elevation
v.random output=random_samples npoints=20
v.db.addtable map=random_samples columns=’cat INTEGER, sample DOUBLE PRECISION’
v.what.rast map=random_samples raster=elevation column=sample random_samples

Generate 20 random points and sample attribute data from geology (vector) map:
g.region -p vector=geology
v.random output=random_samples npoints=20
v.db.addtable map=random_samples columns=’cat integer, geology varchar(100)’
v.what.vect map=random_samples column=geology query_map=geology query_layer=1 query_column=GEO_NAME random_samples

Generate 20 random points restricted to forested areas:
g.region -p raster=landclass96 -v input=landclass96 output=landclass96 type=area
v.random restrict=landclass96 output=random_samples npoints=20 where="label = ’forest’" layer=1
Random points only sampled in forested areas (stratified random sampling)

Generating n points for each individual area: in this example two random points in each water body:
g.region -p raster=landclass96 -v input=landclass96 output=landclass96 type=area
v.random restrict=landclass96 output=random_samples npoints=2 where="label = ’water’" layer=1 -a
Two random points sampled in each individual water body (stratified random sampling)

g.region, r.random, v.db.addtable, v.perturb, v.sample, v.univar, v.what.rast, v.what.vect
SQL support in GRASS GIS

James Darrell McCauley <>,
when he was at: Agricultural Engineering Purdue University
Last changed: $Date: 2018-04-06 19:51:18 +0200 (Fri, 06 Apr 2018) $

Available at: v.random source code (history)
Main index | Vector index | Topics index | Keywords index | Graphical index | Full index
© 2003-2018 GRASS Development Team, GRASS GIS 7.4.3 Reference Manual
GRASS 7.4.3

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.