Integrate (Data Management)

License Level:BasicStandardAdvanced

Summary

Integrate is used to maintain the integrity of shared feature boundaries by making features coincident if they fall within the specified x,y tolerance. Features that fall within the specified x,y tolerance are considered identical or coincident.

For example, suppose you specify an x,y tolerance of five units (such as feet or meters) and your data has a parcel boundary that should be shared with the adjacent parcel boundary but is four units away. After running this tool, the boundaries of the two parcels would be made coincident because they were within the x,y tolerance of five units.

Integrate performs the following processing tasks:

Illustration

Integrate Illustration

Usage

Syntax

Integrate_management (in_features, {cluster_tolerance})
ParameterExplanationData Type
in_features
[[Feature Layer, Long],...]

The feature classes to be integrated. When the distance between features is small in comparison to the tolerance the vertices or points will be clustered (moved to be coincident). The feature class or layer with the lower rank will snap to the feature from the feature class or layer with the higher rank (with 1 being a higher rank than 2). Note that features in the feature class with a rank of 1 may move when a large x,y tolerance is used.

Value Table
cluster_tolerance
(Optional)

The distance that determines the range in which feature vertices are made coincident. To minimize undesired movement of vertices, the x,y tolerance should be fairly small. If no value is specified, the xy tolerance from the first dataset in the list of inputs will be used.

Linear unit

Code Sample

Integrate Example (Python Window)

The following Python window script demonstrates how to use the Integrate function in immediate mode.

import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.CopyFeatures_management("Habitat_Analysis.gdb/vegtype", "C:/output/output.gdb/vegtype")
arcpy.Integrate_management("C:/output/output.gdb/vegtype", 0.01)
Integrate Example 2 (stand-alone script)

The following stand-alone script is a simple example of how to apply the Integrate function in a scripting environment.

# Name: Integrate_Example2.py
# Description: Run Integrate on a feature class
 
# Import system modules
import arcpy
from arcpy import env
 
# Set environment settings
env.workspace = "C:/data/Habitat_Analysis.gdb"
 
# Set local variables
inFeatures = "vegtype"
integrateFeatures = "C:/output/output.gdb/vegtype"
xyTolerance = "0.1 feet"
 
# Execute CopyFeature (since Integrate modifies the original data
#  this ensures the original is preserved)
arcpy.CopyFeatures_management(inFeatures, integrateFeatures)
 
# Execute Integrate
arcpy.Integrate_management(integrateFeatures, xyTolerance)

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Yes
ArcGIS for Desktop Standard: Yes
ArcGIS for Desktop Advanced: Yes
5/7/2015