GRASS logo

Note: A new GRASS GIS stable version has been released: GRASS GIS 7. Go directly to the new manual page here

NAME

r.random.cells - Generates random cell values with spatial dependence.

KEYWORDS

raster, random, cell

SYNOPSIS

r.random.cells
r.random.cells help
r.random.cells output=name distance=float [seed=integer] [--overwrite] [--verbose] [--quiet]

Flags:

--overwrite
Allow output files to overwrite existing files
--verbose
Verbose module output
--quiet
Quiet module output

Parameters:

output=name
Name for output raster map
distance=float
Maximum distance of spatial correlation (value(s) >= 0.0)
seed=integer
Random seed (SEED_MIN >= value >= SEED_MAX) (default [random])

DESCRIPTION

r.random.cells generates a random sets of cells that are at least distance apart. The cells are numbered from 1 to the numbers of cells generated. Random cells will not be generated in areas masked off.

Detailed parameter description

output
Random cells. Each random cell has a unique non-zero cell value ranging from 1 to the number of cells generated. The heuristic for this algorithm is to randomly pick cells until there are no cells outside of the chosen cell's buffer of radius distance.
distance
Determines the minimum distance the centers of the random cells will be apart.
seed
Specifies the random seed that r.random.cells will use to generate the cells. If the random seed is not given, r.random.cells will get a seed from the process ID number.

NOTES

The original purpose for this program was to generate independent random samples of cells in a study area. The distance value is the amount of spatial autocorrelation for the map being studied.

REFERENCES

Random Field Software for GRASS by Chuck Ehlschlaeger

As part of my dissertation, I put together several programs that help GRASS (4.1 and beyond) develop uncertainty models of spatial data. I hope you find it useful and dependable. The following papers might clarify their use:

SEE ALSO

r.random.surface, r.random

AUTHOR

Charles Ehlschlaeger; National Center for Geographic Information and Analysis, University of California, Santa Barbara.

Last changed: $Date: 2011-10-07 12:53:04 -0700 (Fri, 07 Oct 2011) $


Main index - raster index - Full index

© 2003-2016 GRASS Development Team