Validate Network Topology (Utility Network)

Summary

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

Usage

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

  • When working with a multiuser model utility network, the Validate Network Topology geoprocessing tool takes advantage of asynchronous processing.

    Dive-in:
    The asynchronous validation process uses the UtilityNetworkTools geoprocessing service. The UtilityNetworkTools service is preconfigured in the System folder for feature services that include a utility network. It has a longer timeout setting and is reserved for utility network geoprocessing tasks.

  • The network topology must be enabled.

  • When working with an enterprise geodatabase, the input utility network must be a utility network service.

  • When working with an enterprise geodatabase, only a single session can execute the validate operation at a time in the default version.

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.
  • MAXOF—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