ArcGIS for Desktop

  • Documentation
  • Pricing
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS for Desktop

A complete professional GIS

ArcGIS for Server

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Pricing
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

Help

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • More...

Data Driven Rings

  • Summary
  • Illustration
  • Usage
  • Syntax
  • Code Sample
  • Environments
  • Licensing Information

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
  • Feet
  • Kilometers
  • Meters
  • Miles
  • Nautical Miles
  • Yards
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.AddToolbox("C:\Program Files (x86)\ArcGIS\Desktop10.3\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
try:
# Acquire extension license 
  arcpy.CheckOutExtension("Business")

# Define input and output parameters for the Data Driven Rings tool
  sStorePath = "C:/temp/sf_store.shp"
  sIdFld = "STORE_ID"
  sOutPath = "C:/temp/RingOutput.shp"
  sRadiusFld = "SALES"
 
# Create data driven rings trade areas    
  arcpy.DataDrivenRings_ba(StorePath, IdFld, "ALL", RadiusFld, "450000", "Miles", OutPath)
 
# Release extension license 
  arcpy.CheckInExtension("Business") 
 
except:
  print arcpy.GetMessages(2)

Environments

This tool does not use any geoprocessing environments

Licensing Information

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

Related Topics

  • An overview of the Trade Areas toolset
Feedback on this topic?

ArcGIS for Desktop

  • Home
  • Documentation
  • Pricing
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal