GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
v.buffer(1) Grass User's Manual v.buffer(1)

v.buffer - Creates a buffer around vector features of given type.

vector, buffer, area, circle, geometry, line, grow, shrink

v.buffer
 
v.buffer --help
 
v.buffer [-sct] input=name [layer=string] [ cats=range] [where=sql_query] [ type=string[,string,...]] output=name [distance= float] [minordistance=float] [angle= float] [column=name] [scale=float] [ tolerance=float] [--overwrite] [-- help] [--verbose] [--quiet] [--ui]

-s
 
Make outside corners straight
-c
 
Do not make caps at the ends of polylines
-t
 
Transfer categories and attributes
--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

input=name [required]
 
Name of input vector map
 
Or data source for direct OGR access
layer=string
 
Layer number or name (’-1’ for all layers)
 
A single vector map can be connected to multiple database tables. This number determines which table to use. When used with direct OGR access this is the layer name.
 
Default: -1
cats=range
 
Category values
 
Example: 1,3,7-9,13
where=sql_query
 
WHERE conditions of SQL statement without ’where’ keyword
 
Example: income < 1000 and population >= 10000
type=string[,string,...]
 
Input feature type
 
Options: point, line, boundary, centroid, area
 
Default: point,line,area
output=name [required]
 
Name for output vector map
distance=float
 
Buffer distance along major axis in map units
minordistance=float
 
Buffer distance along minor axis in map units
angle=float
 
Angle of major axis in degrees
 
Default: 0
column=name
 
Name of column to use for buffer distances
scale=float
 
Scaling factor for attribute column values
 
Default: 1.0
tolerance=float
 
Maximum distance between theoretical arc and polygon segments as multiple of buffer (default 0.01)

v.buffer creates a buffer around features of given type, which have a category in the given layer. The tolerance controls the number of vector segments being generated (the smaller the value, the more vector segments are generated).

Internal buffers for areas can be generated with negative distance values ("inward buffer" or "negative buffer" or "shrinking").
v.buffer fusions the geometries of buffers by default. Categories and attribute table will not be transferred (this would not make sense as one buffer geometry can be the result of many different input geometries). To transfer the categories and attributes the user can set the t flag. This will result in buffers being cut up where buffers of individual input geometries overlap. Each part that is the result of overlapping buffers of multiple geometries will have multiple categories corresponding to those geometries, and multiple buffer areas can have the same category. The buffer for the input feature with category X can thus be retrieved by selecting all buffer areas with category X (see example below).
Buffers for lines and areas are generated using the algorithms from the GEOS library.
For advanced users: built-in buffer algorithm no longer desired, we use GEOS: If GRASS is not compiled with GEOS support or environmental variable GRASS_VECTOR_BUFFER is defined, then GRASS generates buffers using built-in buffering algorithm (which is still buggy for some input data).
The options minordistance, angle, tolerance are kept for backward compatibility and have no effect with GEOS buffering.

The following vector line related corners (also called "cap") exist:
no cap:
rounded cap:
square cap:
By default v.buffer creates rounded buffers (blue color on figure below): Straight corners with caps are created by -s flag (red color on the figure below), while -c flag doesn’t make caps at the ends of polylines (green color on the figure below):

All examples are based on the North Carolina sample dataset.

v.buffer input=roadsmajor output=roadsmajor_buffer type=line distance=100
 
Buffer of 100m along the "roadsmajor" lines (map subset, original center line shown in black)

v.buffer input=hospitals output=hospitals_circled type=point distance=2000
 
Buffer of 2000m around the "hospitals" points (map subset, original points shown in black, new area centroids in red)

v.buffer input=hospitals output=hospitals_circled type=point distance=1000 -t
# display buffer around hospital with category 36,
# this buffer is composed of several areas:
d.vect map=hospitals_circled type=area layer=1 cats=36
# extract this buffer, dissolving boundaries
v.extract in=hospitals_circled output=hospital_36_circled layer=1 cats=36 -d

v.buffer input=lakes output=lakes_buffer type=area distance=100
 
Buffer of 100m around the "lakes" polygons (map subset, original areas shown in black)

In this example, an internal buffer ("inward buffer" or "negative buffer") is generated using a negative distance value:
 
v.buffer input=lakes output=lakes_buffer type=area distance=-50
 
Internal buffer of 50m inside the "lakes" polygons (map subset, original areas shown in black)
 
Not all features are buffered, only the polygons that allow creation inside a topological cleaned polygon.

GEOS Library

r.buffer, v.parallel, v.extract, v.type, v.patch, v.db.connect

Radim Blazek
 
Rewritten by Rosen Matev (with support through the Google Summer of Code program 2008)
 
Rewritten by Markus Metz (2011, 2012)
Last changed: $Date: 2017-11-12 23:40:40 +0100 (Sun, 12 Nov 2017) $

Available at: v.buffer source code (history)
Main index | Vector index | Topics index | Keywords index | Graphical index | Full index
© 2003-2018 GRASS Development Team, GRASS GIS 7.4.3 Reference Manual
GRASS 7.4.3

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.