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

# r.circle(1grass)

Creates a raster map containing concentric rings around a given point.

## NAME

**r.circle**  - Creates a raster map containing concentric rings around a given point.

## KEYWORDS

raster, buffer, geometry, circle

## SYNOPSIS

**r.circle**\
 **r.circle --help**\
 **r.circle** \[-**b**\] **output**=*name* **coordinates**=*east,north*  \[**min**=*float*\]   \[**max**=*float*\]   \[**multiplier**=*float*\]   \[--**overwrite**\]  \[--**help**\]  \[--**verbose**\]  \[--**quiet**\]  \[--**ui**\]

### Flags:

- **-b**

  Generate binary raster map

- **--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

- **coordinates**=*east,north* **\[required\]**

  The coordinate of the center (east,north)

- **min**=*float*

  Minimum radius for ring/circle map (in meters)

- **max**=*float*

  Maximum radius for ring/circle map (in meters)

- **multiplier**=*float*

  Data value multiplier

## DESCRIPTION

*r.circle* creates an output raster map centered on the *x,y* values specified with the *coordinate* parameter, out to the edge of the current region. The output cell values increase linearly from the specified center. The *min* and *max* parameters control the inner and outer output raster map radii, respectively.

The *mult* parameter can be used to multiply the output raster cells by a common factor. Note that this parameter does not affect the output raster position or size; only the z-values are changed with this parameter.

Binary-output raster maps (solid circles of one value) can be created with the **-b** flag. Raster maps so created can be used to create binary filters for use in *i.ifft* (inverse Fourier transformations; apply filter with *r.mask*).

## EXAMPLES

Generate a raster circle at current map center with a radius of 300m and outwardly increasing raster values:\

```
EASTCENTER=`g.region -c |  awk ’ /center easting:/ { print $3 }’`
NORTHCENTER=`g.region -c | awk ’ /center northing:/ { print $3 }’`
r.circle output=circle coordinate=${EASTCENTER},${NORTHCENTER} max=300
```

Generate a binary raster ring around current map center with an inner radius of 500m and an outer radius of 1000m:\

```
EASTCENTER=`g.region -c |  awk ’ /center easting:/ { print $3 }’`
NORTHCENTER=`g.region -c | awk ’ /center northing:/ { print $3 }’`
r.circle -b output=circle coordinate=${EASTCENTER},${NORTHCENTER} min=500 max=1000
```

## SEE ALSO

*g.region,* *g.remove,* *g.rename,* *i.fft,* *i.ifft,* *r.mask*

## AUTHORS

Bill Brown, U.S. Army Construction Engineering Research Laboratory\
 Additional flag/min/max parameter by Markus Neteler, University of Hannover

## SOURCE CODE

Available at: r.circle source code (history)

Accessed: Monday Feb 24 17:50:33 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