ArcMap

Dissolve By Attribute Range

Available with Business Analyst license.

Summary

Aggregates and dissolves features based on specified attributes.

Learn more about how Dissolve By Attribute Range works

Usage

  • The spatial reference of the output feature class will be the same as the layer containing attributes.

  • Current map layers can be used to define input features. When using layers, only the currently selected features are used in the dissolve operation.

  • The dissolved fields are written to the output feature class table.

  • One common use of this tool is to take the output of a thematic map and dissolve the features as a single polygon or feature.

  • You can use this tool to dissolve the output from Huff Models to create probabilistic trade areas based on probability ranges.

Syntax

arcpy.ba.DissolveByAttributeRange(InputFeatureLayer, IDField, ContoursValues, OutputFeatureClass, {SelectedFeaturesOnly}, {Donut})
ParameterExplanationData Type
InputFeatureLayer

Layer containing the values that will be dissolved.

Feature Layer
IDField

The attribute field containing the values to be dissolved.

Field
ContoursValues
[ContoursValues,...]

The range for each attribute to be dissolved. If using the Python function call, you can enter multiple values separated by semicolons (e.g. "250;500;1000;2000").

Double
OutputFeatureClass

The feature class that will contain the dissolved attributes.

Feature Class
SelectedFeaturesOnly
(Optional)

Uses selected features to dissolve by attribute.

  • True —Dissolves selected features.
  • False —Dissolves all features.
Boolean
Donut
(Optional)

Creates non-overlapping concentric rings, or donut bands.

  • True —Creates output polygons that are donut rings. For example, if three radii (1, 3, and 5 miles) are entered, three output bands would be created with 0–1, 1–3, and 3–5 mile rings.
  • False —Creates concentric rings.
Boolean

Code sample

DissolveByAttributeRange Example (Stand-alone Script)
# Name: DissolveByAttributeRange.py
# Description: Dissolves the boundaries of a trade area using current year total households
# Author: Esri

# Import system modules
import arcview
import arcpy

arcpy.ImportToolbox(r"C:\Program Files (x86)\ArcGIS\Desktop10.8\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")

# Acquire extension license 
arcpy.CheckOutExtension("Business")
 
# Define input and output parameters for the Dissolve by Attribute Range tool
InputFeatureLayer = "C:/temp/Boundary.shp"
IDField = "TOTPOP_CY"
ContoursValues = "250;500;1000;2000"
OutputFeatureClass = "C:/temp/Output_Contours.shp"
SelectedFeaturesOnly = "false"
Donut = "false"

# Create trade areas by dissolving attributes
arcpy.DissolveByAttributeRange_ba(InputFeatureLayer, 
						IDField, 
						ContoursValues , 
						OutputFeatureClas, 
						SelectedFeaturesOnly, 
						Donut)
 
# Release extension license 
arcpy.CheckInExtension("Business")

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: Requires Business Analyst
  • Standard: Requires Business Analyst
  • Advanced: Requires Business Analyst

Related topics