Identity (Coverage)

This tool only works with an ArcInfo license and will only be available in ArcToolbox if you have installed ArcInfo Workstation.

Computes the geometric intersection of two coverages. All features of the input coverage, as well as those features of the identity coverage that overlap the input coverage, are preserved in the output coverage.

Learn more about how Identity works


Illustration

Identity illustartion

Usage tips

Syntax

Identity _arc (in_cover, identity_cover, out_cover, feature_type, fuzzy_tolerance, join_attributes)
Parameter Explanation Datatype
Input Coverage (Required)

The coverage that will be overlaid with the identity coverage.

Coverage
Identity Coverage (Required)

The coverage that will be identitied with the input coverage. Must have polygon features.

Coverage
Output Coverage (Required)

The coverage to be created.

Coverage
Feature Type (Optional)

The feature class from the input coverage that will be used.

  • POLY—Poly on poly overlay. This is the default option.
  • LINE—Line on poly overlay.
  • POINT—Point on poly overlay.

String
Fuzzy Tolerance (Optional)

The minimum distance between coordinates in the output coverage. By default, the minimum fuzzy tolerance value from the input and erase coverages is used. Learn more about how the default fuzzy tolerance is calculated

Double
Join Attributes (Optional)

Specifies whether all items in both the input coverage feature attribute and identity coverage will be joined to the output coverage feature attribute table.

  • JOIN—All feature attribute items from both coverages will appear in the output coverage feature attribute table. If a duplicate item is encountered, the item in the input coverage will be maintained and the one in the join file will be dropped. This is the default option.
  • NO_JOIN—Only the feature's internal number (cover#) from the input coverage and the intersect coverage are joined in the output coverage feature attribute table. This option is useful in reducing the size of the output coverage feature attribute table. The Add Join tool can then be used to get the attributes to the output coverage features.

Boolean
Data types for geoprocessing tool parameters

Script Example

# Identity.py
# Description: Identities all wells to counties coverage
# Requirements: Python and the Python win32all extension
# Author: ESRI
# Data 1/6/2004

# Create the Geoprocessor
import arcgisscripting
gp = arcgisscripting.create()

# Put in error trapping in case an error occurs when running tool
try:
    gp.Workspace = "c:/myws"
    # Identity the wells to the counties
    gp.Identity_arc("wells","counties","wellsgc")

except:
    # If an error occurred print the message to the screen
    print gp.GetMessages()
    print "FINISHED"

See Also

  • Add CAD Fields (Conversion)
  • Clip (Coverage)
  • Create CAD XData (Conversion)
  • Erase (Coverage)
  • Intersect (Coverage)
  • Set CAD Alias (Conversion)
  • Union (Coverage)