Summary
Creates a new feature class and report that analyze how trade areas have changed over time
Illustration
Usage
The spatial reference of the output feature class will be the same as the first trade area layer.
Both trade area layers must be polygon feature classes.
This tool is primarily used to track changes in trade areas over time.
This tool is most often used with customer-derived trade areas that have been created with customer data captured at two different time periods or for different product groups.
In most cases, the trade area layers will be trade areas created with ESRI Business Analyst.
Only overlapping trade areas are valid inputs for this tool.
If no store layer is defined, the geographic center of the trade area will be used to calculate the index of similarity.
Syntax
MonitorTradeAreaChange_ba (InputLayerParameterName1, IDFieldParameterName1, NameFieldParameterName1, InputLayerParameterName2, IDFieldParameterName2, NameFieldParameterName2, ReportNameParameterName, ReportTitleParameterName, ReportOutputDirectoryParameterName, OutputFeatureClass, {StoreLayerParameterName}, {StoreIDFieldParameterName}, {TAStoreIDFieldParameterName}, {ReportFormats})| Parameter | Explanation | Data 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 [ReportFormats,...] (Optional) | Select the desired report output format
| 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.3\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
Licensing Information
- ArcGIS for Desktop Basic: Requires Business Analyst
- ArcGIS for Desktop Standard: Requires Business Analyst
- ArcGIS for Desktop Advanced: Requires Business Analyst