Workflow diagram

Analysis using GeoAnalytics Tools

Analysis using GeoAnalytics Tools is run using distributed processing across multiple ArcGIS GeoAnalytics Server machines and cores. GeoAnalytics Tools and standard feature analysis tools in ArcGIS Enterprise have different parameters and capabilities. To learn more about these differences, see Feature analysis tool differences.

Terminology

Examples

The following are example uses of the tool:

• A city council has noticed a high number of liquor stores per capita in the city. In an effort to keep liquor out of the hands of children, the council decides to place regulations on advertising in liquor stores within 1,000 feet of schools, parks, and libraries. The council also wants to restrict new liquor licenses to buildings that are more than 1,000 feet from schools, parks, and libraries.

• A development company is looking to make money by creating a new mixed-use development in an urban center. The development will have to be conveniently located within a quarter mile of shops, restaurants, or a light rail stop.

Usage notes

The size of the buffer can be entered using one of the following three options:

• Distance—Uses a constant value (all buffers will be the same size)
• Field—Uses values from a field (different features can have different-sized buffers)
• Expression—Applies an expression to each feature (different features can have different values based on expression)

Learn more about applying buffer expressions

By default, the Create Buffers tool creates overlapping buffers when the buffer areas meet. When the input features are areas, the input area is included in the buffer. You can use the dissolve and multipart parameters to control how overlapping buffers are treated. The three available dissolve options are as follows:

• None—This is the default. Buffers will overlap where buffer areas meet.
• All—All of the features are dissolved. The multipart parameter determines if all features are dissolved into one feature (multipart is true), or only overlapping features are dissolved (multipart is false).
• Fields—Features are dissolved based on field values. You can select one or many fields, and like values are dissolved together. The multipart parameter determines if all matching field features are dissolved into one feature (multipart is true), or only overlapping matching field features are dissolved (multipart is false).

When you dissolve using All or Fields, you can calculate statistics. The statistics are only applied to dissolving of all features or field values, they are not applied geographically (using the multipart parameter). The following table explains how these options work using the six features shown in the following screen shot. The color denotes the field values (blue or orange), which are used for the field dissolve.

Dissolve option	Multipart is false (default)	Multipart is true
None	Six features are created when no dissolve is applied to buffered features. This is the default. This is the same as the standard analysis tool's Overlap option.	Multipart cannot be true when the dissolve option is None.
All	Three features are created when all values are dissolved and multipart is false. Only overlapping features are dissolved. This is the same as the standard analysis tool's Dissolve option.	One feature is created when all values are dissolved and multipart is true. When you select this option, the result will always be one feature.
Fields	Four features are created when the dissolve is applied based on the field (here, the field is the color of input points). Only overlapping features with the same value of the specified fields are dissolved.	Two features are created when the dissolve is applied based on the field (here, the field is the color of input points) and multiparts are allowed. Values with the same field value will always be a single feature.

If Use current map extent is checked, only the features that are visible within the current map extent will be analyzed. If it's not checked, all input features in the input layer will be analyzed, even if they are outside the current map extent.

Limitations

If you are using the Distance option or an expression that uses a linear unit, your data must be in a projected coordinate system.

How Create Buffers works

The Create Buffers tool uses a geodesic or planar method for constructing buffers. Geodesic buffers account for the actual shape of the earth (an ellipsoid, or more properly, a geoid). Distances are calculated between two points on a curved surface (the geoid) as opposed to two points on a flat surface (the Cartesian plane). Planar (or Euclidean) buffers are straight-line distances calculated between two points on a plane. Euclidean buffers appear as perfect circles when drawn on a projected flat map, while geodesic buffers appear as perfect circles only on a globe. Geodesic buffers may appear unusual on a flat map, but when displayed on a globe, these buffers will look correct.

The following example uses a 300-mile buffer around cities with populations of more than 10 million. The buffers closer to the equator appear smaller than the buffers further north because the Web Mercator projection used to display web maps distorts the size of objects relative to the object's distance from the equator.

In most cases it is appropriate to use a geodesic buffer, especially if your data meets the following conditions:

• You expect a buffer to extend past the international date line.
• Your dataset covers multiple UTM zones.

Learn more about using planar and geodesic buffers

ArcGIS API for Python example

The Create Buffers tool is available through ArcGIS API for Python.

# Import the required ArcGIS API for Python modules
import arcgis
from arcgis.gis import GIS
from arcgis.geoanalytics import use_proximity

# Connect to your ArcGIS Enterprise portal and confirm that GeoAnalytics is supported
portal = GIS("https://myportal.domain.com/portal", "gis_publisher", "my_password", verify_cert=False)
if not portal.geoanalytics.is_supported():
    print("Quitting, GeoAnalytics is not supported")
    exit(1)   

# Find the big data file share dataset you'll use for analysis
search_result = portal.content.search("", "Big Data File Share")

# Look through the search results for a big data file share with the matching name
bdfs_search = next(x for x in search_result if x.title == "bigDataFileShares_NaturalDisaters")

# Look through the big data file share for Earthquakes
earthquakes = next(x for x in bdfs_search.layers if x.properties.name == "Earthquakes")

# Set the tool environment settings
arcgis.env.verbose = True
arcgis.env.defaultAggregations = True

# Run the Create Buffers tool 
output = use_proximity.create_buffers(input_layer = earthquakes, 
                                      field = "TremorDistance", 
                                      method = "Geodesic", 
                                      dissolve_option = "All", 
                                      output_name = "Earthquake_impacts")

# Visualize the tool results if you are running Python in a Jupyter Notebook
processed_map = portal.map('USA')
processed_map.add_layer(output)
processed_map

Similar tools

Use Create Buffers to create areas around input features. Other tools may be useful in solving similar but slightly different problems.