Upgrade Network (Network Analyst)

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.

Legacy:

This is a deprecated tool. To learn more about how this tool works, view the archived documentation. This functionality has been replaced by the Upgrade Dataset tool in the Geodatabase Administration toolset. Upgrade Dataset has the ability to 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 to be upgraded. The network dataset must be a geodatabase-based network dataset.

Network Dataset Layer

Derived Output

LabelExplanationData Type
Network Dataset Layer

Network Dataset Layer

arcpy.na.UpgradeNetwork(in_network_dataset)
NameExplanationData 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:
    #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

Licensing information

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

Related topics