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...

Remove Trade Area Overlap

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

Summary

Removes overlap (cannibalization) between trade areas

Illustration

Trade Area overlap Drive Time wide

Usage

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

  • The Trade Area Layer must be a polygon feature class.

  • In most cases, the Trade Area Layer will be a trade area created with Business Analyst.

  • The Remove Overlap Method parameter has two choices:

    • THIESSEN_POLYGONS method will remove overlap using straight lines.
    • The GRID method will remove overlap with a line that reflects the shape and curve of the input polygon feature class.

  • If trade areas do not overlap, the output feature class will contain the features from the input Trade Area Layer.

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 CENTROID —Uses the geographic centroid of the trade areas. This is the default.
  • USE_STORE_LAYER —Uses the existing store layer for the centroid of the trade areas.
String
ApproachToRemoveOverlap

Defines the approach used to remove overlap between trade areas.

  • THIESSEN_POLYGONS —Removes the overlap by drawing straight lines of equal distance between two adjacent polygons. This is the default.
  • GRID —Takes 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_TA —Uses the trade area as a weight. This is the default.
  • USE_WEIGHT_FIELD —Gives the option to select a numeric variable from the store layer as the weight for the trade area to remove the overlap.
  • EQUAL_WEIGHTS —Uses 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.3\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

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