Create Trace Network (Trace Network)

Summary

Creates a trace network.

A trace network dataset is created based on the input point and line feature classes that will participate in the trace network.

Usage

• An existing feature dataset must be specified for the Input Feature Dataset parameter.

• The input feature dataset must reside in a file geodatabase.

• The feature classes must reside in the same feature dataset as the trace network.

• At least an input junction or an input edge is required.

• Only point and line feature classes are supported as input. The feature classes cannot participate in another trace network or other advanced geodatabase functionality such as a topology or network dataset.

  Learn more about how to create a trace network

Syntax

CreateTraceNetwork(in_feature_dataset, in_trace_network_name, {input_junctions}, {input_edges})

Parameter	Explanation	Data Type
in_feature_dataset	The feature dataset that will contain the trace network.	Feature Dataset
in_trace_network_name	The name of the trace network that will be created.	String
input_junctions [input_junctions,...] (Optional)	The names of the point feature classes in the feature dataset to include in the trace network.	String
input_edges [[Class Name, Connectivity Policy],...] (Optional)	The line feature classes and associated connectivity policy to include in the trace network. Class Name—The name of the line feature class in the feature dataset to include in the trace network. Connectivity Policy—The associated connectivity policy of the specified feature class. SIMPLE_EDGE—Allows resources to flow from one end of the edge and out the other end. COMPLEX_EDGE—Allows resources to be siphoned off along the length of the edge.	Value Table

Derived Output

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

Code sample

CreateTraceNetwork example (Python window)

Create a new trace network named HydroNetwork.

import arcpy
arcpy.CreateTraceNetwork_tn(r"C:\MyProject\MyNetworkGdb.gdb\Hydro", 
                            "HydroNetwork", 
                            ["AdditionalJunctions", "HydroJunctions", "PourPoints"], 
                            [["BlackLines", "SIMPLE_EDGE"], ["HydroLines", "COMPLEX_EDGE"]])

Environments

This tool does not use any geoprocessing environments.

Licensing information

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