Monitor Trade Area Change (Business Analyst)

License Level:BasicStandardAdvanced

Summary

Creates a new feature class and report that analyze how trade areas have changed over time

Learn more about how Monitor Trade Area Change works

Illustration

Measure Trade Area Change Wide

Usage

Syntax

MonitorTradeAreaChange_ba (InputLayerParameterName1, IDFieldParameterName1, NameFieldParameterName1, InputLayerParameterName2, IDFieldParameterName2, NameFieldParameterName2, ReportNameParameterName, ReportTitleParameterName, ReportOutputDirectoryParameterName, OutputFeatureClass, {StoreLayerParameterName}, {StoreIDFieldParameterName}, {TAStoreIDFieldParameterName}, {ReportFormats})
ParameterExplanationData Type
InputLayerParameterName1

The first trade area used in the Monitor Trade Area Change tool. This trade area will be compared to the second trade area to determine the amount of overlap.

Feature Layer
IDFieldParameterName1

The unique ID for the first trade area.

Field
NameFieldParameterName1

The unique name for the first trade area.

Field
InputLayerParameterName2

The second trade area used in the Monitor Trade Area Change tool. This trade area will be compared to the first trade area to determine the amount of overlap.

Field
IDFieldParameterName2

The unique ID for the second trade area.

Feature Layer
NameFieldParameterName2

The unique name for the second trade area.

Field
ReportNameParameterName

Name of the report.

String
ReportTitleParameterName

Title of the report.

String
ReportOutputDirectoryParameterName

Report is created in this output folder.

Folder
OutputFeatureClass

The output feature class that will contain the trade area overlap features.

Feature Class
StoreLayerParameterName
(Optional)

The layer used for each trade area to calculate an index of similarity. In most cases, this will be a Business Analyst store layer.

Feature Layer
StoreIDFieldParameterName
(Optional)

The unique ID for the store layer.

Field
TAStoreIDFieldParameterName
(Optional)

The ID field that associates the store layer with the trade area layer.

Field
ReportFormats
(Optional)

Select the desired report output format

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

Code Sample

MonitorTradeAreaChange Example (Stand-alone Script)
# Name: MonitorTradeAreaChange.py
# Description: Calculates the percent change between two overlapping 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 Monitor Trade Area Change tool    
  TradeArea1 = "C:/temp/TradeArea1.shp"
  ID1 = "AREA_ID"
  Name1 = "NAME"
  TradeArea2 = "C:/temp/TradeArea2.shp"
  ID2 = "AREA_ID"
  Name2 = "NAME"
  RptName = "Monitor TA Report Name"
  RptTitle = "Monitor TA Report Title"
  RptPath = "C:/temp/Reports"
  Output = "C:/temp/Output_TAChange.shp"
 
# Create a Monitor Trade Area output
  arcpy.MonitorTradeAreaChange_ba(TradeArea1, ID1, Name1, TradeArea2, ID2, Name2, RptName, RptTitle, RptPath, Output)
 
# 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