Validate Topology (Data Management)

Summary

Validates a geodatabase topology.

The Validate Topology tool performs the following operations:

  • Cracking and clustering of feature vertices to find features that share geometry (have common coordinates)
  • Inserting common coordinate vertices into features that share geometry
  • Running a set of integrity checks to identify any violations of the rules that have been defined for the topology

Usage

  • This tool will only process dirty areas. For details on dirty areas, see Topology in ArcGIS.

  • If the tool is being used while the topology layer is open in the map, the Visible Extent parameter can be used to limit validation to the extent visible in the map display.

  • Starting at ArcGIS Pro 2.6, the input topology layer can be from a topology service if the service is published with ArcGIS Enterprise 10.8.1 or later. If the layer has been added to the Contents pane, you can drag the layer to the Input Topology parameter, or you can enter the URL of the topology layer feature service, for example, https://myserver.mydomain.com/server/rest/services/myTopoService/FeatureServer/0.

  • When the input topology is from a feature service, this tool performs the validate process asynchronously.

Syntax

arcpy.management.ValidateTopology(in_topology, {visible_extent})
ParameterExplanationData Type
in_topology

The geodatabase topology to be validated.

Topology Layer
visible_extent
(Optional)

Specifies whether the current visible extent of the map or the full extent of the topology will be validated. If the tool is run in the Python window or in a Python script, the entire extent of the topology will be validated regardless of this parameter setting.

  • Full_ExtentThe entire extent of the topology will be validated. This is the default.
  • Visible_ExtentOnly the current visible extent will be validated.
Boolean

Derived Output

NameExplanationData Type
out_topology

The updated topology.

Topology Layer

Code sample

ValidateTopology example (stand-alone script)

The following stand-alone script demonstrates how to use the ValidateTopology function.

# Name: ValidateTopology_Example.py
# Description: Validates a topology

import arcpy
arcpy.ValidateTopology_management("D:/Calgary/Trans.gdb/Streets/Street_Topo")

Environments

Licensing information

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

Related topics