Add Domain Network (Utility Network)


Adds a domain network to a utility network.

To learn more about adding a domain network, see Add a domain network.


  • The network topology must be disabled.

  • When working with an enterprise geodatabase the following are requirements:


AddDomainNetwork(in_utility_network, domain_network_name, tier_definition, subnetwork_controller_type, {domain_network_alias_name})
ParameterExplanationData Type

The utility network to which the domain network will be added.

Utility Network; Utility Network Layer

The name of the new domain network. The domain network name will prefix the feature class names that are created. For example, a domain named ElectricDistribution would include a feature class named ElectricDistributionJunction.


Specifies the tier definition for the new domain network.

  • HIERARCHICALThe tier will be defined as hierarchical. In hierarchical domain networks, tiers are nested within one another, so features existing in subnetworks for a lower tier naturally participate in all higher tiers. For example, in a gas network, a valve isolation zone exists in a pressure zone, which in turn exists in a system zone. A feature in the isolation zone also exists in the pressure zone and in the system zone.
  • PARTITIONED The tier will be defined as partitioned. Features in partitioned domain networks only exist in one tier. The relationship between tiers is ordered and linear. Features can exist in one or multiple subnetworks in one tier.

Specifies the subnetwork controller type for the new domain network.

  • SOURCEThe subnetwork controller type is a set of sources. A source is an origin of the delivered resource. For example, in an electric system, sources of electricity are power generating stations and substations.
  • SINKThe subnetwork controller type is a set of sinks. A sink is the destination of the gathered resource.

The alias name of the domain network. This optional parameter is used to give a more descriptive name to the domain network.


Derived Output

NameExplanationData Type

The updated utility network.

Utility Network

Code sample

AddDomainNetwork example (Python window)

Add a domain network to the MyUtilityNetwork utility network named ElectricDistribution.

import arcpy
arcpy.AddDomainNetwork_un("MyUtilityNetwork", "ElectricDistribution", 
                          "HIERARCHICAL", "SOURCE", "Electric Distribution")


This tool does not use any geoprocessing environments.

Licensing information

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

Related topics