Update by Alternate ID Fields (Network Analyst)

License Level:BasicStandardAdvanced

Summary

Updates all the edge references in turn feature classes using an alternate ID field. This tool should be used after making edits to the input line features that are referenced by the turn features to synchronize the turn features based on the alternate ID fields.

Usage

Syntax

UpdateByAlternateIDFields_na (in_network_dataset, alternate_ID_field_name)
ParameterExplanationData Type
in_network_dataset

The network dataset whose turn feature classes are being updated by their alternate ID fields.

Network Dataset Layer
alternate_ID_field_name

The name of the alternate ID field on the edge feature sources of the network dataset. All edge feature sources referenced by turns must have the same name for the alternate ID field.

String

Code Sample

UpdateByAlternateIDFields example 1 (Python window)

Execute the tool using all parameters.

network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.UpdateByAlternateIDFields(network, "ID")
UpdateByAlternateIDFields example 2 (stand-alone Python script)

The following Python script demonstrates how to use the UpdateByAlternateID Fields tool in a stand-alone script.

# Name: UpdateByAlternateIDFields_ex02.py
# Description: Update the edge references in the turn feature classes using
#              alternate IDs and build the network dataset.
# Requirements: Network Analyst Extension 

#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
network = "Transportation/Streets_ND"
alt_ID_field_name = "ID"

#Update the edge references in the turn features using alternate ID fields
arcpy.na.UpdateByAlternateIDFields(network, alt_ID_field_name)

#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.na.BuildNetwork(network)

print("Script completed successfully.")

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Yes
ArcGIS for Desktop Standard: Yes
ArcGIS for Desktop Advanced: Yes
1/20/2015