Skip To Content

Add Tier

Summary

Creates a new tier for a specific domain network in a utility network.

Tiers are collections of subnetworks that share the same level, name restrictions, and topology type. Tiers are required for subnetwork management. Tier groups can be created using the Add Tier Group tool.

Usage

  • For hierarchical tier types, this tool can be used to add a new tier to a tier group.

  • Tiers should be added before appending data in the utility network feature classes. If data is appended prior to adding a new tier, an error will occur.

  • The connected ArcGIS Enterprise portal account must be the portal utility network owner.

  • The network topology must be disabled.

  • This tool should be executed when connected to the default version.

  • The input utility network must be from a database connection established as the database utility network owner.

Syntax

AddTier(in_utility_network, domain_network, name, rank, {topology_type}, {tier_group_name}, {subnetwork_field_name})
ParameterExplanationData Type
in_utility_network

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

Utility Network; Utility Network Layer
domain_network

The domain network where the tier will be created.

String
name

The name of the new tier. The name must be unique in the entire utility network.

String
rank

The rank of the tier being added. The highest rank is the number 1.

Long
topology_type
(Optional)

The topology type for the new tier: RADIAL or MESH. Radial means the subnetworks in the tier are provided by one source. Mesh means the subnetworks in the tier are provided by multiple sources. If the input domain network was created with a hierarchical tier definition, the default topology type is MESH. If the input domain network was created with a partitioned tier definition, the topology type parameter is required.

  • RADIALThe subnetworks are fed by one source, a nonlooped path with only one subnetwork controller.
  • MESHThe subnetworks are fed by multiple sources, a closed path (loop) with one or more subnetwork controllers. This is the default topology type for a tier created with a hierarchical tier definition.
String
tier_group_name
(Optional)

The existing tier group to which the new tier will be added. This parameter is required for hierarchical tier types.

String
subnetwork_field_name
(Optional)

The name of the field where the subnetwork names for this tier will be stored. This is a system maintained field that will be created the first time a tier is added to a tier group and re-used for any additional tiers. For example, you have two tier groups: Distribution and Transmission. When you add a tier named system to the Distribution group and specify the subnetwork field name to be systemsubnet, the field is created. Next, you add a second tier named system to the Transmission group. This parameter will detect that the systemsubnet field should be used as the subnetwork field name. This parameter is required for hierarchical tier types.

String

Derived Output

NameExplanationData Type
out_utility_network

The updated utility network.

Utility Network

Code sample

AddTier example 1 (Python window)

Create a tier in a hierarchical network named DistributionSystem with a MESH topology type.

import arcpy
arcpy.AddTier_un("Utility Network", "GasDistribution", "Distribution System", 
                 1, "MESH", "Distribution", "System")
AddTier example 2 (Python window)

Create a tier in a partitioned network named MediumVoltage with a RADIAL topology type.

import arcpy
arcpy.AddTier_un("Utility Network", "ElectricDistribution", "Medium Voltage", 
                 1, "RADIAL")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics