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 are specified to participate in the trace network.

Usage

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

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

  • At a minimum, 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

  • When working with an enterprise geodatabase, the requirements are as follows:

    • You must be connected as the data owner of the input feature dataset to run this tool.
    • The trace network cannot be owned by an operating system-authenticated user, database administrator, or geodatabase administrator accounts.
    • License:
      The active portal account must be licensed with the ArcGIS Trace Network user type extension to create, publish, and work with a trace network in an enterprise geodatabase.

Syntax

arcpy.tn.CreateTraceNetwork(in_feature_dataset, in_trace_network_name, {input_junctions}, {input_edges})
ParameterExplanationData 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—Resources will flow from one end of the edge and out the other end.
    • COMPLEX_EDGE—Resources will be siphoned off along the length of the edge.

Value Table

Derived Output

NameExplanationData Type
out_trace_network

The output trace network.

Trace Network

Code sample

CreateTraceNetwork example (Python window)

Create a 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

Related topics