Repair Geometry (Data Management)

This ArcGIS 2.8 documentation has been archived and is no longer updated. Content and links may be outdated. See the latest documentation.

Summary

Inspects each feature in a feature class for problems with its geometry. Upon discovery of a problem, a fix will be applied, and a one-line description will identify the feature, as well as the geometry problem that was fixed.

This tool uses the same logic as the Check Geometry tool to repair geometry problems.

Learn more about checking and repairing geometries

Usage

    Caution:

    This tool modifies the input data. See Tools that modify or update the input data for more information and strategies to avoid undesired data changes.

  • Valid input formats are shapefiles and feature classes stored in a file or enterprise geodatabase. For feature classes stored in an enterprise geodatabase, the following spatial types are supported:

    • Microsoft SQL Server Geometry and Geography
    • PostgreSQL PostGIS Geometry and Geography
    • Oracle SDO Geometry

  • The Enable Undo toggle button is not valid for inputs from an enterprise geodatabase.

  • Below is the list of geometry problems and the corresponding fix that will be performed by the tool:

    • Null geometry—The record will be deleted from the feature class. To keep records with null geometry, uncheck Delete Features with Null Geometry (use the KEEP_NULL option on the delete_null parameter in Python).
    • Short segment—The geometry's short segment will be deleted.
    • Incorrect ring ordering—The geometry will be updated with the correct ring ordering.
    • Incorrect segment orientation—The geometry will be updated with the correct segment orientation.
    • Self intersections—The areas of overlap in a polygon will be dissolved.
    • Unclosed rings—The unclosed rings will be closed by connecting the end points of the rings.
    • Empty parts—The parts that are null or empty will be deleted.
    • Duplicate vertex—One of the vertices will be deleted.
    • Mismatched attributes—The z- or m-coordinate will be updated to match.
    • Discontinuous parts—Multiple parts will be created from the existing discontinuous part.
    • Empty Z values: The z-value will be set to 0.
    • Bad envelope—The feature's envelope will be updated to be correct.

    Below is the list of geometry problems that may occur from data stored in an enterprise geodatabase and the corresponding fix that will be performed by the tool:

    • NEEDS_REORDERING—The shape will be reordered and duplicate points removed.
    • SE_INVALID_ENTITY_TYPE—Not repairable (feature must be deleted).
    • SE_SHAPE_INTEGRITY_ERROR—Not always repairable.
    • SE_INVALID_SHAPE_OBJECT—Not always repairable.
    • SE_COORD_OUT_OF_BOUNDS—Not repairable.
    • SE_POLY_SHELLS_OVERLAP—Overlapping shells are merged.
    • SE_TOO_FEW_POINTS—Not repairable.
    • SE_INVALID_PART_SEPARATOR—Not always repairable.
    • SE_INVALID_POLYGON_CLOSURE—Unclosed shells will be discarded (the resulting polygon may be left empty).
    • SE_INVALID_OUTER_SHELL—An attempt to repair the feature's outer shells will be made; shells may be discarded in the process.
    • SE_ZERO_AREA_POLYGON—Converted to empty shape.
    • SE_POLYGON_HAS_VERTICAL_LINE—The vertical line is removed (the shape may be converted to 2D).
    • SE_OUTER_SHELLS_OVERLAP—Overlapping parts are merged.
    • SE_SELF_INTERSECTING—Intersection points are added as needed.

    Note:

    Some problems associated with data stored in an enterprise database may not be repairable with ArcGIS tools.

  • After applying a fix, the tool will reevaluate the resulting geometry and if another problem is discovered, the relevant fix will be performed for that problem. For example, the result of fixing a geometry with the Incorrect ring ordering problem may yield a geometry with the Null geometry problem.

  • There is no fix in Repair Geometry for bad dataset extent. To resolve this problem, run the Recalculate Feature Class Extent tool on the dataset.

  • The Esri validation method ensures that geometry is topologically legal using the Esri Simplify method. The Esri validation is only available for data stored in an enterprise geodatabase.

  • The Open Geospatial Consortium (OGC) validation method ensures that geometry complies with the OGC specification as defined in OpenGIS Implementation Standard for Geographic information – simple feature access – Part 1: common architecture.

  • After a feature's geometry is repaired using the OGC option, any subsequent edit or modification may cause the geometry to no longer comply with the OGC specification. After feature modification, run the Check Geometry tool to check for new geometry issues. If necessary, rerun the Repair Geometry tool.

  • OGC simplify does not support nonlinear segments such as Bézier curves, circular arcs, and elliptic arcs. These types of segments must be densified using the Densify tool on the input dataset before running Repair Geometry. To avoid irreversibly changing nonlinear segments when running the Densify tool, make a copy of the data first. Then use Repair Geometry on the copy. To determine if your data has nonlinear segments, use the Add Geometry Attributes tool.

Parameters

LabelExplanationData Type
Input Features

The feature class or layer to be processed.

Feature Layer
Delete Features with Null Geometry
(Optional)

Specifies whether features with null geometries will be deleted.

  • Checked—Features with null geometry will be deleted from the input. This is the default.
  • Unchecked—Features with null geometry will not be deleted from the input.
Boolean
Validation Method
(Optional)

Specifies which geometry validation method will be used to identify geometry problems.

  • EsriThe Esri geometry validation method will be used. This is the default.
  • OGCThe OGC geometry validation method will be used.
String

Derived Output

LabelExplanationData Type
Repaired Input Features

The updated input features.

Feature Layer

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics