Customer Derived Trade Areas (Business Analyst)

Summary

Creates trade areas around stores based on the number of customers or volume attribute of each customer.

Learn more about how Customer Derived Trade Areas works

Illustration

Customer Derived Trade Areas

Usage

Syntax

CustomerDerivedTA_ba (AnalysisType, InputFeatureLayer, IDField, All_Or_Single_Or_Selected, CustomerLayer, LinkField, CustomerWeightField, RingsCollection, OutputFeatureClass, {ByID_Or_ByName}, {Single_Site}, {UseSelectedFeatures}, {ExcludeOutlyingCustomers}, {CutoffDistance}, {MeasureUnits}, {Donut}, {UseCentroids})
ParameterExplanationData Type
AnalysisType

The type of customer-derived trade area to be generated.

  • SIMPLEGeneralized, overlapped trade areas.
  • AMOEBADetailed trade areas that take into account all your customer points and join extreme points using elliptical arcs.
  • DETAILEDComplex trade areas that take into account all your customer points and join extreme points using straight lines.
  • DETAILED WITH SMOOTHINGDetailed trade areas that take into account all your customer points and join extreme points with a smoothed curve using cubic splines. This is the recommended approach, because it takes into account the shape and pattern of the customer distributions.
String
InputFeatureLayer

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

Feature Layer
IDField

Unique ID field in the trade area center (store) layer.

String
All_Or_Single_Or_Selected

The points in the input feature layer used to create trade areas.

  • AllCreates trade areas for all points.
  • SingleCreates trade areas for a single point.
  • SelectedCreates trade areas for all selected points in ArcMap.
String
CustomerLayer

The input feature class containing the points and attributes needed to generate the trade areas. In most cases, this will be a Business Analyst customer layer.

Feature Layer
LinkField

The ID that identifies the store associated with each customer.

Field
CustomerWeightField

The field used to calculate the trade areas. This is based on either the number of customers (count) or the calculated weighted value assigned to each customer.

Field
RingsCollection
[RingsCollection,...]

The percentage of customers (or weights) used to create customer-derived trade areas around the stores. For example, you can create customer-derived trade areas that represent 40, 60, or 80 percent of your customers for each store.

Double
OutputFeatureClass

The feature class that will contain the customer-derived trade area features.

Feature Class
ByID_Or_ByName
(Optional)

Field used to select a single point.

  • IDSelects a single point using the store ID field.
  • NameSelects a single point using the store name field.
String
Single_Site
(Optional)

ID or name of store to be used as the single point.

String
UseSelectedFeatures
(Optional)

The store features used to generate customer-derived trade areas.

  • TRUEGenerates customer-derived trade areas on selected features
  • FALSEGenerates customer-derived trade areas on all features. This is the default.
Boolean
ExcludeOutlyingCustomers
(Optional)

Identifes the customers used in the trade area calculation beyond a specified distance.

  • TRUEExcludes outlying customers.
  • FALSEIncludes all customers. This is the default.
Boolean
CutoffDistance
(Optional)

The numeric distance used to determine how far to include customers from each store in the percentage calculations for each trade area.

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
Donut
(Optional)

Creates nonoverlapping concentric rings, or donut bands.

  • TRUECreates 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. This is the default.
  • FALSECreates concentric rings.
Boolean
UseCentroids
(Optional)

Locates the center of your customer area and calculates trade areas outward from this center point.

  • TRUEUses centroid of customers to calculate trade areas.
  • FALSEUses store centroid to calculate trade areas. This is the default.
Boolean

Code Sample

CustomerDerivedTA Example (Stand-alone Script)
# Name: CustomerDerivedTA.py
# Description: Creates simple polygon based trade areas around San Francisco based stores based on sales associated with customer data.
# Author: ESRI

# Import system modules
import arcview
import arcpy

arcpy.ImportToolbox("C:\Program Files\ArcGIS\Desktop10.0\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
try:
# Acquire extension license 
arcpy.CheckOutExtension("Business")

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 Customer Derived Trade Areas tool
StorePath = "C:/temp/sf_stores.shp"
CustPath = "C:/temp/sf_cust.shp"
IdFld = "STORE_ID"
CustID = "STORE_ID" 
CustWeight = "SALES"
AnalysisType = "SIMPLE"
OutPath = "C:/temp/RingOutput.shp"
 
# Create detailed customer derived trade areas
arcpy.CustomerDerivedTA_ba(AnalysisType, StorePath, IdFld, "ALL", CustPath, CustID, CustWeight, "40;60;80", OutPath)
 
# Release extension license 
  arcpy.CheckInExtension("Business") 
 
except:
print arcpy.GetMessages(2)

Environments

This tool does not use any geoprocessing environments

Related Topics

Licensing Information

ArcView: Requires Business Analyst
ArcEditor: Requires Business Analyst
ArcInfo: Requires Business Analyst

11/8/2010