Skip To Content

Validate Network Topology

Summary

Validates the network topology of a utility network after there have been spatial edits to features in the network.

Usage

  • Inconsistencies between feature spatial edits and the network topology are marked with dirty areas.

  • The network topology can be validated using the Validate command on the utility network Data tab or by executing the Validate Network Topology tool. It is recommended that you use the Validate Network Topology tool for long-running validate operations when a large number of edits have taken place, as executing the validate operation from the geoprocessing tool uses asynchronous processing.

    Dive-in:
    The asynchronous validation process used by the Validate Network Topology tool uses the system UtilityNetworkTools geoprocessing service. This service is reserved for utility network geoprocessing tasks and has a longer default timeout setting.

  • The network topology must be enabled.

  • The input utility network must be a utility network service.

Syntax

ValidateNetworkTopology(in_utility_network, {extent})
ParameterExplanationData Type
in_utility_network

The utility network for which the network topology will be validated.

Utility Network; Utility Network Layer
extent
(Optional)

The geographical area for which to validate the network topology. This parameter is similar to the extent geoprocessing environment.

  • Extent object—An Extent object can be used to define the extent.
  • MINOF— The extent where all input features or rasters overlap (intersect one another).It is possible that none of the features overlap and that a null extent (zero width and height) may result. In such cases, no features or cells will be processed.
  • MINOF—The combined extent of all input data. All features or cells will be processed.
  • Xmin, Ymin, XMax, YMax— Space-delimited coordinates that define the extent in the coordinate system where the input data is stored, for example, "-107.0 38.0 -104.0 40.0".
  • pathname— Path to a dataset. The extent of the dataset will be used.
Extent

Derived Output

NameExplanationData Type
out_utility_network

The validated utility network.

Utility Network

Code sample

ValidateNetworkTopology example (Python window)

Validate a network topology for the entire extent of a utility network named GridNetwork.

import arcpy
arcpy.ValidateNetworkTopology_un('GridNetwork', 'Default')

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics