1r.circle(1)                   Grass User's Manual                  r.circle(1)
2
3
4

NAME

6       r.circle   -  Creates a raster map containing concentric rings around a
7       given point.
8

KEYWORDS

10       raster, buffer, geometry, circle
11

SYNOPSIS

13       r.circle
14       r.circle --help
15       r.circle   [-b]   output=name    coordinates=east,north     [min=float]
16       [max=float]   [multiplier=float]   [--overwrite]  [--help]  [--verbose]
17       [--quiet]  [--ui]
18
19   Flags:
20       -b
21           Generate binary raster map
22
23       --overwrite
24           Allow output files to overwrite existing files
25
26       --help
27           Print usage summary
28
29       --verbose
30           Verbose module output
31
32       --quiet
33           Quiet module output
34
35       --ui
36           Force launching GUI dialog
37
38   Parameters:
39       output=name [required]
40           Name for output raster map
41
42       coordinates=east,north [required]
43           The coordinate of the center (east,north)
44
45       min=float
46           Minimum radius for ring/circle map (in meters)
47
48       max=float
49           Maximum radius for ring/circle map (in meters)
50
51       multiplier=float
52           Data value multiplier
53

DESCRIPTION

55       This module creates an output raster map centered  on  the  x,y  values
56       specified with the coordinate parameter, out to the edge of the current
57       region.  The output cell values increase linearly  from  the  specified
58       center.  The  min and max parameters control the inner and outer output
59       raster map radii, respectively.
60
61       The mult parameter can be used to multiply the output raster cells by a
62       common  factor.   Note  that  this parameter does not affect the output
63       raster position or size; only the z-values are changed with this param‐
64       eter.
65
66       Binary-output  raster  maps (solid circles of one value) can be created
67       with the -b flag. Raster maps so created can be used to  create  binary
68       filters  for use in i.ifft (inverse Fourier transformations; apply fil‐
69       ter with r.mask).
70

EXAMPLES

72       Generate a raster circle at current map center with a  radius  of  300m
73       and outwardly increasing raster values:
74       EASTCENTER=`g.region -c |  awk ’ /center easting:/ { print $3 }’`
75       NORTHCENTER=`g.region -c | awk ’ /center northing:/ { print $3 }’`
76       r.circle output=circle coordinate=${EASTCENTER},${NORTHCENTER} max=300
77       Generate  a  binary raster ring around current map center with an inner
78       radius of 500m and an outer radius of 1000m:
79       EASTCENTER=`g.region -c |  awk ’ /center easting:/ { print $3 }’`
80       NORTHCENTER=`g.region -c | awk ’ /center northing:/ { print $3 }’`
81       r.circle -b output=circle coordinate=${EASTCENTER},${NORTHCENTER} min=500 max=1000
82

SEE ALSO

84        g.region, g.remove, g.rename, i.fft, i.ifft, r.mask
85

AUTHOR

87       Bill Brown, U.S. Army Construction Engineering Research Laboratory
88       Additional flag/min/max parameter by Markus Neteler, University of Han‐
89       nover
90

SOURCE CODE

92       Available at: r.circle source code (history)
93
94       Main  index  | Raster index | Topics index | Keywords index | Graphical
95       index | Full index
96
97       © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual
98
99
100
101GRASS 7.8.2                                                        r.circle(1)
Impressum