Convert Geometric Network To Trace Network (Trace Network)

Summary

Converts a geometric network to a trace network.

Usage

• When working with a file geodatabase, the input geodatabase workspace must be an ArcGIS 10.0 or later release to support this functionality.

• 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 ArcGIS Pro and ArcGIS Enterprise versions determine the trace network version that is created. For more information, see Trace network compatibility.

  • The Input Geometric Network parameter value must be from a database connection established as a database-authenticated user and owner of the input feature dataset and geometric network. This user must have database privileges to create content and cannot be an OS-authenticated user, a database administrator, or the geodatabase administrator account.
    • This database-authenticated user will become the database trace network owner when the geometric network is converted to a trace network.

  • License:

    Organization members must be assigned a license for the ArcGIS Advanced Editing 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 geometric network is converted to a trace network.

  Learn more about how to convert a geometric network

Parameters

Dialog

Label	Explanation	Data Type
Input Geometric Network	The geometric network that will be converted to a trace network. Caution: Converting a geometric network to a trace network will drop the geometric network and create a trace network in its place. This change cannot be undone. Create a backup of the data before proceeding.	Geometric Network
Output Trace Network Name	The name of the output trace network.	String

Derived Output

Label	Explanation	Data Type
Output Trace Network	The output trace network.	Trace Network

Python

arcpy.tn.ConvertGeometricNetworkToTraceNetwork(in_geometric_network, out_trace_network_name)

Name	Explanation	Data Type
in_geometric_network	The geometric network that will be converted to a trace network. Caution: Converting a geometric network to a trace network will drop the geometric network and create a trace network in its place. This change cannot be undone. Create a backup of the data before proceeding.	Geometric Network
out_trace_network_name	The name of the output trace network.	String

Derived Output

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

Code sample

ConvertGeometricNetworkToTraceNetwork example (Python window)

Convert a geometric network named HydroGN to a trace network named HydroTN.

import arcpy
arcpy.tn.ConvertGeometricNetworkToTraceNetwork("C:\\MyTNProject\\NHD.gdb\Hydro\HydroGN",
                                               "HydroTN")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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