Thiessen Polygons (Business Analyst)

License Level:BasicStandardAdvanced

Summary

Generates competitive advantage trade areas for each store by creating boundary lines equidistant from each of the store locations.

Learn more about how Thiessen Polygons works

Illustration

Thiessen polygon example

Usage

Syntax

ThiessenPolygons_ba (StoreLayer, StoreIDField, All_Or_Single_Or_Selected, OutputFeatureClass, {ByID_Or_ByName}, {Single_Site})
ParameterExplanationData Type
StoreLayer

The input feature class containing center points for the Thiessen polygons. In most cases, this will be a Business Analyst store layer.

Feature Layer
StoreIDField

Unique ID field in the polygon center (store) layer.

Field
All_Or_Single_Or_Selected

Defines how to create polygons for points in the input feature layer.

  • AllPolygons are created for all points.
  • SinglePolygons are created for a single point.
  • SelectedPolygons are created for all selected points in ArcMap.
String
OutputFeatureClass

The feature class that will contain the polygon features.

Feature class
ByID_Or_ByName
(Optional)

Field used to select a single point.

  • IDSelects a single point using the store ID field.
  • NameSelects a single point using the store name field.
String
Single_Site
(Optional)

ID or name of store to be used as the single point.

String

Code Sample

ThiessenPolygons Example (Stand-alone Script)
# Name: ThiessenPolygons.py
# Description: Creates Thiessen based trade areas around selected stores. 
# 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 Thiessen Polygons tool
  StorePath = "C:/temp/sf_stores.shp"
  IdFld = "STORE_ID"
  OutPath = "C:/temp/ThiessenPolygons.shp"
 
# Create Thiessen Polygon based trade areas
  arcpy.ThiessenPolygons_ba(StorePath, IdFld, "ALL", 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