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.
Syntax
arcpy.un.AddNetworkCategory(in_utility_network, category_name)
| Parameter | Explanation | Data 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
| Name | Explanation | Data Type |
| out_utility_network | The updated utility network. | Utility Network |
Code sample
Add a category named Protective to the input utility network.
import arcpy
arcpy.AddNetworkCategory_un('Utility Network', 'Protective')Environments
Licensing information
- Basic: No
- Standard: Yes
- Advanced: Yes