ArcMap

Upgrade Network

Available with Network Analyst license.

Summary

Upgrades the schema of the network dataset. Upgrading the network dataset allows the network dataset to make use of the new functionality available in the current software release.

Usage

  • Before the network dataset can be upgraded, the geodatabase must be upgraded to the current release using the Upgrade Geodatabase tool.

Syntax

UpgradeNetwork_na (in_network_dataset)
ParameterExplanationData Type
in_network_dataset

The network dataset to be upgraded. The network dataset must be a geodatabase-based network dataset.

Network Dataset Layer

Derived Output

NameExplanationData Type
out_network_dataset

Network Dataset Layer

Code sample

UpgradeNetwork example 1 (Python window)

Execute the tool using all the parameters.

import arcpy
arcpy.env.workspace = "C:/Data/Socal.gdb"
arcpy.UpgradeNetwork_na("Transportation/Streets_ND")
UpgradeNetwork example 2 (stand-alone script)

The following stand-alone Python script demonstrates how the UpgradeNetwork tool can be used to upgrade the schema of a network dataset. 

# Name: UpgradeNetwork_Workflow.py
# Description: Upgrades the schema of a network dataset by first upgrading the 
#              geodatabase containing the network dataset and then upgrading the
#              network dataset. The network dataset is also built so that it can
#              be used to perform network analyses.
# Requirements: Network Analyst Extension 

#Import system modules
import arcpy
from arcpy import env

try:
    #Check out the Network Analyst extension license
    arcpy.CheckOutExtension("Network")

    #Set environment settings
    env.workspace = "C:/data/RhodeIsland.gdb"
    env.overwriteOutput = True
    
    #Set local variables
    #inNetworkDataset = "Transportation/Streets_ND"
    inNetworkDataset = "RhodeIsland/RhodeIsland_ND"
    
    #Before upgrading the network dataset, upgrade the file GDB that contains
    #the network dataset
    arcpy.UpgradeGDB_management(env.workspace)
    
    #Upgrade the network dataset
    arcpy.UpgradeNetwork_na(inNetworkDataset)
    
    #The upgraded network dataset is not built. So build the network dataset
    arcpy.BuildNetwork_na(inNetworkDataset)
    
    print "Script completed successfully"

except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    print "An error occured on line %i" % tb.tb_lineno
    print str(e)

Environments

Licensing information

  • ArcGIS Desktop Basic: Requires Network Analyst
  • ArcGIS Desktop Standard: Requires Network Analyst
  • ArcGIS Desktop Advanced: Requires Network Analyst

Related topics