Upgrade Network (Network Analyst)

Available with Network Analyst license.

Summary

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

Legacy:

This is a deprecated tool. This functionality has been replaced by the Upgrade Dataset tool. Upgrade Dataset can upgrade network datasets as well as other types of datasets, such as parcel fabrics, to the current ArcGIS release.

Usage

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

Parameters

LabelExplanationData Type
Input Network Dataset

The network dataset that will be upgraded. The network dataset must be a geodatabase-based network dataset.

Network Dataset Layer

Derived Output

LabelExplanationData Type
Network Dataset Layer

The upgraded network work dataset.

Network Dataset Layer

arcpy.management.UpgradeNetwork(in_network_dataset)
NameExplanationData Type
in_network_dataset

The network dataset that will be upgraded. The network dataset must be a geodatabase-based network dataset.

Network Dataset Layer

Derived Output

NameExplanationData Type
out_network_dataset

The upgraded network work dataset.

Network Dataset Layer

Code sample

UpgradeNetwork example 1 (Python window)

The following Python window script demonstrates how to use the UpgradeNetwork function in immediate mode

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 function 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:
    #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 occurred on line %i" % tb.tb_lineno)
    print(str(e))

Environments