Spatial Overlay (Online) (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.
Illustration
Usage
-
The input layer must be properly formatted using the Analysis Layer Setup tool in 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.
-
Do not 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
| 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,...,...] |
The 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.
| Boolean |
UseSelectedFeatures (Optional) |
The boundaries used to generate the spatial overlay.
| Boolean |
Code Sample
# 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(InputOverlay, Sum, "false")
# Release extension license
arcpy.CheckInExtension("Business")
except:
print arcpy.GetMessages(2)