Geoprocessing tool reference > Analysis toolbox > Overlay toolset > Tools
Identity (Analysis) (ArcInfo only) |
|
|
Release 9.2
Last modified January 13, 2009 |
Print all topics in : "Tools" |
Computes a geometric intersection of the Input Features and Identity Features. The Input Features or portions thereof that overlap Identity Features will get the attributes of those Identity Features.
Learn more about how Identity works
Illustration
Usage tips
-
The Input Features must be point, multipoint, line, or polygon. The inputs cannot be annotation features, dimension features, or network features.
-
The Identity Features must be polygons.
-
Output may be multipart. If multipart features are not desired, use the Multipart to Singlepart tool on the output.
-
Checking or setting the Relationship parameter to KEEP_RELATIONSHIPS will write additional spatial relationships between the Input Features and the Identity Features to the output feature class. If the inputs are lines and the Identity Features are polygons, there will be two additional fields, LEFT_poly and RIGHT_poly. These new fields will contain the FID of the polygon Identity Features to the right and to the left of each input line feature.
-
When processing datasets that contain any individual feature with a very large number of vertices (e.g., hundreds of thousands to millions of vertices within a single feature), some geometric processing operations may run out of memory. For more details, see Geoprocessing with large datasets.
-
The following environment settings affect this tool: Coordinate system, Extent, XY Tolerance, Z Tolerance, M Tolerance, XY Resolution, Z Resolution, M Resolution, Output XY domain, Output Z domain, Output M domain, Output has M values, Output has Z values, Default Z value, Configuration keyword, Output Spatial Grid.
Command line syntax
An overview of the Command Line window
Identity_analysis <in_features> <identity_features> <out_feature_class> {NO_FID | ONLY_FID | ALL} {cluster_tolerance} {KEEP_RELATIONSHIPS | NO_RELATIONSHIPS}
| Parameter | Explanation | Data Type |
| <in_features> |
The input feature class or layer. |
Feature Layer |
| <identity_features> |
The identity feature class or layer. Must be polygons. |
Feature Layer |
| <out_feature_class> |
The feature class that will be created and to which the results will be written. |
Feature Class |
| {NO_FID | ONLY_FID | ALL} |
Determines what attributes will be transferred to the Output Feature Class
|
String |
| {cluster_tolerance} |
The minimum distance separating all feature coordinates (nodes and vertices) as well as the distance a coordinate can move in X or Y (or both). You can set the value to be higher for data that has less coordinate accuracy and lower for datasets with extremely high accuracy. |
Linear unit |
| {KEEP_RELATIONSHIPS | NO_RELATIONSHIPS} |
Choose if you want additional spatial relationships between the Input Features and Identity Features to be written to the output. This only applies when the Input Features are lines and the Identity Features are polygons
|
Boolean |
Command line example
identity_analysis wells counties wells_w_county_info
Scripting syntax
About getting started with writing geoprocessing scripts
Identity_analysis (in_features, identity_features, out_feature_class, join_attributes, cluster_tolerance, relationship)
| Parameter | Explanation | Data Type |
| in_features (Required) |
The input feature class or layer. |
Feature Layer |
| identity_features (Required) |
The identity feature class or layer. Must be polygons. |
Feature Layer |
| out_feature_class (Required) |
The feature class that will be created and to which the results will be written. |
Feature Class |
| join_attributes (Optional) |
Determines what attributes will be transferred to the Output Feature Class
|
String |
| cluster_tolerance (Optional) |
The minimum distance separating all feature coordinates (nodes and vertices) as well as the distance a coordinate can move in X or Y (or both). You can set the value to be higher for data that has less coordinate accuracy and lower for datasets with extremely high accuracy. |
Linear unit |
| relationship (Optional) |
Choose if you want additional spatial relationships between the Input Features and Identity Features to be written to the output. This only applies when the Input Features are lines and the Identity Features are polygons
|
Boolean |
Data types for geoprocessing tool parameters
Script example
# IdentityWells.py
# Description: Simple example showing use of Identity tool
# Requirements: Python and the Python win32all extension
# Author: ESRI
# Data 1/1/2004
# Create the geoprocessor
import arcgisscripting
gp = arcgisscripting.create()
# Use error trapping in case a problem occurs when running the Identity tool
try:
gp.identity_analysis("wells", "counties", "wells_w_county_info")
except:
# If an error occurred, print out the error message
print gp.GetMessage()