{ "name": "Trace", "displayName": "Trace", "description": "Returns selected features in a trace network based on connectivity or traversability from the specified starting points.", "category": "", "helpUrl": "https://gis.waukesha-wi.gov/server/rest/directories/arcgisoutput/Tools/Trace_GPServer/Tools_Trace/Trace.htm", "executionType": "esriExecutionTypeAsynchronous", "parameters": [ { "name": "in_trace_network", "dataType": "GPString", "displayName": "Input Trace Network", "description": "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.", "direction": "esriGPParameterDirectionInput", "defaultValue": "L2TestTraceNetwork_Trace_Network Trace Network", "parameterType": "esriGPParameterTypeRequired", "category": "", "choiceList": [ "L2TestTraceNetwork_Trace_Network Trace Network" ] }, { "name": "trace_type", "dataType": "GPString", "displayName": "Trace Type", "description": "Specifies the type of trace to execute.Connected\u2014A connected trace that begins at one or more starting points and spans outward along connected features will be used.Upstream\u2014An upstream trace that discovers features upstream from a location in the network will be used. This type of trace requires the flow direction to be set.Downstream\u2014A downstream trace that discovers features downstream from a location in the network will be used. This type of trace requires the flow direction to be set.Shortest path\u2014A shortest path trace that finds the shortest path between two starting points in the network regardless of flow direction will be used. The cost of traversing the path is determined based on the network attribute set for the Shortest Path Network Attribute Name parameter.", "direction": "esriGPParameterDirectionInput", "defaultValue": "CONNECTED", "parameterType": "esriGPParameterTypeOptional", "category": "", "choiceList": [ "CONNECTED", "UPSTREAM", "DOWNSTREAM", "SHORTEST_PATH" ] }, { "name": "starting_points", "dataType": "GPString", "displayName": "Starting Points", "description": "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.", "direction": "esriGPParameterDirectionInput", "defaultValue": "Trace\\TN_Temp_Starting_Points", "parameterType": "esriGPParameterTypeOptional", "category": "", "choiceList": [ "TraceResults\\L1cow_pub_test_UNOWNER_SManholeTest", "TraceResults\\L0cow_pub_test_UNOWNER_SGravityMainTest", "TN_Temp_Starting_Points", "cow_pub_test.UNOWNER.SManholeTest", "cow_pub_test.UNOWNER.SGravityMainTest", "L2TestTraceNetwork_Trace_Network Trace Network\\Point Errors", "L2TestTraceNetwork_Trace_Network Trace Network\\Line Errors", "L2TestTraceNetwork_Trace_Network Trace Network\\Dirty Areas", "L2TestTraceNetwork_Trace_Network Trace Network\\System Junctions" ] }, { "name": "barriers", "dataType": "GPFeatureRecordSetLayer", "displayName": "Barriers", "description": "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.", "direction": "esriGPParameterDirectionInput", "defaultValue": { "displayFieldName": "", "hasZ": true, "hasM": true, "geometryType": "esriGeometryPoint", "spatialReference": { "wkid": 103191, "latestWkid": 6609 }, "fields": [ { "name": "OBJECTID", "type": "esriFieldTypeOID", "alias": "OBJECTID" }, { "name": "LAYERID", "type": "esriFieldTypeInteger", "alias": "LAYERID" }, { "name": "GLOBALID", "type": "esriFieldTypeGlobalID", "alias": "GLOBALID", "length": 38 }, { "name": "LAYERNAME", "type": "esriFieldTypeString", "alias": "LAYERNAME", "length": 255 }, { "name": "SOURCEID", "type": "esriFieldTypeInteger", "alias": "SOURCEID" }, { "name": "FEATUREGLOBALID", "type": "esriFieldTypeGUID", "alias": "FEATUREGLOBALID", "length": 38 }, { "name": "FEATUREOID", "type": "esriFieldTypeInteger", "alias": "FEATUREOID" }, { "name": "PERCENTALONG", "type": "esriFieldTypeDouble", "alias": "PERCENTALONG" }, { "name": "DISPLAYNAME", "type": "esriFieldTypeString", "alias": "DISPLAYNAME", "length": 255 } ], "features": [], "exceededTransferLimit": false }, "parameterType": "esriGPParameterTypeOptional", "category": "" }, { "name": "path_direction", "dataType": "GPString", "displayName": "Path Direction", "description": "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.NO_DIRECTION\u2014The path between the two starting points, regardless of the direction of flow, will be used. This is the default.PATH_UPSTREAM\u2014The upstream path between the two starting points will be used.PATH_DOWNSTREAM\u2014The downstream path between the two starting points will be used.", "direction": "esriGPParameterDirectionInput", "defaultValue": "NO_DIRECTION", "parameterType": "esriGPParameterTypeOptional", "category": "", "choiceList": [ "NO_DIRECTION", "PATH_UPSTREAM", "PATH_DOWNSTREAM" ] }, { "name": "shortest_path_network_attribute_name", "dataType": "GPString", "displayName": "Shortest Path Network Attribute Name", "description": "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.", "direction": "esriGPParameterDirectionInput", "defaultValue": "", "parameterType": "esriGPParameterTypeOptional", "category": "" }, { "name": "include_barriers", "dataType": "GPBoolean", "displayName": "Include Barrier Features", "description": "Specifies whether the traversability barrier features will be included in the trace results.Checked\u2014Traversability barrier features will be included in the trace results. This is the default.Unchecked\u2014Traversability barrier features will not be included in the trace results.", "direction": "esriGPParameterDirectionInput", "defaultValue": false, "parameterType": "esriGPParameterTypeOptional", "category": "" }, { "name": "validate_consistency", "dataType": "GPBoolean", "displayName": "Validate Consistency", "description": "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.Checked\u2014The trace will return an error if dirty areas are encountered in any of the traversed features. This is the default.Unchecked\u2014The trace will return results regardless of whether dirty areas are encountered in any of the traversed features.", "direction": "esriGPParameterDirectionInput", "defaultValue": false, "parameterType": "esriGPParameterTypeOptional", "category": "" }, { "name": "ignore_barriers_at_starting_points", "dataType": "GPBoolean", "displayName": "Ignore Barriers At Starting Points", "description": "Specifies whether barriers in the trace configuration will be ignored for starting points.Checked\u2014Barriers at starting points will be ignored in the trace.Unchecked\u2014Barriers at starting points will not be ignored in the trace. This is the default.", "direction": "esriGPParameterDirectionInput", "defaultValue": false, "parameterType": "esriGPParameterTypeOptional", "category": "" }, { "name": "allow_indeterminate_flow", "dataType": "GPBoolean", "displayName": "Allow Indeterminate Flow", "description": "Specifies whether features with indeterminate or uninitialized flow will be traced. This parameter is only honored when running an upstream or downstream trace.Checked\u2014Features with indeterminate or uninitialized flow direction will be traced.Unchecked\u2014Features with indeterminate or uninitialized flow direction will not be traced. This is the default.", "direction": "esriGPParameterDirectionInput", "defaultValue": false, "parameterType": "esriGPParameterTypeOptional", "category": "" }, { "name": "traversability_scope", "dataType": "GPString", "displayName": "Apply Traversability To", "description": "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.Both junctions and edges\u2014Traversability will be applied to both junctions and edges. This is the default.Junctions only\u2014Traversability will be applied to junctions only.Edges only\u2014Traversability will be applied to edges only.", "direction": "esriGPParameterDirectionInput", "defaultValue": "BOTH_JUNCTIONS_AND_EDGES", "parameterType": "esriGPParameterTypeOptional", "category": "Advanced Options", "choiceList": [ "BOTH_JUNCTIONS_AND_EDGES", "JUNCTIONS_ONLY", "EDGES_ONLY" ] }, { "name": "result_types", "dataType": "GPMultiValue:GPString", "displayName": "Result Types", "description": "Specifies the type of results that will be returned by the trace.Selection\u2014 The trace results will be returned as a selection set on the appropriate network features. This is the default.Aggregated Geometry\u2014 The trace results will be aggregated by geometry type and stored in feature classes displayed in layers in the active map.Network Layers\u2014The trace results will be added to feature layers as a selection set in a group layer.Connectivity\u2014The trace results will be returned as a connectivity graph in a specified output .json file. This option enables the Output JSON parameter.Elements\u2014The trace results will be returned as feature-based information in a specified output .json file. This option enables the Output JSON parameter.", "direction": "esriGPParameterDirectionInput", "defaultValue": [ "NETWORK_LAYERS" ], "parameterType": "esriGPParameterTypeOptional", "category": "Advanced Options", "choiceList": [ "SELECTION", "AGGREGATED_GEOMETRY", "NETWORK_LAYERS", "ELEMENTS" ] }, { "name": "selection_type", "dataType": "GPString", "displayName": "Selection Type", "description": "Specifies how the selection will be applied and what to do if a current selection exists.New selection\u2014The resulting selection will replace the current selection. This is the default.Add to the current selection\u2014The resulting selection will be added to the current selection if one exists. If no selection exists, this is the same as the new selection option.Remove from the current selection\u2014The resulting selection will be removed from the current selection. If no selection exists, this option has no effect.Select subset from the current selection\u2014The resulting selection will be combined with the current selection. Only records that are common to both remain selected.Switch the current selection\u2014The resulting selection will be switched. Results that were selected are removed from the current selection, while results that were not selected are added to the current selection. If no selection exists, this is the same as the new selection option.", "direction": "esriGPParameterDirectionInput", "defaultValue": "NEW_SELECTION", "parameterType": "esriGPParameterTypeOptional", "category": "Advanced Options", "choiceList": [ "NEW_SELECTION", "ADD_TO_SELECTION", "REMOVE_FROM_SELECTION", "SUBSET_SELECTION", "SWITCH_SELECTION" ] }, { "name": "clear_all_previous_trace_results", "dataType": "GPBoolean", "displayName": "Clear All Previous Trace Results", "description": "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.Checked\u2014The feature classes storing aggregated trace geometry will be truncated. Only the output geometry from the current trace operation will be written. This is the default.Unchecked\u2014The output geometry from the current trace operation will be appended to the feature classes storing aggregated geometry.", "direction": "esriGPParameterDirectionInput", "defaultValue": true, "parameterType": "esriGPParameterTypeOptional", "category": "Advanced Options" }, { "name": "trace_name", "dataType": "GPString", "displayName": "Trace Name", "description": "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.", "direction": "esriGPParameterDirectionInput", "defaultValue": "", "parameterType": "esriGPParameterTypeOptional", "category": "Advanced Options" }, { "name": "aggregated_points", "dataType": "GPFeatureRecordSetLayer", "displayName": "Aggregated Points", "description": "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.", "direction": "esriGPParameterDirectionOutput", "defaultValue": { "displayFieldName": "", "hasZ": true, "geometryType": "esriGeometryMultipoint", "spatialReference": { "wkid": 103191, "latestWkid": 6609 }, "fields": [ { "name": "OID", "type": "esriFieldTypeOID", "alias": "OID" }, { "name": "TRACENAME", "type": "esriFieldTypeString", "alias": "TRACENAME", "length": 255 } ], "features": [], "exceededTransferLimit": false }, "parameterType": "esriGPParameterTypeOptional", "category": "Advanced Options" }, { "name": "aggregated_lines", "dataType": "GPFeatureRecordSetLayer", "displayName": "Aggregated Lines", "description": "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.", "direction": "esriGPParameterDirectionOutput", "defaultValue": { "displayFieldName": "", "hasZ": true, "geometryType": "esriGeometryPolyline", "spatialReference": { "wkid": 103191, "latestWkid": 6609 }, "fields": [ { "name": "OID", "type": "esriFieldTypeOID", "alias": "OID" }, { "name": "TRACENAME", "type": "esriFieldTypeString", "alias": "TRACENAME", "length": 255 }, { "name": "Shape_Length", "type": "esriFieldTypeDouble", "alias": "Shape_Length" } ], "features": [], "exceededTransferLimit": false }, "parameterType": "esriGPParameterTypeOptional", "category": "Advanced Options" }, { "name": "updated_trace_network", "dataType": "GPString", "displayName": "Updated Trace Network", "description": "", "direction": "esriGPParameterDirectionOutput", "defaultValue": "", "parameterType": "esriGPParameterTypeDerived", "category": "" }, { "name": "out_network_layer", "dataType": "GPString", "displayName": "Output Group Layer Name", "description": "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.", "direction": "esriGPParameterDirectionOutput", "defaultValue": "", "parameterType": "esriGPParameterTypeOptional", "category": "Advanced Options" }, { "name": "use_trace_config", "dataType": "GPBoolean", "displayName": "Use Trace Configuration", "description": "Specifies whether an existing named trace configuration will be used to populate the parameters of the Trace tool.Checked\u2014An existing named trace configuration will be used to define the properties of the trace. All parameters except Trace Configuration Name, Starting Points, and Barriers will be ignored.Unchecked\u2014An existing named trace configuration will not be used to define the properties of the trace. This is the default.This parameter requires Trace Network Version 2 or later.", "direction": "esriGPParameterDirectionInput", "defaultValue": false, "parameterType": "esriGPParameterTypeOptional", "category": "" }, { "name": "trace_config_name", "dataType": "GPString", "displayName": "Trace Configuration Name", "description": "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.This parameter requires Trace Network Version 2 or later.", "direction": "esriGPParameterDirectionInput", "defaultValue": "", "parameterType": "esriGPParameterTypeOptional", "category": "" }, { "name": "out_json_file", "dataType": "GPDataFile", "displayName": "Output JSON", "description": "The name and location of the .json file that will be generated.", "direction": "esriGPParameterDirectionOutput", "defaultValue": null, "parameterType": "esriGPParameterTypeOptional", "category": "Advanced Options" }, { "name": "esri_out_feature_service_name", "dataType": "GPString", "displayName": "Output Feature Service Name", "description": "The name of the optional feature service to create on the federated server containing the result of this tool. If no name is specified an output feature service will not be created.", "direction": "esriGPParameterDirectionInput", "defaultValue": "", "parameterType": "esriGPParameterTypeOptional", "category": "" } ] }