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 Must Be Larger Than Cluster tolerance](GUID-4D940220-0FAC-4F40-8589-E717D7788A74-web.png)
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 Must Be Larger Than Cluster tolerance errors](GUID-14EC68E3-49BB-4286-9CF0-8435F6B2A53A-web.png)
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.
![Must Not Overlap Must Not Overlap](GUID-3072D7F4-B9AA-4BFA-92FF-5B94D8FA6C60-web.png)
Errors
Line errors are created where lines overlap.
![Must Not Overlap errors Must Not Overlap errors](GUID-3A4B0BC4-51FE-47DC-B54D-53551D33416D-web.png)
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.
![Must Not Intersect Must Not Intersect](GUID-63285C94-45EB-419C-9FDE-23C2EA406CBB-web.png)
Errors
Line errors are created where lines overlap, and point errors are created where lines cross.
![Must Not Intersect errors Must Not Intersect errors](GUID-2BE45C28-4DB0-406A-896B-04BCA5ED0DD6-web.png)
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.
![Must Not Intersect With Must Not Intersect With](GUID-BA9F807A-398F-45A5-8562-AD4DAE7126E2-web.png)
Errors
Line errors are created where lines overlap, and point errors are created where lines cross.
![Must Not Intersect With errors Must Not Intersect With errors](GUID-3CA9B578-0A17-43FB-A20E-AB3FC6C4882A-web.png)
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.
![Must Not Have Dangles Must Not Have Dangles](GUID-7B91006E-72AD-461A-A270-6CB60BD0CC06-web.png)
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 Must Not Have Dangles errors](GUID-D5FA8852-8940-4FED-ADF9-4EFDC467D3AD-web.png)
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.
![Must Not Have Pseudo Nodes Must Not Have Pseudo Nodes](GUID-1ED6E652-F581-44A3-AA29-A71FF90288CB-web.png)
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 Must Not Have Pseudo Nodes errors](GUID-E7B33848-6A7B-4DAD-800D-ECC43EB3A5FD-web.png)
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.
![Must Not Intersect Or Touch Interior Must Not Intersect Or Touch Interior](GUID-829B7571-4DDD-4163-9D3E-FFEA40A21324-web.png)
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 Must Not Intersect Or Touch Interior errors](GUID-271C4451-E80D-4AE4-9DF1-785BDEB269D7-web.png)
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.
![Must Not Intersect Or Touch Interior With Must Not Intersect Or Touch Interior With](GUID-A03208FC-60CE-4E08-B89B-2F45245E79F0-web.png)
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 Must Not Intersect Or Touch Interior With errors](GUID-B53BCD9D-DC12-4F18-BE18-A2B63695E1DD-web.png)
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.
![Must Not Overlap With Must Not Overlap With](GUID-31B13B2E-F4FA-4AC4-B64E-52D35CD1DE39-web.png)
Errors
Line errors are created where lines from two feature classes or subtypes overlap.
![Must Not Overlap With errors Must Not Overlap With errors](GUID-23E0C69C-5A28-4239-8B08-B0FC2104FB2A-web.png)
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.
![Must Be Covered By Feature Class Of Must Be Covered By Feature Class Of](GUID-A549E51D-8E1D-41FB-93C6-61883BF330AA-web.png)
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 Must Be Covered By Feature Class Of errors](GUID-CEF2CB37-AFEC-4365-9F1E-8DA598A4D3D7-web.png)
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 Must Be Covered By Boundary Of](GUID-806ABD6D-B2DB-4E7D-84EE-D6A415283BCA-web.png)
Errors
Line errors are created on lines that are not covered by the boundaries of polygons.
![Must Be Covered By Boundary Of errors Must Be Covered By Boundary Of errors](GUID-E526EB16-DD42-4D80-90F6-705AD76903BA-web.png)
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.
![Must Be Inside Must Be Inside](GUID-2F7C30D9-0830-4A97-9FE7-FCB912FA9BFB-web.png)
Errors
Line errors are created where lines are not within polygons.
![Must Be Inside errors Must Be Inside errors](GUID-14DD6DD9-DE9C-4F2A-9037-3434F0AE4D19-web.png)
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.
![Endpoint Must Be Covered By Endpoint Must Be Covered By](GUID-C1E11814-AE8B-4364-98AA-6A081FC15334-web.png)
Errors
Point errors are created at the ends of lines that are not covered by a point.
![Endpoint Must Be Covered By errors Endpoint Must Be Covered By errors](GUID-5BC2F4C8-4ED8-4702-9E77-87FEC52FE5E8-web.png)
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.
![Must Not Self-Overlap Must Not Self-Overlap](GUID-F064868C-0BB2-4FB8-83D8-4193608F5A51-web.png)
Errors
Line errors are created where lines overlap themselves.
![Must Not Self-Overlap errors Must Not Self-Overlap errors](GUID-9D2D6859-9C78-4BDA-AF67-E626FBCB7655-web.png)
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.
![Must Not Self-Intersect Must Not Self-Intersect](GUID-9D21E7D7-EDAC-42D5-ADFC-83D82EB99E20-web.png)
Errors
Line errors are created where lines overlap themselves, and point errors are created where lines cross themselves.
![Must Not Self-Intersect errors Must Not Self-Intersect errors](GUID-A1FEF6F3-18DE-4E5C-A346-564144A237E9-web.png)
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.
![Must Be Single Part Must Be Single Part](GUID-9522DB41-7044-4691-A741-1A02F095D7FE-web.png)
Errors
Multipart line errors are created where lines have more than one part.
![Must Be Single Part Must Be Single Part](GUID-DA4472EF-D332-4602-9FFB-F0FBE42A6905-web.png)
Predefined fixes
Explode creates single-part line features from each part of the multipart line feature that is in error.