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.
Errors
Any polyline feature that would collapse when validating the topology is an error. Features that violate this rule are left unchanged.
Predefined fixes
Delete Feature 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.
Errors
Line errors are created where lines overlap.
Predefined fixes
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.
Errors
Line errors are created where lines overlap, and point errors are created where lines cross.
Predefined fixes
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 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.
Errors
Line errors are created where lines overlap, and point errors are created where lines cross.
Predefined fixes
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 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.
Errors
Point errors are created at the end of a line that does not touch at least one other line or itself.
Predefined fixes
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 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 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.
Errors
Point errors are created where the end of a line touches the end of only one other line.
Predefined fixes
Merge To Largest 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 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.
Errors
Line errors are created where lines overlap, and point errors are created where lines cross or touch.
Predefined fixes
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 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.
Errors
Line errors are created where lines overlap, and point errors are created where lines cross or touch.
Predefined fixes
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 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.
Errors
Line errors are created where lines from two feature classes or subtypes overlap.
Predefined fixes
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.
Errors
Line errors are created on the lines in the first feature class that are not covered by lines in the second feature class.
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.
Errors
Line errors are created on lines that are not covered by the boundaries of polygons.
Predefined fixes
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.
Errors
Line errors are created where lines are not within polygons.
Predefined fixes
Delete Feature 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.
Errors
Point errors are created at the ends of lines that are not covered by a point.
Predefined fixes
Create Feature 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.
Errors
Line errors are created where lines overlap themselves.
Predefined fixes
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.
Errors
Line errors are created where lines overlap themselves, and point errors are created where lines cross themselves.
Predefined fixes
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.
Errors
Multipart line errors are created where lines have more than one part.
Predefined fixes
Explode creates single-part line features from each part of the multipart line feature that is in error.