Help

Mass Update By Tracing

Summary

Updates feature attributes in a geometric network using a field from Input Source Features. The tool can update any feature class that participates in the geometric network and is connected to Input Source Features. A trace task determines connectivity. Any feature connected to, upstream, or downstream of a feature in Input Source Features is updated.

Usage

  • This tool requires an edit session. The tool automatically starts one if necessary.

  • You can use any edge or junction feature in the geometric network as Input Source Features.

  • Each feature in Input Source Features is a starting point for the trace. Trace Task decides which connected features or network elements to include in the trace.

  • The tool updates each target feature connected to a source feature with the source feature's Input Source Field. If a target feature has connections to multiple source features, the target feature will be updated with the value of the last-traced source feature.

  • The trace performed on the network varies based on the disabled status of each feature class in the network.

  • Set the flow direction on the geometric network before using this tool with the Trace Upstream and Trace Downstream trace tasks.

Syntax

MassUpdateByTracing(in_geometric_network, in_source_features, in_source_field, in_target_features, in_trace_task, {in_additional_source_expression}, {in_use_barriers})
ParameterExplanationData Type
in_geometric_network

The geometric network that contains the features you want to update.

Geometric Network
in_source_features

The features to use for the trace. Each feature is used as a starting point in the trace.

Feature Layer
in_source_field

The field in the source layer that is used to update values in the target layers.

Field
in_target_features
[[Layer, {Edit}, {Disable}, {Field}].,...]

Lists the feature classes to update in the geometric network. You must include three different properties for each feature class to update:

  • Edit—Indicates whether the features in the layer are edited. If False, the features are not modified. If True, the features are updated using the value from the in_source_field parameter.
  • Disable—Indicates whether the features in the layer are included in the trace operation. If False, the layer features are not included in the trace operation. If True, they are included.
  • Field—The field to update with the trace.
Value Table
in_trace_task

The tracing task to use to update the target features.

  • FIND_CONNECTED —Updates all target features that are connected to the source features. This is the default.
  • TRACE_UPSTREAM —Updates all target features that are upstream from the source features.
  • TRACE_DOWNSTREAM —Updates all target features that are downstream from the source features.
String
in_additional_source_expression
(Optional)

A Structured Query Language (SQL) expression that defines which source features to use to update the target features.

SQL Expression
in_use_barriers
(Optional)

Indicates whether barriers in the geometric network are used in the update process.

  • NO_BARRIERS —Barriers in the geometric network are ignored during the update.
  • USE_BARRIERS —Barriers in the geometric network are taken into consideration during the update.
Boolean

Code sample

MassUpdateByTracing example (Python window)

The following Python window script demonstrates how to use the MassUpdateByTracing tool.

# Description: Updates the LASTUPDATE field in wMain using values from wSamplingStation
# 	where the two feature classes are connected in the WaterDist_Net geometric network
# paths to the sample data - you may have to alter these paths
WaterDist_Net = "C:\\data\\WaterUtilities.gdb\\WaterDistribution\\WaterDistribution_Net"
wSamplingStation = "C:\\data\\WaterUtilities.gdb\\WaterDistribution\\wSamplingStation"
wMain = "C:\\data\\WaterUtilities.gdb\\WaterDistribution\\wMain"

# Update using MassUpdateByTracing
arcpy.MassUpdateByTracing_production(WaterDist_Net, wSamplingStation, "LASTUPDATE", "C:\\data\\WaterUtilities.gdb\\WaterDistribution\\wMain true false LASTUPDATE", "FIND_CONNECTED", "", "NO_BARRIERS")

Environments

Licensing information

  • ArcGIS Desktop Basic: No
  • ArcGIS Desktop Standard: Requires Production Mapping
  • ArcGIS Desktop Advanced: Requires Production Mapping

Related topics