Skip To Content

Geodatabase topology rules and fixes for polyline features

Available with Standard or Advanced license.

Geodatabase topology rules allow you to define relationships between features in the same feature class or subtype or between two feature classes or subtypes. The status of a topology, including errors and exceptions, is saved to the source geodatabase. In the Contents pane, geodatabase topology rules appear as group layers containing sublayers that symbolize modified areas, and errors organized by geometry type.

This topic explains the topology rules available for polyline features and their predefined fixes. For steps to validate a geodatabase topology and fix errors, see Validate and fix geodatabase topology.

Note:

For a poster-size PDF file listing all topology rules, see ArcGIS Geodatabase Topology Rules.

Must Be Larger Than Cluster tolerance

The cluster tolerance is the minimum distance between the vertices that make up a feature. Vertices that fall within the cluster tolerance are determined to be coincident. This rule is mandatory for a topology and applies to all polyline feature classes.

Must Be Larger Than Cluster tolerance

Errors

Any polyline feature that would collapse when validating the topology is an error. Features that violate this rule are left unchanged.

Must Be Larger Than Cluster tolerance errors

Predefined fixes

Delete Feature Delete removes polyline features that would collapse during the validate process based on the cluster tolerance.

Must Not Overlap

Lines must not overlap any part of another line within a feature class or subtype. Lines can touch, intersect, and overlap themselves. Use this rule with lines that should never occupy the same space with other lines, for example, when lot lines cannot overlap one another.

Must Not Overlap

Errors

Line errors are created where lines overlap.

Must Not Overlap errors

Predefined fixes

Remove Overlap Remove overlap removes the overlapping line segments from the feature causing the error. You can choose the feature to preserve or apply the fix to all errors.

Must Not Intersect

Lines must not cross or overlap any part of another line within the same feature class or subtype. Use this rule with lines whose segments should never cross or occupy the same space with other lines, for example, when lot lines cannot intersect or overlap, but the endpoint of one feature can touch the interior of another feature.

Must Not Intersect

Errors

Line errors are created where lines overlap, and point errors are created where lines cross.

Must Not Intersect errors

Predefined fixes

Remove Overlap Remove overlap removes the overlapping line segments from the feature causing the error. You can choose the feature to preserve or apply the fix to all errors.

Split Split Line splits the line features that cross one another at their point of intersection. If two lines cross at a single point, the result is four features. Attributes from the original features will be maintained in the split features. If a split policy is present, the attributes will be updated accordingly.

Must Not Intersect With

Lines must not cross or overlap any part of another line within the same feature class or subtype. Use this rule with lines whose segments should never cross or occupy the same space with other lines, for example, when lot lines cannot intersect or overlap, but the endpoint of one feature can touch the interior of another feature.

Must Not Intersect With

Errors

Line errors are created where lines overlap, and point errors are created where lines cross.

Must Not Intersect With errors

Predefined fixes

Remove Overlap Remove overlap removes the overlapping line segments from the feature causing the error. You can choose the feature to preserve or apply the fix to all errors.

Split Split Line splits the line features that cross one another at their point of intersection. If two lines cross at a single point, the result is four features. Attributes from the original features will be maintained in the split features. If a split policy is present, the attributes will be updated accordingly.

Must Not Have Dangles

The end of a line must touch any part of one other line or any part of itself within a feature class or subtype. Use this rule when you want lines in a feature class or subtype to connect to one another, for example, when a street network has line segments that connect. In this example, you can set exceptions to this rule for road segments that end at cul-de-sacs or terminate with dead-ends.

Must Not Have Dangles

Errors

Point errors are created at the end of a line that does not touch at least one other line or itself.

Must Not Have Dangles errors

Predefined fixes

Extend Extend extends the dangling end of line features if they snap to other line features within a given distance. If no feature is found within the specified distance, the feature is not extended. If the distance value is 0, lines will extend until they snap to a feature. When you apply the fix to all errors, features that cannot be extended are skipped and remain errors.

Trim Trim to Length trims dangling line features if the intersection is within the specified distance. If no feature is found within the specified distance, the feature is not trimmed. When specified distance is greater than the length of the feature in error, it is not deleted. If the distance value is 0, lines are trimmed to the intersection. When you apply the fix to all errors, features that cannot be trimmed are skipped and remain errors.

Snap List By Snapping snaps dangling line features to the nearest line feature within a given distance. If no line feature is found within the distance specified, the line will not be snapped. This command snaps to the nearest feature found within the distance. It searches for endpoints to snap to first, then vertices, and finally to the edge of line features within the feature class.

Must Not Have Pseudo Nodes

The end of a line cannot touch the end of only one other line within a feature class or subtype. The end of a line can touch any part of itself. Use this rule to clean up data with inappropriately subdivided lines. For example, for hydrologic analysis, segments of a river system might be constrained to only have nodes at endpoints or junctions.

Must Not Have Pseudo Nodes

Errors

Point errors are created where the end of a line touches the end of only one other line.

Must Not Have Pseudo Nodes errors

Predefined fixes

Merge To Largest Merge merges the geometry of the shorter line into the geometry of the longest line. You can choose the feature to preserve or apply the fix to all errors.

Merge Merge adds the geometry of one line feature into the other line feature causing the error. You can choose the feature to preserve or apply the fix to all errors.

Must Not Intersect Or Touch Interior

Lines can only touch at their ends and must not overlap each other within a feature class or subtype. Use this rule when you only want lines to touch at their ends and not intersect or overlap, for example, when lot lines cannot intersect or overlap and must connect to one another only at the endpoint of each line feature.

