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

Measure Cannibalization

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

Summary

Calculates the amount of overlap between two or more trade areas.

Learn more about how Measure Cannibalization works

Illustration

Measure Cannibalization

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.

  • This tool is primarily used to examine the amount of overlap between two or more trade areas.

  • In most cases, the trade area layers will be trade areas created with Business Analyst.

  • Only overlapping trade areas are valid inputs for this tool.

  • The output feature class is created from the actual area of overlap in the trade area features.

  • If trade areas do not overlap, the output feature class will be the same trade area input feature class.

Syntax

MeasureCannibalization_ba (InputLayer, IDField, NameField, OutputFeatureClass, {UseSelectedFeatures}, {ReportName}, {ReportTitle}, {ReportOutputDirectory}, {ReportFormats})
ParameterExplanationData Type
InputLayer

The input feature class containing the trade areas used to determine amount of cannibalization.

Feature Layer
IDField

Unique ID field in the trade area layer.

Field
NameField

Unique name field in the trade area layer.

Field
OutputFeatureClass

The output feature class that will contain the overlapped features.

Feature Class
UseSelectedFeatures
(Optional)

The features used to measure cannibalization.

  • TRUE —Measures cannibalization on selected features.
  • FALSE —Measures cannibalization on all features. This is the default.
Boolean
ReportName
(Optional)

Name of the report.

String
ReportTitle
(Optional)

Title of the report.

String
ReportOutputDirectory
(Optional)

Report is created in this output folder.

Folder
ReportFormats
[ReportFormats,...]
(Optional)

One or more formats to which the report will be output.

  • Simple XML
  • PDF
  • HTML
  • CSV
  • ZIP
  • XLSV
  • Stripped XLSX
String

Code Sample

MeasureCannibalzation Example (Stand-alone Script)
# Name: MeasureCannibalization.py
# Description: Measures cannibalization between two 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 Measure Cannibalization tool
  TradeArea = "C:/temp/DetailedCustomerTA.shp"
  Id = "AREA_ID"
  Name = "AREA_DESC"
  Output = "C:/temp/Reports/Cannibalization.shp"
  ReportName = "Cannibalization_Name"
  ReportTitle = "Cannibalization_Report"
  ReportOutput = "C:/temp/Reports"
 
# Create a Measure Cannibalization output
  arcpy.MeasureCannibalization_ba(sTradeArea, sId, sName, sOutput, "false", sReportName, sReportTitle, sReportOutput)
 
# 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