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.
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})
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.
| Value Table |
Derived Output
Name | Explanation | Data Type |
out_trace_network | The output trace network. | Trace Network |
Code sample
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
Licensing information
- Basic: No
- Standard: Yes
- Advanced: Yes