Mass Update By Tracing (Production Mapping)

汇总

This tool updates feature attributes in a geometric network. 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.

用法

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

• The Input Target Features parameter contains feature classes that participate in the geometric network.

• 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.

• Learn more about tracing utility networks

语法

MassUpdateByTracing_production (in_geometric_network, in_source_features, in_source_field, in_target_features, in_trace_task, {in_additional_source_expression}, {in_use_barriers})

参数	说明	数据类型
in_geometric_network	The geometric network that contains the features you want to update.	Geometric Network
in_source_features	The feature layer that contains the features on which the trace is based.	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 (可选)	A Structured Query Language (SQL) expression that defines which source features to use to update the target features.	SQL Expression
in_use_barriers (可选)	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

代码示例

MassUpdateByTracing example (Python window)

This ArcGIS Python window script example executes the MassUpdateByTracing function on Production Mapping sample data.

# ---------------------------------------------------------------------------
# Name: MassUpdateByTracing.py
# Description: Updates the LASTUPDATE field in wMain using values from wSamplingStation
# 	where the two feature classes are connected in the WaterDist_Net geometric network
# Author: ESRI
# ---------------------------------------------------------------------------

# Import arcpy module
import arcpy

# 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"

# import the Production Mapping toolbox - you may have to change this path
arcpy.ImportToolbox(r'C:\Program Files\ArcGIS\Desktop10.0\ArcToolbox\Toolboxes\Production Mapping Tools.tbx')

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

环境

此工具不使用任何地理处理环境

许可信息

ArcView: 需要 Production Mapping

ArcEditor: 需要 Production Mapping

ArcInfo: 需要 Production Mapping