Label | Explanation | Data Type |
Input Trace Network
| The trace network on which the trace will be run. When working with an enterprise geodatabase, an input trace network must be from a feature service; a trace network from a database connection is not supported. | Trace Network; Trace Network Layer |
Trace Type
| Specifies the type of trace to execute.
| String |
Starting Points
| A feature layer created using the Starting Points tab in the Trace Locations pane, or a table or feature class containing one or more records that represent the starting points of the trace. The TN_Temp_Starting_Points feature class is used by default and is generated in the default geodatabase of the project when you create starting points using the Starting Points tool in the Trace Locations pane. | Feature Layer; Table View |
Barriers
(Optional) | A table or feature class containing one or more features that represent the barriers of the trace that prevent the trace from traversing beyond that point. The TN_Temp_Barriers feature class is used by default and is generated in the default geodatabase of the project when you create barriers using the Barriers tab in the Trace Locations pane. | Feature Layer; Table View |
Path Direction
(Optional) | Specifies the direction of the trace path. The cost of traversing the path is determined by the Shortest Path Network Attribute Name parameter value. This parameter is only honored when running a Shortest path trace type.
| String |
Shortest Path Network Attribute Name
(Optional) | The name of the network attribute used to calculate the path. When running a shortest path trace type, the shortest path is calculated using a numeric network attribute such as shape length. Cost and distance based paths can both be achieved. This parameter is required when running a shortest path trace. | String |
Include Barrier Features
(Optional) |
Specifies whether the traversability barrier features will be included in the trace results.
| Boolean |
Validate Consistency
(Optional) | Specifies whether an error will be returned if dirty areas are encountered in any of the traversed features. This is the only way to guarantee a trace is passing through features with consistent status in the network. To remove dirty areas, validate the network topology.
| Boolean |
Ignore Barriers At Starting Points (Optional) | Specifies whether barriers in the trace configuration will be ignored for starting points.
| Boolean |
Allow Indeterminate Flow
(Optional) | Specifies whether features with indeterminate or uninitialized flow will be traced. This parameter is only honored when running an upstream or downstream trace.
| Boolean |
Condition Barriers
(Optional) | Sets a traversability barrier condition on features based on a comparison to a network attribute. A condition barrier uses a network attribute, an operator and a type, and an attribute value. For example, stop a trace when a feature has the Code attribute equal to the specific value of ArtificialPath. When a feature meets this condition, the trace stops. If you're using more than one attribute, you can use the Combine Using parameter to define an And or an Or condition. Condition barrier components are as follows:
Operator components are as follows:
Type components are as follows:
Combine using components are as follows:
| Value Table |
Function Barriers
(Optional) | Sets a traversability barrier on features based on a function. Function barriers can be used, for example, to restrict how far the trace travels from the starting point or to set a maximum value to stop a trace. For example, the length of each line traveled is added to the total distance traveled so far. When the total length traveled reaches the value specified, the trace stops. Function barrier components are as follows:
Function components are as follows:
For example, you have a starting point feature with a value of 20. The next feature has a value of 30. If you use the minimum function, the result is 20, maximum is 30, add is 50, average is 25, count is 2, and subtract is -10. Operator components are as follows:
Use Local Values components are as follows:
| Value Table |
Apply Traversability To
(Optional) | Specifies the type of traversability that will be applied. Traversability scope determines whether traversability is applied to junctions, edges, or both. For example, in a network of recreational trails, if a condition barrier is defined to stop a trace if a surfacetype attribute contains a value of gravel and the traversability scope is set to junctions only, the trace will not stop even if it encounters an edge feature with this value in the surfacetype field, because the surfacetype attribute is only applicable to edges.
| String |
Functions
(Optional) | The calculation function or functions that will be applied to the trace results. Functions components are as follows:
Function component options are as follows:
For example, you have a starting point feature with a value of 20. The next feature has a value of 30. If you're using the Min function, the result is 20. Max is 30, Add is 50, Average is 25, Count is 2, and Subtract is -10. Filter Operator component options are as follows:
Filter Type component options are as follows:
| Value Table |
Output Conditions
(Optional) | The types of features that will be returned based on a network attribute. For example, in a trace configured to filter out everything but Tap features, any traced features that do not have the Tap attribute assigned to them are not included in the results. Any traced features that do are returned in the result selection set. Output conditions components are as follows:
Operator component options are as follows:
Type component options are as follows:
| Value Table |
Result Types
(Optional) | Specifies the type of results that will be returned by the trace.
| String |
Selection Type
| Specifies how the selection will be applied and what to do if a current selection exists.
| String |
Clear All Previous Trace Results
(Optional) | Specifies whether content will be truncated from or appended to the feature classes chosen to store aggregated geometry. This parameter is only applicable to the aggregated geometry result type.
| Boolean |
Trace Name
(Optional) | The name of the trace operation. This value is stored in the TRACENAME field of the output feature class to assist with identification of the trace results. This parameter is only applicable to the aggregated geometry result type. | String |
Aggregated Points
(Optional) | An output multipoint feature class containing the aggregated result geometry. By default, the parameter is populated with a system-generated feature class named Trace_Results_Aggregated_Points that will be stored in the project's default geodatabase. This feature class will be created automatically if it does not exist. An existing feature class can also be used to store aggregated geometry. If a feature class other than the default is used, it must be a multipoint feature class and contain a string field named TRACENAME. This parameter is only applicable to the aggregated geometry result type. | Feature Class |
Aggregated Lines (Optional) | An output polyline feature class containing the aggregated result geometry. By default, the parameter is populated with a system-generated feature class named Trace_Results_Aggregated_Lines that will be stored in the project's default geodatabase. This feature class will be created automatically if it does not exist. An existing feature class can also be used to store aggregated geometry. If a feature class other than the default is used, it must be a polyline feature class and contain a string field named TRACENAME. This parameter is only applicable to the aggregated geometry result type. | Feature Class |
Output Group Layer Name (Optional) | The name of the output group layer that contains feature layers with selection sets of features returned by the trace. The layer provides access to work with the output of a trace in ModelBuilder and Python. This parameter is only applicable to the network layers result type. | Group Layer |
Use Trace Configuration
(Optional) | Specifies whether an existing named trace configuration will be used to populate the parameters of the Trace tool.
Note:This parameter requires Trace Network Version 2 or later. | Boolean |
Trace Configuration Name
(Optional) | The name of the trace configuration that will be used to define the properties of the trace. This parameter is only active when the Use Trace Configuration parameter is checked. Note:This parameter requires Trace Network Version 2 or later. | String |
Output JSON (Optional) | The name and location of the .json file that will be generated. | File |
Derived Output
Label | Explanation | Data Type |
Updated Trace Network | The updated trace network. | Any Value |