Overlay Layers (Standard Feature Analysis)

Summary

Overlays the geometries from multiple layers into one single layer. Overlay can be used to combine, erase, modify, or update spatial features. Overlay is more than a merging of geometries; all the attributes of the features in the overlay are included in the output.

Overlay is used to answer one of the most basic questions of geography: "What is on top of what?". The following are examples:

• What parcels are within the 100-year floodplain? (Within is just another way of saying on top of.)
• What roads are within what countries?
• What land use is on top of what soil type?
• What wells are within abandoned military bases?

Illustration

Usage

• Example uses of this tool include the following:

  • The department of environmental quality wants to monitor the impact of grazing livestock on the state's water quality. Biologists with the department need to determine where the land deemed to be grazing allotments intersects with certain watersheds. This tool can be used to find intersecting areas.

  • A development company wants to build a golf resort in one of three centrally located counties in their state. Before they can begin planning, they need to determine whether there is enough privately owned land within those counties that they may be able to purchase for the resort. This tool can be used to remove the publically owned lands from the selected counties.

• This tool requires two inputs: an input layer and an overlay layer. The availability of overlay method options depends on whether the input and overlay layers are points, lines, or areas. The following table describes the method options:

  Overlay method	Input layer	Overlay layer	Description
  Intersect	Points, lines, or areas	Points, lines, or areas	The features or portions of features in the input that are overlapped with the overlay features will be kept. The type of output can be specified as Points, Lines, or Areas when intersecting line or area features. The dimension of the output geometry type must be the same or less than both the input and overlay dimensions in which Points=0 dimensions, Lines=1 dimension, and Areas=2 dimensions. This is the default.
  Union	Areas	Areas	The input and overlay areas will be combined.
  Erase	Areas	Points, lines, or areas	The features or portions of features in the input areas that are overlapped with the overlay features will be removed.

Parameters

Dialog

Label	Explanation	Data Type
Input Layer	The point, line, or polygon features that will be overlaid with the overlay layer.	Feature Set
Overlay Layer	The features that will be overlaid with the input layer features.	Feature Set
Output Name	The name of the output layer that will be created on your portal.	String
Overlay Type (Optional)	The type of overlay that will be performed. Intersect—A geometric intersection of the input layers will be computed. Features or portions of features that overlap in both the input layer and overlay layer will be written to the output layer. This is the default. Union—A geometric union of the input layers will be computed. All features and their attributes will be written to the output layer. This option is only valid if both the input layer and the overlay layer contain polygon features. Erase—Only those features or portions of features in the overlay layer that are not within the features in the input layer will be written to the output.	String
Output Type (Optional)	The type of intersection that will be returned. This parameter is only valid when the overlay type is intersect. Input—The features returned will be the same geometry type as the input layer or overlay layer with the lowest dimension geometry. If all inputs are polygons, the output will contain polygons. If one or more of the inputs are lines and none of the inputs are points, the output will be lines. If one or more of the inputs are points, the output will contain points. This is the default. Line— Line intersections will be returned. This option is only valid if none of the inputs are points. Point— Point intersections will be returned. If the inputs are lines or polygons, the output will be a multipoint layer.	String
Snap To Input (Optional)	Specifies whether feature vertices from the input layer can snap their vertices. The default is unchecked and means if the distance between features is less than the tolerance value, all features from both layers can snap to each other. When checked, only features from the overlay layer can snap to the input layer features. Unchecked—Features from both layers can snap their vertices to each other. This is the default. Checked—Only features from the overlay layer can snap their vertices to the input layer.	Boolean
Tolerance (Optional)	A double value of the minimum distance separating all feature coordinates as well as the distance a coordinate can move in the x or y direction (or both). The units of tolerance are the same as the units of the input layer's coordinate system.	Double

Derived Output

Label	Explanation	Data Type
Output	The features that are the result of the overlay. The type of feature (point, line, or polygon) depends on the input parameter settings.	Feature Set

Python

arcpy.sfa.OverlayLayers(inputLayer, overlayLayer, outputName, {overlayType}, {outputType}, {snapToInput}, {tolerance})

Name	Explanation	Data Type
inputLayer	The point, line, or polygon features that will be overlaid with the overlay layer.	Feature Set
overlayLayer	The features that will be overlaid with the input layer features.	Feature Set
outputName	The name of the output layer that will be created on your portal.	String
overlayType (Optional)	The type of overlay that will be performed. INTERSECT—A geometric intersection of the input layers will be computed. Features or portions of features that overlap in both the input layer and overlay layer will be written to the output layer. This is the default. UNION—A geometric union of the input layers will be computed. All features and their attributes will be written to the output layer. This option is only valid if both the input layer and the overlay layer contain polygon features. ERASE—Only those features or portions of features in the overlay layer that are not within the features in the input layer will be written to the output.	String
outputType (Optional)	The type of intersection that will be returned. This parameter is only valid when the overlay type is intersect. INPUT—The features returned will be the same geometry type as the input layer or overlay layer with the lowest dimension geometry. If all inputs are polygons, the output will contain polygons. If one or more of the inputs are lines and none of the inputs are points, the output will be lines. If one or more of the inputs are points, the output will contain points. This is the default. LINE— Line intersections will be returned. This option is only valid if none of the inputs are points. POINT— Point intersections will be returned. If the inputs are lines or polygons, the output will be a multipoint layer.	String
snapToInput (Optional)	Specifies whether feature vertices from the input layer can snap their vertices. The default is NO_SNAP and means if the distance between features is less than the tolerance value, all features from both layers can snap to each other. When the value is SNAP, only features from the overlay layer can snap to the input layer features. NO_SNAP—Features from both layers can snap their vertices to each other. This is the default. SNAP—Only features from the overlay layer can snap their vertices to the input layer.	Boolean
tolerance (Optional)	A double value of the minimum distance separating all feature coordinates as well as the distance a coordinate can move in the x or y direction (or both). The units of tolerance are the same as the units of the input layer's coordinate system.	Double

Derived Output

Name	Explanation	Data Type
output	The features that are the result of the overlay. The type of feature (point, line, or polygon) depends on the input parameter settings.	Feature Set

Environments

Extent

Licensing information

• Basic: Requires your account in ArcGIS Enterprise to have the Perform Analysis privilege
• Standard: Requires your account in ArcGIS Enterprise to have the Perform Analysis privilege
• Advanced: Requires your account in ArcGIS Enterprise to have the Perform Analysis privilege