Enable Network Topology (Trace Network)

Summary

Enables a network topology for a trace network.

A network topology is necessary for analytic operations such as tracing. A network topology can also be enabled to discover error features.

Usage

• All trace network feature classes must have a spatial index.

Syntax

EnableNetworkTopology(in_trace_network, {max_number_of_errors}, {only_generate_errors})

Parameter	Explanation	Data Type
in_trace_network	The trace network for which the network topology will be enabled.	Trace Network; Trace Network Layer
max_number_of_errors (Optional)	The maximum number of errors before the process of enabling the network topology will stop, and errors will be recorded in the errors table. The default value is 10000. Caution: Increasing the maximum number of errors value will increase the length of time to enable the topology. Setting a value higher than the default value of 10000 is not recommended.	Long
only_generate_errors (Optional)	Specifies whether only network errors will be generated. ONLY_ERRORS —The trace network will only generate network errors. The topology will not be enabled. This will allow you to inspect and fix errors in the network before you enable the topology. ENABLE_TOPO — The topology will be enabled and any errors that exist will generate error features. This is the default.	Boolean

Derived Output

Name	Explanation	Data Type
out_trace_network	The updated trace network.	Trace Network

Code sample

EnableNetworkTopology example 1 (Python window)

Enable the network topology for a trace network called MyNetwork and set the maximum number of errors to 500 using the EnableNetworkTopology function.

import arcpy
arcpy.EnableNetworkTopology_tn('MyNetwork', 500)

EnableNetworkTopology example 2 (Python window)

Only generate errors for a trace network called MyNetwork using the EnableNetworkTopology function.

import arcpy
arcpy.EnableNetworkTopology_tn('MyNetwork', '', 'ONLY_ERRORS')

Environments

This tool does not use any geoprocessing environments.

Licensing information

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