Pairwise Integrate (Analysis)

Summary

Analyzes the coordinate locations of feature vertices among features in one or more feature classes. Those that fall within a specified distance of one another are assumed to represent the same location and are assigned a common coordinate value (in other words, they are colocated). The tool also adds vertices where feature vertices are within the x,y tolerance of an edge and where line segments intersect.

Pairwise Integrate performs the following processing tasks:

• Vertices within the x,y tolerance of one another will be assigned the same coordinate location.
• When a vertex of one feature is within the x,y tolerance of an edge of any other feature, a new vertex will be inserted on the edge.
• When line segments intersect, a vertex will be inserted at the point of intersection for each feature involved in the intersection.

An alternate tool is available for vector data integration. See the Integrate tool documentation for details.

Illustration

Usage

Caution:

This tool modifies the input data. See Tools that modify or update the input data for more information and strategies to avoid undesired data changes.

• If input features are selected, this tool will run only on those selected features.

• This tool performs the same kind of work as a topology in that it moves features within an x,y tolerance and inserts vertices where features intersect. Consider using a topology to perform this type of operation, because a topology allows you to specify rules and conditions about how features relate to each other.

  Use this tool rather than a topology in the following circumstances:

  • You do not need to specify rules about how features are moved and you want all features to coalesce within a specified tolerance.
  • You want lines to have vertices wherever they intersect.
  • You are working with nongeodatabase features, such as shapefiles, or with features from different geodatabases (features in a topology must all come from the same feature dataset).

• Potential problems present in the data may be resolved during integration. Handling of extremely small overshoots or undershoots, automatic sliver removal of duplicate segments, and coordinate thinning along boundary lines may be resolved.

• It is recommended that you do not provide a value for the XY Tolerance parameter. When no value is provided, the tool will check the input feature classes' spatial reference to determine the x,y tolerance to use during integration. Ensure that the spatial reference of the input data is set to its default x,y resolution and x,y tolerance.

  The XY Tolerance parameter is not intended to be used to generalize geometry shapes. It is intended to integrate line work and boundaries within the context of a properly set input feature class spatial reference. Setting the XY Tolerance parameter to a value other than the default for the input spatial reference may cause features to move too much or too little, resulting in geometry issues. If the correct spatial reference properties are used, running the Integrate tool can minimize the amount of movement in the data during subsequent topological operations (such as overlay and dissolve).

  Learn more about cluster processing

• This tool only accepts simple feature classes as input (point, multipoint, line, or polygon).

• To undo changes to the input features, use this tool in an edit session.

• The output data element of this tool is a derived multivalue output. To use this tool's output with another tool, use its input directly and set its output as a precondition of the other tool.

  Learn more about setting a precondition

• This tool honors the Parallel Processing Factor environment. If the environment is not set (the default) or is set to 100, full parallel processing will be enabled and the tool will attempt to distribute the work to all the logical cores on the machine. If the environment is set to 0, parallel processing will not be enabled. If a factor between 1 and 99 is specified, the tool will identify the percentage of logical cores to use by applying the formula (Parallel Processing Factor / 100 * Logical Cores) rounded up to the nearest integer. If the result of this formula is 0 or 1, parallel processing will not be enabled.

Parameters

Dialog

Label	Explanation	Data Type
Input Features	The feature classes that will 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).	Value Table
XY 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 small. If no value is provided, the x,y tolerance from the first dataset in the list of inputs will be used. Caution: Changing this parameter's value may cause failure or unexpected results. It is recommended that you do not modify this parameter. It has been removed from view on the tool dialog box. By default, the input feature class's spatial reference x,y tolerance property is used.	Linear Unit

Derived Output

Label	Explanation	Data Type
Updated Input Features	The updated input features.	Feature Layer

Python

arcpy.analysis.PairwiseIntegrate(in_features, {cluster_tolerance})

Name	Explanation	Data Type
in_features [in_features,...]	The feature classes that will 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).	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 small. If no value is provided, the x,y tolerance from the first dataset in the list of inputs will be used. Caution: Changing this parameter's value may cause failure or unexpected results. It is recommended that you do not modify this parameter. It has been removed from view on the tool dialog box. By default, the input feature class's spatial reference x,y tolerance property is used.	Linear Unit

Derived Output

Name	Explanation	Data Type
out_features	The updated input features.	Feature Layer

Code sample

PairwiseIntegrate example 1 (Python window)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.CopyFeatures("Habitat_Analysis.gdb/vegtype", "C:/output/output.gdb/vegtype")
arcpy.analysis.PairwiseIntegrate("C:/output/output.gdb/vegtype")

PairwiseIntegrate example 2 (stand-alone script)

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

# Description: Run PairwiseIntegrate on a feature class

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"

# Set local variables
inFeatures = "vegtype"
integrateFeatures = "C:/output/output.gdb/vegtype"

# Run CopyFeatures (since PairwiseIntegrate modifies the original data, this 
# ensures the original is preserved)
arcpy.management.CopyFeatures(inFeatures, integrateFeatures)

# Run PairwiseIntegrate
arcpy.analysis.PairwiseIntegrate(integrateFeatures)

Environments

Current Workspace, Extent, XY Tolerance, Parallel Processing Factor

Licensing information

• Basic: Yes
• Standard: Yes
• Advanced: Yes