Create Utility Network (Utility Network)

Summary

Creates a utility network in an enterprise or file geodatabase feature dataset.

A utility network is created and a structure network, with its collection of feature classes, is added to the target feature dataset. The structure feature classes will be shared across all domain networks as they are created and configured for the utility network.

For details about system requirements and supported databases, see Create a utility network.

Usage

  • The Input Feature Dataset and Service Territory Feature Class parameters must have the same spatial reference.

  • The Service Territory Feature Class parameter value must exist in the input feature dataset and must be z- and m-enabled.

  • The DEFAULTS configuration keyword will be used for the output utility network.

  • When working with an enterprise geodatabase the following requirements must be met:

    • The geodatabase version must be 10.8.1.2.6 or later.

    • The utility network cannot be owned by an operating system-authenticated user, database, or geodatabase administrator account.
    • An active ArcGIS Enterprise portal must be added to the project with a portal account signed in that has privileges to publish content; this includes privileges to publish server-based layers as well as create, update, and delete content. The default Publisher role includes these privileges. The active ArcGIS Enterprise portal account will be recorded in the network properties as the portal utility network owner.

    License:
    The active portal account must be licensed with the ArcGIS Utility Network user type extension to create, publish, and work with a utility network in an enterprise geodatabase.

Parameters

LabelExplanationData Type
Input Feature Dataset

The geodatabase feature dataset in which the utility network and schema will be created.

Feature Dataset
Utility Network Name

The name of the utility network that will be created.

String
Service Territory Feature Class

The existing polygon feature class that will be used to create the utility network's geographical extent. Utility network features cannot be created outside of this extent.

The feature class must be z- and m-enabled.

Feature Layer; Feature Class

Derived Output

LabelExplanationData Type
Output Utility Network

The output utility network.

Utility Network

arcpy.un.CreateUtilityNetwork(in_feature_dataset, in_utility_network_name, service_territory_feature_class)
NameExplanationData Type
in_feature_dataset

The geodatabase feature dataset in which the utility network and schema will be created.

Feature Dataset
in_utility_network_name

The name of the utility network that will be created.

String
service_territory_feature_class

The existing polygon feature class that will be used to create the utility network's geographical extent. Utility network features cannot be created outside of this extent.

The feature class must be z- and m-enabled.

Feature Layer; Feature Class

Derived Output

NameExplanationData Type
out_utility_network

The output utility network.

Utility Network

Code sample

CreateUtilityNetwork example (Python window)

Create a utility network called MyNetwork in a feature dataset called EsriCoOp and a service territory layer called ServiceArea.

import arcpy
arcpy.CreateUtilityNetwork_un(r"C:\MyProject\unownerconnection.sde\UNdatabase.UNOWNER.EsriCoOp", 
                              "MyNetwork", "ServiceArea")

Environments

Licensing information

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

Related topics