Must Not Intersect Or Touch Interior

Errors

Line errors are created where lines overlap, and point errors are created where lines cross or touch.

Must Not Intersect Or Touch Interior errors

Predefined fixes

Remove Overlap Remove overlap removes the overlapping line segments from the feature causing the error. You can choose the feature to preserve or apply the fix to all errors.

Split Split Line splits the line features that cross one another at their point of intersection. If two lines cross at a single point, the result is four features. Attributes from the original features will be maintained in the split features. If a split policy is present, the attributes will be updated accordingly.

Must Not Intersect Or Touch Interior With

Lines in one feature class or subtype can only touch at their ends and must not overlap lines in another feature class or subtype. Use this rule when you only want lines to touch at their ends and not intersect or overlap with lines in another feature class or subtype, for example, when lot lines cannot intersect or overlap block lines and must connect to one another only at the endpoint of each line feature.

Must Not Intersect Or Touch Interior With

Errors

Line errors are created where lines overlap, and point errors are created where lines cross or touch.

Must Not Intersect Or Touch Interior With errors

Predefined fixes

Remove Overlap Remove overlap removes the overlapping line segments from the feature causing the error. You can choose the feature to preserve or apply the fix to all errors.

Split Split Line splits the line features that cross one another at their point of intersection. If two lines cross at a single point, the result is four features. Attributes from the original features will be maintained in the split features. If a split policy is present, the attributes will be updated accordingly.

Must Not Overlap With

Lines in one feature class or subtype must not overlap any part of another line in another feature class or subtype. Use this rule for lines that should never occupy the same space with lines in another feature class or subtype, for example, when highways can cross and come close to rivers, but road segments cannot overlap river segments.

Must Not Overlap With

Errors

Line errors are created where lines from two feature classes or subtypes overlap.

Must Not Overlap With errors

Predefined fixes

Remove Overlap Remove overlap removes the overlapping line segments from the feature causing the error. You can choose the feature to preserve or apply the fix to all errors.

Must Be Covered By Feature Class Of

Lines in one feature class or subtype must be covered by lines in another feature class or subtype. Use this rule when you have multiple groups of lines describing the same geography, for example, when lines that make up bus routes must be on top of lines in a road network.

Must Be Covered By Feature Class Of

Errors

Line errors are created on the lines in the first feature class that are not covered by lines in the second feature class.

Must Be Covered By Feature Class Of errors

Predefined fixes

A predefined fix is not available for this error. Consider using tools in the Modify Features pane.

Must Be Covered By Boundary Of

Lines in one feature class or subtype must be covered by the boundaries of polygons in another feature class or subtype. Use this rule when you want to model lines that are coincident with the boundaries of polygons, for example, when polyline features used for displaying block and lot boundaries must be covered by parcel boundaries.

Must Be Covered By Boundary Of

Errors

Line errors are created on lines that are not covered by the boundaries of polygons.

Must Be Covered By Boundary Of errors

Predefined fixes

Remove Overlap Remove overlap removes the overlapping line segments from the feature causing the error. You can choose the feature to preserve or apply the fix to all errors.

Must Be Inside

Lines in one feature class or subtype must be contained by polygons of another feature class or subtype. Use this rule when you want lines to be contained within the boundaries of polygons, for example, when streams are within watersheds.

Must Be Inside

Errors

Line errors are created where lines are not within polygons.

Must Be Inside errors

Predefined fixes

Delete Feature Delete removes line features that are not within polygon features.

Endpoint Must Be Covered By

The ends of lines in one feature class or subtype must be covered by points in another feature class or subtype. Use this rule when you want to model the ends of lines in one feature class or subtype that are coincident with point features in another feature class, for example, when endpoints of secondary electric lines must be capped by either a transformer or meter.

Endpoint Must Be Covered By

Errors

Point errors are created at the ends of lines that are not covered by a point.

Endpoint Must Be Covered By errors

Predefined fixes

Create Feature Create Features adds a new point feature at the endpoint of the line feature that is in error.

Must Not Self-Overlap

Lines must not overlap themselves within a feature class or subtype. Lines can touch, intersect, and overlap lines in another feature class or subtype. Use this rule with lines whose segments should never occupy the same space as another segment on the same line. For example, for transportation analysis, street and highway segments of the same feature should not overlap themselves.

Must Not Self-Overlap

Errors

Line errors are created where lines overlap themselves.

Must Not Self-Overlap errors

Predefined fixes

Simplify Simplify removes self-overlapping line segments from the feature in error. This can result in multipart features, which you can detect using the Must Be Single Part rule.

Must Not Self-Intersect

Lines must not cross or overlap themselves within a feature class or subtype. Lines can touch themselves and touch, intersect, and overlap other lines. Use this rule when you only want lines to touch at their ends without intersecting or overlapping themselves, for example, when contour lines cannot intersect themselves.

Must Not Self-Intersect

Errors

Line errors are created where lines overlap themselves, and point errors are created where lines cross themselves.

Must Not Self-Intersect errors

Predefined fixes

Simplify Simplify removes self-overlapping line segments from the feature in error. This can result in multipart features, which you can detect using the Must Be Single Part rule.

Must Be Single Part

Lines within a feature class or subtype must only have one part. Use this rule when you want lines to be composed of a single series of connected segments, for example, when a highway system is made up of individual features where any one feature is not made up of more than one part.

Must Be Single Part

Errors

Multipart line errors are created where lines have more than one part.

Must Be Single Part

Predefined fixes

Explode Explode creates single-part line features from each part of the multipart line feature that is in error.