Add Network Category (Utility Network)

Summary

Adds a network category to an existing utility network.

Categories are used to control analysis at the asset group and asset type levels; for example, you can define whether a particular asset group or asset type is a protective device. You can also define a category type to control how trace analysis is executed; for example, you can specify that a network trace ends at a user-defined category type of ProtectiveDevice.

This tool allows you to add a new network category to a utility network that can be later assigned to a feature class at the asset group or asset type level using the Set Network Category tool.

Usage

  • Network categories can later be assigned to a network class for a specific asset group or asset type using the Set Network Category tool.

  • When working with an enterprise geodatabase, the connected ArcGIS Enterprise portal account must be the portal utility network owner.

  • The network topology must be disabled.

  • When working with an enterprise geodatabase, this tool must be connected to the default version when executed.

  • When working with an enterprise geodatabase, the Input Utility Network must be from a database connection established as the database utility network owner.

Parameters

LabelExplanationData Type
Input Utility Network

The input utility network where the network category will be added.

Utility Network; Utility Network Layer
Category Name

The name of the category to be created.

String

Derived Output

LabelExplanationData Type
Updated Utility Network

The updated utility network.

Utility Network

arcpy.un.AddNetworkCategory(in_utility_network, category_name)
NameExplanationData Type
in_utility_network

The input utility network where the network category will be added.

Utility Network; Utility Network Layer
category_name

The name of the category to be created.

String

Derived Output

NameExplanationData Type
out_utility_network

The updated utility network.

Utility Network

Code sample

AddNetworkCategory example (Python window)

Add a category named Protective to the input utility network.

import arcpy
arcpy.AddNetworkCategory_un('Utility Network', 'Protective')

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: Yes
  • Advanced: Yes

Related topics