---
name: "r.surf.gauss"
section: "1grass"
platform: "linux"
package: "grass-doc"
version: "8.4.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/r.surf.gauss"
---

# r.surf.gauss(1grass)

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

## 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: Monday Feb 24 17:50:54 2025

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

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