Create Buffers (Standard Feature Analysis)

Summary

Creates polygons that cover a given distance from a point, line, or polygon feature.

Buffers are typically used to create areas that can be further analyzed using a tool such as Overlay Layers. For example, if the question is "What buildings are within 1 mile of the school?", the answer can be found by creating a 1-mile buffer around the school and overlaying the buffer with the layer containing building footprints. The end result is a layer of those buildings within 1 mile of the school.

Illustration

Create Buffers tool illustration

Usage

  • The size of the buffer can be provided as a constant using the distance option (all buffers will be the same size) or using values from a field (different features can have buffers of a different size). You can create a multiple-ring buffer using the distance option by providing multiple constants.

  • By default, this tool will create overlapping buffers when the buffer areas meet. When the input features are lines, the default is a rounded buffer on all sides of the lines. When the input features are polygons, the default is to include the input area in the buffer. When there are multiple input distances, the default is to create rings.

  • If the input layer has a geographic coordinate system or uses a Web Mercator-based projected coordinate system, this tool uses a geodesic buffering algorithm to produce more accurate buffers.

Parameters

LabelExplanationData Type
Input Layer

The point, line, or polygon features that will be buffered.

Feature Set
Output Name

The name of the output layer that will be created on your portal.

String
Distances
(Optional)

A list of distance values that will be used to buffer the input features. You must supply values for either the distances or a distance field. You can provide a single distance value or multiple values. The units of the distance values are supplied by the distance units parameter.

Double
Distance Field
(Optional)

A field from the input layer containing one buffer distance per feature.

Field
Distance Units
(Optional)

Specifies the units that will be used for the buffer distance. A value is required if the distance has been set.

  • MilesThe units will be miles.
  • FeetThe units will be feet.
  • KilometersThe units will be kilometers.
  • MetersThe units will be meters.
  • Nautical milesthe units will be nautical miles.
  • YardsThe units will be yards.
String
Dissolve Type
(Optional)

Specifies how overlapping buffers will be processed.

  • No dissolve Overlapping areas will be kept. This is the default.
  • Dissolve overlapping areas Overlapping areas will be combined.
String
Buffer Ring Type
(Optional)

Specifies how multiple-distance buffers will be processed.

  • Concentric overlapping disks Buffers are concentric and will overlap. For example, if the distances are 10 and 14, the result will be two buffers, one from 0 to 10 and one from 0 to 14. This is the default.
  • Nonoverlapping rings Buffers will not overlap. For example, if the distances are 10 and 14, the result will be two buffers, one from 0 to 10 and one from 10 to 14.
String
Side Type
(Optional)

Specifies the side of the line that will be buffered when buffering line features. Typically, this is both sides (Full, which is the default). Left and right are determined as if you were walking from the first x,y coordinate of the line (the start coordinate) to the last x,y coordinate of the line (the end coordinate). Choosing left or right usually means you know that the line features were created and stored in a particular direction (for example, upstream or downstream in a river network).

When buffering polygon features, you can include or exclude the polygon being buffered.

If no side type is specified, the polygon being buffered will be included in the result buffer. This is the default for polygon features.

  • Full Both sides of the line will be buffered. This is the default for line features.
  • Right Only the right side of the line will be buffered.
  • Left Only the left side of the line will be buffered.
  • Outside When buffering a polygon, the polygon being buffered will be excluded in the result buffer.
String
End Type
(Optional)

Specifies the shape of the buffer at the end-of-line input features. This parameter is not valid for polygon input features. At the ends of lines, the buffer can be rounded (round) or be straight across (flat).

  • Round ends Buffers will be rounded at the ends of lines. This is the default.
  • Flat ends Buffers will be flat or straight across at the ends of lines.
String

Derived Output

LabelExplanationData Type
Output

The output buffers layer.

Feature Set

arcpy.sfa.CreateBuffers(inputLayer, outputName, {distances}, {field}, {units}, {dissolveType}, {ringType}, {sideType}, {endType})
NameExplanationData Type
inputLayer

The point, line, or polygon features that will be buffered.

Feature Set
outputName

The name of the output layer that will be created on your portal.

String
distances
[distances,...]
(Optional)

A list of distance values that will be used to buffer the input features. You must supply values for either the distances or a distance field. You can provide a single distance value or multiple values. The units of the distance values are supplied by the distance units parameter.

Double
field
(Optional)

A field from the input layer containing one buffer distance per feature.

Field
units
(Optional)

Specifies the units that will be used for the buffer distance. A value is required if the distance has been set.

  • MILESThe units will be miles.
  • FEETThe units will be feet.
  • KILOMETERSThe units will be kilometers.
  • METERSThe units will be meters.
  • NAUTICALMILESthe units will be nautical miles.
  • YARDSThe units will be yards.
String
dissolveType
(Optional)

Specifies how overlapping buffers will be processed.

  • NONE Overlapping areas will be kept. This is the default.
  • DISSOLVE Overlapping areas will be combined.
String
ringType
(Optional)

Specifies how multiple-distance buffers will be processed.

  • DISKS Buffers are concentric and will overlap. For example, if the distances are 10 and 14, the result will be two buffers, one from 0 to 10 and one from 0 to 14. This is the default.
  • RINGS Buffers will not overlap. For example, if the distances are 10 and 14, the result will be two buffers, one from 0 to 10 and one from 10 to 14.
String
sideType
(Optional)

Specifies the side of the line that will be buffered when buffering line features. Typically, this is both sides (Full, which is the default). Left and right are determined as if you were walking from the first x,y coordinate of the line (the start coordinate) to the last x,y coordinate of the line (the end coordinate). Choosing left or right usually means you know that the line features were created and stored in a particular direction (for example, upstream or downstream in a river network).

When buffering polygon features, you can include or exclude the polygon being buffered.

If no side type is specified, the polygon being buffered will be included in the result buffer. This is the default for polygon features.

  • FULL Both sides of the line will be buffered. This is the default for line features.
  • RIGHT Only the right side of the line will be buffered.
  • LEFT Only the left side of the line will be buffered.
  • OUTSIDE When buffering a polygon, the polygon being buffered will be excluded in the result buffer.
String
endType
(Optional)

Specifies the shape of the buffer at the end-of-line input features. This parameter is not valid for polygon input features. At the ends of lines, the buffer can be rounded (round) or be straight across (flat).

  • ROUND Buffers will be rounded at the ends of lines. This is the default.
  • FLAT Buffers will be flat or straight across at the ends of lines.
String

Derived Output

NameExplanationData Type
output

The output buffers layer.

Feature Set

Environments

Licensing information

  • Basic: Requires your account in ArcGIS Enterprise to have the Perform Analysis privilege
  • Standard: Requires your account in ArcGIS Enterprise to have the Perform Analysis privilege
  • Advanced: Requires your account in ArcGIS Enterprise to have the Perform Analysis privilege

Related topics