r.surf.gauss(1)

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 value for the random number generator
    Using the same seed ensures identical results, while a randomly generated seed produces different outcomes in each run.

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)

Latest change: Thursday Mar 06 19:23:31 2025 in commit: 5fd4234a4f6ab09eb244c67111a1db2d84b6d0fe

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

© 2003-2026 GRASS Development Team, GRASS 8.6.0dev Reference Manual