ArcMap

Data Driven Rings

Available with Business Analyst license.

Summary

Creates a new feature class of ring trade area features. The radii are determined by a field in the ring center (store) layer.

Learn more about how Data Driven Rings works

Illustration

Data Driven Rings Wide

Usage

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

  • The input Store Layer must be point features.

  • In most cases, the input Store Layerwill be a Business Analyst store layer.

  • Selecting ALL in the Sites to use parameter will create rings for each point feature in the input Store Layer

  • If Remove Overlap is checked, Thiessen polygons are used to remove overlap between output ring polygons.

  • The Value per unit field determines the data value used to set the threshold for your rings, must be numeric, and cannot be negative.

  • If your Store Layer contains a field that has actual radii for each store point, set the value per unit to one.

Syntax

DataDrivenRings_ba (InputFeatureLayer, IDField, All_Or_Single_Or_Selected, RadiusFieldName, ValuePerUnit, {MeasureUnits}, OutputFeatureClass, {ByID_Or_ByName}, {Single_Site}, {RemoveOverlap}, {ExpValue})
ParameterExplanationData Type
InputFeatureLayer

The input feature class containing center points for the rings. In most cases, this will be a Business Analyst store layer.

Feature Class
IDField

Unique ID field in the ring center (store) layer.

Field
All_Or_Single_Or_Selected

Creates rings for points in the input feature layer.

  • ALL —Creates rings for all points. This is the default
  • SINGLE —Creates rings for a single point.
  • SELECTED —Creates rings for all selected points in ArcMap.
String
RadiusFieldName

Field used to determine radii of the rings.

Field
ValuePerUnit

Value entered proportional to one measured unit. For example, $450,000 in sales is equal to 1 mile.

Double
MeasureUnits
(Optional)

The units used with the distance values. By default, the units defined in the Business Analyst preferences will be selected.

  • Decimal Degrees —Decimal degrees
  • Feet —Feet
  • Kilometers —Kilometers
  • Meters —Meters
  • Miles —Miles
  • Nautical Miles —Nautical miles
  • Yards —Yard
String
OutputFeatureClass

The feature class that will contain the ring features.

Feature Class
ByID_Or_ByName
(Optional)

Field used to select a single point.

  • ID —Selects a single point using the store ID field.
  • NAME —Selects a single point using the store name field.
String
Single_Site
(Optional)

ID or name of store used as the single point.

String
RemoveOverlap
(Optional)

Creates overlapping concentric rings or removes overlap.

  • true —Uses Thiessen polygons to remove overlap between output ring polygons.
  • false — Output ring features are created with overlap. This is the default.
Boolean
ExpValue
(Optional)

An exponent value to determine the size of the data-driven rings. This exponent is the same type of exponent used in the Huff Modeling.

Double

Code sample

DataDrivenRings example (stand-alone script)

# Name: DataDrivenRings.py
# Description: Creates ring based trade areas in San Francisco based on sales values in a store layer.
# Author: Esri

# Import system modules
import arcview
import arcpy

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

# Acquire extension license 
arcpy.CheckOutExtension("Business")

# Define input and output parameters for the Data Driven Rings tool
InputFeatureLayer = "C:/temp/sf_store.shp"
IDField = "STORE_ID"
All_Or_Single_Or_Selected = "ALL"
RadiusFieldName = "SALES"
ValuePerUnit = "450000"
MeasureUnits = "Miles"
OutputFeatureClass = "C:/temp/RingOutput.shp"
ByID_Or_ByName=""
Single_Site=""
RemoveOverlap="false"
ExpValue="1"

 
# Create data driven rings trade areas    
arcpy.DataDrivenRings_ba(InputFeatureLayer, 
						IDField, 
						All_Or_Single_Or_Selected, 
						RadiusFieldName, 
						ValuePerUnit, 
						MeasureUnits, 
						OutputFeatureClass, 
						ByID_Or_ByName, 
						Single_Site, 
						RemoveOverlap, 
						ExpValue)
 
# Release extension license 
arcpy.CheckInExtension("Business")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics