Dissolve By Attribute Range (Business Analyst)

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

DissolveByAttributeRange_ba (InputFeatureLayer, IDField, ContoursValues, OutputFeatureClass, {SelectedFeaturesOnly}, {Donut})

Parameter	Explanation	Data 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.	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 nonoverlapping concentric rings, or donut bands. True —Creates output polygons that are donut rings. For example, if three radii (1, 2, and 3 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.AddToolbox("C:\Program Files\ArcGIS\Desktop10.0\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
try:
# Acquire extension license 
arcpy.CheckOutExtension("Business")
 
# Define input and output parameters for the Dissolve by Attribute Range tool
Input = "C:/temp/Boundary.shp"
Dissolve = "TOTPOP_CY"
OutPath = "C:/temp/Output_Contours.shp"
 
# Create trade areas by dissolving attributes
arcpy.DissolveByAttributeRange_ba(Input, Dissolve, "250;500;1000;2000", OutPath)
 
# Release extension license 
arcpy.CheckInExtension("Business") 
 
except:
  print arcpy.GetMessages(2)

Environments

This tool does not use any geoprocessing environments

Licensing Information

ArcView: Requires Business Analyst

ArcEditor: Requires Business Analyst

ArcInfo: Requires Business Analyst