Add Tier Group (Utility Network)

Summary

Adds a tier group to a domain network in a utility network.

This tool is used to add a new tier group to an existing domain network in a utility network. When a tier group exists, the Add Tier tool can be used to add tiers to the tier group.

Usage

  • Tier groups can only be added to domain networks that have a hierarchical tier definition.

  • 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, the Input Utility Network parameter value must be from a database connection established as the database utility network owner.

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

Parameters

LabelExplanationData Type
Input Utility Network

The utility network that contains the domain network where the tier group will be added.

Utility Network; Utility Network Layer
Domain Network

The name of the domain network to which the tier group will be added. Tier groups can only be added to domain networks that have a hierarchical tier definition.

String
Tier Group Name

A unique name for the new tier group. The name can be a maximum of 64 characters in length.

String

Derived Output

LabelExplanationData Type
Updated Utility Network

The updated utility network.

Utility Network

arcpy.un.AddTierGroup(in_utility_network, domain_network, name)
NameExplanationData Type
in_utility_network

The utility network that contains the domain network where the tier group will be added.

Utility Network; Utility Network Layer
domain_network

The name of the domain network to which the tier group will be added. Tier groups can only be added to domain networks that have a hierarchical tier definition.

String
name

A unique name for the new tier group. The name can be a maximum of 64 characters in length.

String

Derived Output

NameExplanationData Type
out_utility_network

The updated utility network.

Utility Network

Code sample

AddTierGroup example (Python window)

Add a new tier group named Distribution to the hierarchical domain network named GasDistribution.

import arcpy
arcpy.AddTierGroup_un("Utility Network", "GasDistribution", "Distribution")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics