## NAME

r.surf.gauss - Generates a raster map using gaussian random number generator.
Mean and standard deviation of gaussian deviates can be expressed by the user.

## KEYWORDS

raster, surface, random

## SYNOPSIS

r.surf.gauss
r.surf.gauss --help
r.surf.gauss output=name [mean=float] [sigma=float] [seed=integer] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

### Flags:

--overwrite
  Allow output files to overwrite existing files
--help
  Print usage summary
--verbose
  Verbose module output
--quiet
  Quiet module output
--ui
  Force launching GUI dialog

### Parameters:

output=name [required]
  Name for output raster map
mean=float
  Distribution mean
  Default: 0.0
sigma=float
  Standard deviation
  Default: 1.0
seed=integer
  Seed for random number generator
  The same seed can be used to obtain same results or random seed can be generated by other means.

## DESCRIPTION

r.surf.gauss produces a raster map of Gaussian deviates whose mean and standard deviation can be expressed by the user. It uses a Gaussian random number generator. It is essentially the same as r.surf.random, but uses a Gaussian random number generator instead.

## EXAMPLE

    g.region -p n=228500 s=215000 w=630000 e=645000 res=10
    r.surf.gauss out=gauss mean=0 sigma=10

    # check result
    r.univar gauss

Figure: Random Gaussian surface example (mean: 0; sigma: 10)

With the histogram tool the cell values versus count can be shown.

Figure: Histogram of random Gaussian surface example (mean: 0; sigma: 10)

## SEE ALSO

r.surf.contour, r.surf.fractal, r.surf.idw, r.surf.random, v.surf.rst

## AUTHOR

Jo Wood, ASSIST's home

## SOURCE CODE

Available at: r.surf.gauss source code (history)

Accessed: Wednesday Feb 04 01:00:01 2026

Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual