Title  Build Starting Points


Creates starting points based on a trace configuration.


The Utility Network must be at least Schema Version 5.




BuildStartingPoints (in_utility_network, trace_config, starting_class, group_by_field, {expression}, {results_trace_config}, {trace_result_type}, {trace_results_output}, {trace_results_input}, {filter_classes}, {skip_found}, {compare_output_name}, {remove_dup_groups})

Parameter Explanation Data Type
in_utility_network Dialog Reference

The utility network that will be used to trace.

trace_config Dialog Reference

The utility network trace configuration used to define the trace parameters.

starting_class Dialog Reference

The utility network starting points layer. A UN controlled layer can also be used, the center point of the line/polygon will be used as the starting point. For devices, a default terminal of 1 is used.

group_by_field Dialog Reference

A field with a value to group the result locations for the batch trace. Select ObjectID or Global ID to make each set of results unique.

expression (Optional) Dialog Reference

The simple calculation expression used to limit the starting points used in a trace.

results_trace_config (Optional) Dialog Reference

The trace configuration to use in the result. If not provided, the trace configuration used to find the results will be used.

trace_result_type (Optional) Dialog Reference

Determine how the results are stored.

trace_results_output (Optional) Dialog Reference

The results from the trace in the starting points featureclass format.

trace_results_input (Optional) Dialog Reference

The results from the trace in the Utility Network Starting Points featureclass format. If the row with the Global ID/Terminal ID exists, the ISDIRTY field will be updated. If the row does not exist, it will be inserted.

filter_classes (Optional) Dialog Reference

Only store features in these classes. This is useful when tracing a line layer to build starting points. The tool loops over all input features and creates a starting point to trace. If the trace results the features used to trace, they can be skipped to increase performance. This filter allows you to return them and not store them in the result.

skip_found (Optional) Dialog Reference

If a feature's global id was returned in a trace, do not trace that feature.

compare_output_name (Optional) Dialog Reference

On an update, compare the group by names. When running a batch process, it is best to pick this, but may insert more records instead of updating.

remove_dup_groups (Optional) Dialog Reference

Option to remove duplicate sets of results if they were discovered in a previous trace.


Code Samples