Repair Self Intersection (Topographic Production)

摘要

Repairs self-intersecting line or polygon features. The portion between the feature and the intersection points are either deleted or split into a new feature.

插图

Repair Self Intersection tool illustration
A Repair Self Intersection tool example with single-part and multipart intersections is shown.

使用情况

    警告:

    此工具会修改输入数据。 有关详细信息以及避免数据被意外更改的策略,请参阅修改或更新输入数据的工具

  • If a feature intersects itself at a point and continues by crossing itself, it is considered a self-intersection. However, if the feature snaps to itself at a point and turns back without crossing itself, it is not considered a self-intersection.

  • If the input features are z-enabled, the z-values at the point of self-intersection will be evaluated and features will only be repaired if the z-values of both segments are identical at the self-intersection point. For example, if all of the z-values on a road represent the ground elevation and the road has a self-intersection, the z-values at the intersection will be identical and the feature will be repaired. However, if the road line represents a ramp, one z-value at the point of intersection is likely on the ground while the other may be elevated to connect to the overpassing feature. Features such as the ramp will not be repaired because the z-values at the intersection point are different.

  • If the input feature contains multiple parts, the following apply:

    • For lines, all parts that are continuous will be considered when determining if there is a self-intersection. For example, if a segment from part 1 of the feature intersects a segment from part 2 of a continuous feature, this will be considered a self-intersection and the feature will be repaired. Lines that are not continuous parts will not be considered intersecting.
    • For polygons, only individual parts will be considered when determining whether there is a self-intersection. For example, if a segment from part 1 of the feature intersects a segment from part 2 of the feature, this will not be considered a self-intersection; however, if a segment from part 1 intersects another segment from part 1, this will be considered a self-intersection.

  • For line features, if the end points of a line touch each other, the feature is considered a line that closes on itself and will not be modified.

  • For line features that have coincident segments rather than coincident vertices, the feature is considered a self-overlapping line and will not be modified.

  • A self-intersection at either the start or end point of a line feature may be considered an acceptable self-intersection, for example, a cul-de-sac where the end point of the geometry touches the interior of the line. Use the Remove Self Intersections at End Point parameter to specify whether self-intersections involving the start or end point will be repaired.

  • For line features, the Maximum Length parameter specifies the length of the segment between the points of self-intersection. For a polygon, the Maximum Length parameter specifies the perimeter of the smaller polygon created by the self-intersection. Only segments with a length or perimeter smaller than the specified maximum length will be removed or split. Use this parameter to differentiate between small self-intersections that may have been created in error and larger self-intersections that were created intentionally.

  • When Split is specified as the Repair Type parameter value, the self-intersecting feature is divided into two features: one with the geometry of the segment between the points of self-intersection and another with the geometry of the segments before and after the intersection.

  • This tool does not support multipart intersections.

参数

标注说明数据类型
Input Features

The polyline or polygon feature class with the self-intersections that will be repaired.

Feature Layer
Repair Type

Specifies whether self-intersections will be deleted or split.

  • DeleteSelf-intersections will be deleted. This is the default.
  • SplitSelf-intersections will be split at the intersection point and retained.
String
Maximum Removal Length
(可选)

The maximum length of the segment between the points of self-intersection. Only segments shorter than the specified maximum length will be removed.

Linear Unit
Remove Self Intersections at End Point
(可选)

Specifies whether self-intersections with an end point that snaps to itself will be removed.

  • Checked—Self-intersections with an end point that snaps to itself will be removed.
  • Unchecked—Self-intersections with an end point that snaps to itself (such as a cul-de-sac) will not be removed. This is the default.
Boolean

派生输出

标注说明数据类型
Updated Input Features

The polygon or polyline features with self-intersections removed.

Feature Layer

arcpy.topographic.RepairSelfIntersection(in_features, repair_type, {max_length}, {repair_at_end_point})
名称说明数据类型
in_features

The polyline or polygon feature class with the self-intersections that will be repaired.

Feature Layer
repair_type

Specifies whether self-intersections will be deleted or split.

  • DELETESelf-intersections will be deleted. This is the default.
  • SPLITSelf-intersections will be split at the intersection point and retained.
String
max_length
(可选)

The maximum length of the segment between the points of self-intersection. Only segments shorter than the specified maximum length will be removed.

Linear Unit
repair_at_end_point
(可选)

Specifies whether self-intersections with an end point that snaps to itself will be removed.

  • REPAIR_ENDSSelf-intersections with an end point that snaps to itself will be removed.
  • IGNORE_ENDSSelf-intersections with an end point that snaps to itself (such as a cul-de-sac) will not be removed. This is the default.
Boolean

派生输出

名称说明数据类型
modified_in_features

The polygon or polyline features with self-intersections removed.

Feature Layer

代码示例

RepairSelfIntersection example (stand-alone script)

The following stand-alone sample script demonstrates how to repair the self-intersections in the roads feature class that are under fifty meters long.

# Name: RepairSelfIntersection_sample.py
# Description: Repair the self-intersections in the roads feature class that are under 50 meters long.  No warnings or errors will be recorded in a table.

# Import System Modules
import arcpy

# Check Out Extensions
arcpy.CheckOutExtension("Foundation")

# Setting Local variables
input_features = r"C:\data\Edit_Sample.gdb\Roads"
maximum_removal_length = "50 Meters"

# Execute Repair Self Intersections
arcpy.topographic.RepairSelfIntersection(in_features, "DELETE", max_length, "IGNORE_ENDS")

# Check In Extensions
arcpy.CheckInExtension("Foundation")

环境

此工具不使用任何地理处理环境。

许可信息

  • Basic: 否
  • Standard: 需要 Production Mapping
  • Advanced: 需要 Production Mapping

相关主题