Available with Advanced license.
Summary
Uses the outside polygon boundary of the clip coverage to cookie-cut features and attributes from the input coverage.
Illustration
Usage
A fuzzy tolerance value of zero will not be accepted by CLIP.
The Clip Coverage must have polygon topology.
When the input coverage contains linear data belonging to different planar graphs, the data will be maintained in the output coverage. For example, with coincident or colinear arcs, such as arcs representing utility cables at different levels or a road following a stream, the coincident and colinear line segments will be preserved. However, additional vertices may be inserted. In the case of intersecting arcs, such as a road passing over a stream, nodes will not be inserted at the apparent intersection.
Boundaries of interior polygons in the Clip Coverage are not used in CLIP. Any Clip Coverage polygon whose internal number is greater than one is considered inside the Clipping window.
The User-ID for each feature will be the same in output coverage as it is in input coverage.
When clipping polygons, new label points for polygons are only generated when necessary. Each old polygon keeps its original label point position if the label is within the clipping boundary.
Annotation is saved if its lower left starting point falls within the clipping polygon.
New nodes created on the clipping boundary have their attributes set to zero.
Route systems are maintained for LINE, NET, LINK, and RAW options but ignored on the POLY option. Route systems are duplicated for arcs split into multiple pieces and eliminated for eliminated arcs. CLIP maintains all route system subclasses.
Route systems are duplicated for arcs split into multiple pieces and eliminated for removed arcs. The RAT<subclass>-ID item is the unique route identifier and is used to remove duplicates. If you need to maintain all the user-defined attributes, make sure all the route IDs are unique before running CLIP; otherwise, some user-defined attributes may be lost.
When all the regions are removed, the region subclasses are maintained as empty subclasses.
Region subclasses of the input coverage are maintained with the POLY and NET options. Regions in the input coverage are clipped in the output coverage by the extent of the Clip Coverage.
The output coverage tics are copied from the input coverage.
Annotation features from the input coverage are clipped and saved in the output coverage.
If an NAT exists in the input coverage, it will be updated in the output coverage. New nodes will have their attributes set to zero.
The output coverage inherits these data model contents from the input coverage:
- Feature classes
- Feature attribute table items
- User-IDs
- Tics
- Annotation
- Node attribute table
- Projection file
The coordinate precision of each output coverage is determined by the current processing rule as set by the Derived Precision environment setting. If the processing rule has not been established during the current session, the output coverages will be in the same precision as the input coverage.
Projection files will be compared for similarity using the level of comparison specified with the Compare Projections environment setting.
Syntax
Clip(in_cover, clip_cover, out_cover, {feature_type}, {fuzzy_tolerance})
Parameter | Explanation | Data Type |
in_cover | The coverage containing features to be clipped. | Coverage |
clip_cover | The coverage whose outer polygon defines the clipping region. | Coverage |
out_cover | The coverage to be created. The output coverage cannot already exist. | Coverage |
feature_type (Optional) | The feature class to be clipped:
| String |
fuzzy_tolerance (Optional) | The minimum distance between coordinates in the output coverage. By default, the minimum fuzzy tolerance value from the input coverage and erase coverage is used. Learn more about how the default fuzzy tolerance is calculated | Double |
Code sample
Clip example (stand-alone script)
The following stand-alone script demonstrates how to create a new coverage that contains the clipped out area of a larger coverage.
# Name: Clip_Example.py
# Description: Clips a subset out of a polygon coverage.
# Requirements: ArcInfo Workstation
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inCover = "tongass1"
clipCover = "tong_basin4"
outCover = "C:/output/basin4"
featureType = "POLY"
# Execute Clip
arcpy.Clip_arc(inCover, clipCover, outCover, featureType, "")
Environments
Licensing information
- Basic: No
- Standard: No
- Advanced: Requires ArcInfo Workstation installed