Update by Geometry (Network Analyst)
Summary
Updates all the edge references in the turn feature class using the geometry of the turn features. This tool is useful when the IDs listed for the turn can no longer find the edges participating in the turn due to edits to the underlying edges.
Usage
-
The tool updates the Edge#FID field values on the turn feature class based on the coincidence between the turn features and the edge features from the network sources.
-
Errors encountered when updating the turn features are reported in an error file written to the directory defined by the TEMP system variable. The full path name to the error file is reported as a warning message.
Syntax
| Parameter | Explanation | Data Type |
in_turn_features |
The turn feature class to be updated. | Feature Layer |
Code Sample
Execute the tool using all parameters
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Network Analyst/Tutorial/SanFrancisco.gdb"
arcpy.UpdateByGeometry_na("Transportation/RestrictedTurns")
The following Python script demonstrates how to use the UpdateByGeometry tool in a stand-alone script.
# Name: UpdateByGeometry_ex02.py
# Description: Update edge references in the turn feature class using the
# geometry of turn features and re-build the network dataset.
# Requirements: Network Analyst Extension
# Author: ESRI
#Import system modules
import arcpy
from arcpy import env
#Check out the Network Analyst extension license
arcpy.CheckOutExtension("Network")
#Set environment settings
env.workspace = "C:/data/SanFrancisco.gdb"
#Set local variables
inTurnFeatures = "RestrictedTurns"
inNetworkDataset = "Transportation/Streets_ND"
#update the edge references in turn features using the geometry
arcpy.UpdateByGeometry_na(inTurnFeatures)
#Since we have modified the edge references for turn sources, we should rebuild
#the network dataset so that the turn features are correctly interpreted by the
#network dataset
arcpy.BuildNetwork_na(inNetworkDataset)
print "Script completed successfully."