Summary
Enables a network topology for a trace network.
A network topology is necessary for analytic operations such as tracing and to use network diagrams. A network topology can also be enabled to discover error features.
Usage
All trace network feature classes must have a spatial index.
When working with an enterprise geodatabase, the requirements are as follows:
The input trace network must be from a database connection established as the database trace network owner.
This tool must be executed when connected to the default version.
The trace network must be registered as branch versioned.
The trace network must be in a nonversioned state to use the Only generate errors advanced option.
Syntax
arcpy.tn.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 that can occur before the process of enabling the network topology will stop. 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 it takes to enable the topology. Setting a value higher than the default value of 10000 is not recommended. | Long |
only_generate_errors (Optional) | Specifies whether the topology will be enabled or only network errors will be generated.
| Boolean |
Derived Output
Name | Explanation | Data Type |
out_trace_network | The updated trace network. | Trace Network |
Code sample
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)
Only generate errors for a trace network called MyNetwork using the EnableNetworkTopology function.
import arcpy
arcpy.EnableNetworkTopology_tn('MyNetwork', '', 'ONLY_ERRORS')
Environments
Licensing information
- Basic: No
- Standard: Yes
- Advanced: Yes