Mass Update By Tracing (Production Mapping)

License Level:BasicStandardAdvanced

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

Syntax

MassUpdateByTracing_production (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_CONNECTEDUpdates all target features that are connected to the source features. This is the default.
  • TRACE_UPSTREAMUpdates all target features that are upstream from the source features.
  • TRACE_DOWNSTREAMUpdates 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_BARRIERSBarriers in the geometric network are ignored during the update.
  • USE_BARRIERSBarriers 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

Related Topics

Licensing Information

ArcGIS for Desktop Basic: No
ArcGIS for Desktop Standard: Requires Production Mapping
ArcGIS for Desktop Advanced: Requires Production Mapping
12/18/2014