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 following are requirements:

    • The geodatabase version must be 10.8.1.2.6 or later.

    • The ArcGIS Enterprise version must be 10.9 or later.
    • The input feature dataset must be from a database connection established as a database-authenticated user and owner of the input feature dataset. This database-authenticated user will become the database trace network owner when the trace network is created.
      • This user must have database privileges to create content and cannot be an OS-authenticated user, a database administrator, or the geodatabase administrator account.
    • 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.
      • The active ArcGIS Enterprise portal account is recorded in the network properties as the portal trace network owner when the trace network is created.

Parameters

LabelExplanationData Type
Input Feature Dataset

The feature dataset that will contain the trace network.

Feature Dataset
Trace Network Name

The name of the trace network that will be created.

String
Input Junctions
(Optional)

The names of the point feature classes in the feature dataset that will be included in the trace network.

String
Input Edges
(Optional)

The line feature classes and associated connectivity policy that will be included in the trace network.

  • Class Name—The name of the line feature class in the feature dataset that will be included 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

LabelExplanationData Type
Output Trace Network

The output trace network.

Trace Network

arcpy.tn.CreateTraceNetwork(in_feature_dataset, in_trace_network_name, {input_junctions}, {input_edges})
NameExplanationData 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 that will be included in the trace network.

String
input_edges
[[Class Name, Connectivity Policy],...]
(Optional)

The line feature classes and associated connectivity policy that will be included in the trace network.

  • Class Name—The name of the line feature class in the feature dataset that will be included 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