Remove Trade Area Overlap (Business Analyst)

License Level:BasicStandardAdvanced

Summary

Removes overlap (cannibalization) between trade areas

Illustration

Trade Area overlap Drive Time wide

Usage

Syntax

RemoveTAOverlap_ba (InputFeatureLayer, AssociatedStoreID, {CenterOfTA}, ApproachToRemoveOverlap, OutputFeatureClass, {StoreLayer}, {StoreIDField}, {WayToDefineWeights}, {WeightField})
ParameterExplanationData Type
InputFeatureLayer

The input features containing the overlapping trade areas.

Feature Layer
AssociatedStoreID

Unique ID field in the trade area layer.

Field
CenterOfTA
(Optional)

Field used to define the way a centroid is derived.

  • USE CENTROIDUses the geographic centroid of the trade areas. This is the default.
  • USE_STORE_LAYERUses the existing store layer for the centroid of the trade areas.
String
ApproachToRemoveOverlap

Defines the approach used to remove overlap between trade areas.

  • THIESSEN_POLYGONSRemoves the overlap by drawing straight lines of equal distance between two adjacent polygons. This is the default.
  • GRIDTakes into account weights of the stores and shape of the overlapping polygon to make the division more natural.
String
OutputFeatureClass

The feature class containing the new trade area features.

Feature Class
StoreLayer
(Optional)

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

Feature Layer
StoreIDField
(Optional)

Unique ID field in the store layer.

Field
WayToDefineWeights
(Optional)

Method for removing overlap when using the grid approach.

  • USE_AREA_OF_TAUses the trade area as a weight. This is the default.
  • USE_WEIGHT_FIELDGives the option to select a numeric variable from the store layer as the weight for the trade area to remove the overlap.
  • EQUAL_WEIGHTSUses the actual midpoint of the intersecting grid line to remove the overlap.
String
WeightField
(Optional)

Field used to determine how the trade area overlap is influenced. Used when the grid approach and the weight definition method are set to USE_WEIGHT_FIELD.

Field

Code Sample

RemoveTAOverlap Example (Stand-alone Script)
# Name: RemoveTAOverlap.py
# Description: Removes overlap between selected trade areas.
# Author: Esri

# Import system modules
import arcview
import arcpy

arcpy.AddToolbox("C:\Program Files (x86)\ArcGIS\Desktop10.2\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
try:
# Acquire extension license 
  arcpy.CheckOutExtension("Business") 
 
# Define input and output parameters for the Remove Trade Area Overlap tool
  Path = "C:/temp/overlap.shp"
  IdFld = "<none>"
  OutPath = "C:/temp/RAPolygon.shp"
 
# Remove overlap based on trade areas
  arcpy.RemoveTAOverlap_ba(Path, IdFld, "USE_CENTROID", "THIESSEN_POLYGONS", 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

ArcGIS for Desktop Basic: Requires Business Analyst
ArcGIS for Desktop Standard: Requires Business Analyst
ArcGIS for Desktop Advanced: Requires Business Analyst
3/3/2014