Spatial Overlay (Business Analyst)

Summary

Aggregates data from one layer to another. For example, you can summarize block group demographic data for a set of trade areas.

Learn more about how Spatial Overlay works

Illustration

Usage

• The input layer must be properly formatted using the Analysis Layer Setup tool in ESRI Business Analyst with appropriate apportionment values applied.

• The input layer contains the underlying data you want to extract.

• Data is added to the overlay layer. Data is extracted from the input layer and aggregated into the overlay layer.

• You can aggregate from a point- or polygon-based input layer.

• A file called Ratios Table.dbf will be created and added in the same directory of the output overlay layer. This ratios table contains the percentage of intersection and weights used to execute the overlay.

• Don't run a spatial overlay analysis if ArcMap is still redrawing your map. This may cause a problem with ArcMap and result in ArcMap crashing.

Syntax

SpatialOverlay_ba (InputFeatureLayer, OverlayLayer, SelectedSummarizations, OutputFeatureClass, {SpatialOverlayAppendData}, {UseSelectedFeatures})

Parameter	Explanation	Data Type
InputFeatureLayer	The input feature layer that contains the data to be extracted.	Feature Layer
OverlayLayer	The overlay layer that inherits the data.	Feature Layer
SelectedSummarizations [SelectedSummarization,...,...]	Selects any variable from the input layer on which to run the spatial overlay.	String
OutputFeatureClass	The feature class that will contain the overlay features.	Feature Class
SpatialOverlayAppendData (Optional)	The selected variables can be appended to the overlay layer. TRUE —Appends data to layer. FALSE —Will not append data to layer. This is the default.	Boolean
UseSelectedFeatures (Optional)	The boundaries used to generate the spatial overlay. TRUE —Generates a spatial overlay on selected boundaries. FALSE —Generates a spatial overlay on all boundaries. This is the default.

Code Sample

SpatialOverlay Example (Stand-alone Script)

# Name: SpatialOverlay.py
# Description: Appends total population and total households to a trade area. 
# Author: ESRI

# Import system modules
import arcview
import arcpy

arcpy.ImportToolbox("C:\Program Files\ArcGIS\Desktop10.0\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")

try:
# Acquire extension license
  arcpy.CheckOutExtension("Business") 
 
# Define input and output parameters for the Spatial Overlay tool
  InputPath = "C:/Program Files/ArcGIS/Desktop10.0/Business Analyst/Data/BDS/esri_bg.bds"
  InputOverlay = "C:/temp/TradeArea.shp"
  OutPath = "C:/temp/overlayoutput.shp"
  Sum = "TOTPOP_CY;HHPOP_CY"
 
# Create Spatial Overlay output file
  arcpy.SpatialOverlay_ba(InputPath, InputOverlay, Sum, OutPath, "false")
 
# Release extension license 
  arcpy.CheckInExtension("Business") 
 
except:
  print arcpy.GetMessages(2)

Environments

This tool does not use any geoprocessing environments

Licensing Information

ArcView: Requires Business Analyst

ArcEditor: Requires Business Analyst

ArcInfo: Requires Business Analyst